flows

var FlowGet = ops.Spec[ProfileIn]{
	Name: "flow.get", Owner: ops.OwnerDesktop, Effect: ops.EffectRead, Toolset: Toolset,
	Summary: "Read a profile's flow",
	Guidance: "Return one profile's graph: every node with its id, type and config, and the wires between them. " +
		"This is where node ids come from — flow_preview's nodeId and the node-image tools take them. " +
		"A profile whose flow file does not parse still answers, with valid=false and the load error.",
	Args: []string{"profileId"},
}

var FlowPreview = ops.Spec[FlowPreviewIn]{
	Name: "flow.preview", Owner: ops.OwnerDesktop, Effect: ops.EffectRead, Toolset: Toolset,
	Summary: "Dry-run a flow",
	Guidance: "Dry-run a flow against input you supply and report what every node did, committing nothing — no feed membership, " +
		"inbox rows, notifications, queued actions or durable kv. Name the flow with exactly one of profileId (an installed profile's flow, enabled or not), " +
		"flow (a flow document as a JSON object, same schema as flows/<id>.yaml, version included) or flowYaml (that document as YAML text), " +
		"so an unsaved edit can be executed before it is deployed. Messages are delivered to nodeId — any node, not only a source, which is how " +
		"one function node is exercised in isolation against a captured payload; flow_get is where node ids come from. " +
		"Sources never fetch: a source node relays what you inject. " +
		"Envelope fields left empty are filled in. kv seeds an in-memory sandbox (nodeId -> key -> value) that is the whole world a kv.get sees, " +
		"so notify-once logic is testable against a known starting state; what the run would have written comes back in kvMutations. " +
		"Each node reports its drops, timing, console output, and a structured error with line and column for a script failure, whose line " +
		"numbers are relative to the on_message body you wrote. detail controls how many copies of each message body come back: \"emitted\" " +
		"(the default) reports what each node put on its output ports, \"summary\" drops message bodies entirely — use it for a snapshot run, " +
		"whose payloads would otherwise be repeated once per node per item — and \"full\" adds each node's received messages. " +
		"Prefer this over deploying an edit and waiting for a poll.",
	Fields: ops.Constraints{"detail": {Enum: []string{ops.DetailSummary, DetailEmitted, ops.DetailFull}, Default: DetailEmitted}},
}

var NodeImageDelete = ops.Spec[NodeImageIn]{
	Name: "node_image.delete", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary:  "Clear a source node's feed mark",
	Guidance: "Clear a source node's feed-mark image so its items revert to the node's icon.",
	Args:     []string{"profileId", "nodeId"},
}

var NodeImageGet = ops.Spec[NodeImageIn]{
	Name: "node_image.get", Owner: ops.OwnerDesktop, Effect: ops.EffectRead, Toolset: Toolset,
	Summary:  "Read a source node's feed mark",
	Guidance: "Return a source node's feed-mark image as a PNG. A node with no mark is not_found — its items fall back to the node's glyph.",
	Args:     []string{"profileId", "nodeId"},
}

var NodeImagePut = ops.Spec[NodeImagePutIn]{
	Name: "node_image.put", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary: "Set a source node's feed mark",
	Guidance: "Set a source node's feed-mark image from base64-encoded image bytes (PNG, JPEG, GIF or WebP). " +
		"It is normalized to a 128x128 PNG and shown on that source's items instead of its icon. " +
		"Webhook and command sources carry a mark; other node types are rejected.",
	Args: []string{"profileId", "nodeId"},
}

var ProfileCreate = ops.Spec[ProfileCreateIn]{
	Name: "profile.create", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary:  "Create a profile",
	Guidance: "Create a profile, seeded with the starter graph when exactly one GitHub account is connected and empty otherwise.",
	Args:     []string{"name"},
}

var ProfileDelete = ops.Spec[ProfileIn]{
	Name: "profile.delete", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary: "Delete a profile",
	Guidance: "Delete a profile, its flow files, its avatar, and its inbox state. This is not reversible. " +
		"An id that matches no profile is not_found — nothing is ever reported as deleted that was not.",
	Args: []string{"profileId"},
}

var ProfileImageDelete = ops.Spec[ProfileIn]{
	Name: "profile_image.delete", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary:  "Clear a profile's avatar",
	Guidance: "Clear a profile's avatar so its rail reverts to the letter chip.",
	Args:     []string{"profileId"},
}

var ProfileImageGet = ops.Spec[ProfileIn]{
	Name: "profile_image.get", Owner: ops.OwnerDesktop, Effect: ops.EffectRead, Toolset: Toolset,
	Summary:  "Read a profile's avatar",
	Guidance: "Return a profile's avatar as a PNG image. A profile with no avatar is not_found — its rail falls back to a letter chip.",
	Args:     []string{"profileId"},
}

var ProfileImagePut = ops.Spec[ProfileImagePutIn]{
	Name: "profile_image.put", Owner: ops.OwnerDesktop, Effect: ops.EffectWrite, Toolset: Toolset,
	Summary: "Set a profile's avatar",
	Guidance: "Set a profile's avatar from base64-encoded image bytes (PNG, JPEG, GIF or WebP — the format is sniffed, so no media type is needed). " +
		"The image is normalized to a 128x128 PNG.",
	Args: []string{"profileId"},
}

var ProfileList = ops.Spec[ops.NoInput]{
	Name: "profile.list", Owner: ops.OwnerDesktop, Effect: ops.EffectRead, Toolset: Toolset,
	Summary: "List profiles",
	Guidance: "List every profile with its load status and whether it has an avatar. " +
		"Profile ids from here are what every other tool's profileId argument takes; flow_get turns one into its graph and node ids. " +
		"A profile whose flow file does not parse still lists, with valid=false.",
}

var Toolset = ops.Toolset{Name: "flows", MCPPath: "/mcp"}