@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/schemas/sessionApiContracts.cjs

@@ -0,0 +1,320 @@
+const require_protocolContracts = require("./protocolContracts.cjs");
+const require_protocolChannelsContract = require("./protocolChannelsContract.cjs");
+const require_protocolHubContract = require("./protocolHubContract.cjs");
+const require_protocolThreadContract = require("./protocolThreadContract.cjs");
+let typebox = require("typebox");
+//#region src/schemas/sessionApiContracts.ts
+const Text = typebox.Type.String();
+const NumberValue = typebox.Type.Number();
+const Flag = typebox.Type.Boolean();
+const Json = typebox.Type.Unsafe(typebox.Type.Unknown({ description: "Strict JSON application value supplied by the active tool, journal entry, or extension; validated by the Pi codec." }));
+const Optional = typebox.Type.Optional;
+const Strings = typebox.Type.Array(Text);
+const Model = typebox.Type.Object({
+	provider: Text,
+	id: Text
+});
+const Thinking = typebox.Type.Union([
+	typebox.Type.Literal("off"),
+	typebox.Type.Literal("minimal"),
+	typebox.Type.Literal("low"),
+	typebox.Type.Literal("medium"),
+	typebox.Type.Literal("high"),
+	typebox.Type.Literal("max"),
+	typebox.Type.Literal("xhigh")
+]);
+const Phase = typebox.Type.Union([
+	typebox.Type.Literal("idle"),
+	typebox.Type.Literal("turn"),
+	typebox.Type.Literal("compaction"),
+	typebox.Type.Literal("retry")
+]);
+const Image = typebox.Type.Object({
+	type: typebox.Type.Literal("image"),
+	data: Text,
+	mimeType: Text
+});
+const TextPart = typebox.Type.Object({
+	type: typebox.Type.Literal("text"),
+	text: Text
+});
+const ThinkingPart = typebox.Type.Object({
+	type: typebox.Type.Literal("thinking"),
+	thinking: Text,
+	redacted: Optional(typebox.Type.Literal(true))
+});
+const Content = typebox.Type.Union([Image, TextPart]);
+const Usage = typebox.Type.Object({
+	input: NumberValue,
+	output: NumberValue,
+	cacheRead: NumberValue,
+	cacheWrite: NumberValue,
+	total: NumberValue
+});
+const Message = typebox.Type.Object({
+	text: Text,
+	images: Optional(typebox.Type.Array(Image))
+});
+const Lifecycle = typebox.Type.Object({
+	revision: NumberValue,
+	operation: typebox.Type.Union([typebox.Type.Null(), typebox.Type.Object({
+		id: Text,
+		kind: typebox.Type.Union([
+			typebox.Type.Literal("run"),
+			typebox.Type.Literal("compaction"),
+			typebox.Type.Literal("navigation")
+		]),
+		status: typebox.Type.Union([typebox.Type.Literal("open"), typebox.Type.Literal("aborting")])
+	})]),
+	paused: Flag,
+	queue: typebox.Type.Array(typebox.Type.Object({
+		id: Text,
+		text: Text,
+		images: Optional(typebox.Type.Array(Image)),
+		delivery: typebox.Type.Union([
+			typebox.Type.Literal("steer"),
+			typebox.Type.Literal("followUp"),
+			typebox.Type.Literal("nextRun")
+		]),
+		scheduling: typebox.Type.Union([typebox.Type.Literal("automatic"), typebox.Type.Literal("held")]),
+		disposition: typebox.Type.Union([typebox.Type.Literal("pending"), typebox.Type.Literal("handoff")])
+	}))
+});
+const Frame = typebox.Type.Intersect([typebox.Type.Object({ type: Text }), typebox.Type.Record(Text, Json)], { description: "Discriminated extension presentation frame; selected channel schemas describe package payloads." });
+const ProtocolEvent = typebox.Type.Object({
+	sequence: NumberValue,
+	frame: Frame
+});
+const SessionServiceStateSchema = typebox.Type.Object({
+	snapshot: typebox.Type.Object({
+		fastMode: Flag,
+		locked: Flag,
+		lifecycle: Optional(Lifecycle)
+	}),
+	presentation: Optional(typebox.Type.Object({
+		revision: NumberValue,
+		dropped: NumberValue,
+		resetRevision: Optional(NumberValue),
+		events: typebox.Type.Array(ProtocolEvent),
+		projections: typebox.Type.Array(ProtocolEvent)
+	})),
+	live: Optional(typebox.Type.Object({
+		phase: Phase,
+		message: Optional(typebox.Type.Object({
+			role: typebox.Type.Literal("assistant"),
+			content: typebox.Type.Array(typebox.Type.Union([TextPart, ThinkingPart])),
+			model: Text,
+			timestamp: NumberValue
+		})),
+		tools: typebox.Type.Record(Text, typebox.Type.Object({
+			toolCallId: Text,
+			toolName: Text,
+			args: Json,
+			partialResult: Optional(typebox.Type.Object({
+				content: typebox.Type.Array(Content),
+				details: Optional(Json)
+			}))
+		}))
+	}))
+});
+/** Argument and result schemas of the `po.session` methods; the Chord contract and the API docs both read them. */
+const SessionMethodSchemas = {
+	readTranscriptPage: {
+		args: typebox.Type.Object({
+			cursor: Optional(Text),
+			direction: Optional(typebox.Type.Union([typebox.Type.Literal("older"), typebox.Type.Literal("newer")])),
+			limit: Optional(NumberValue),
+			threadId: Optional(Text)
+		}),
+		result: typebox.Type.Object({
+			entries: typebox.Type.Array(Json),
+			startCursor: typebox.Type.Union([Text, typebox.Type.Null()]),
+			endCursor: typebox.Type.Union([Text, typebox.Type.Null()]),
+			olderCursor: typebox.Type.Union([Text, typebox.Type.Null()]),
+			newerCursor: typebox.Type.Union([Text, typebox.Type.Null()]),
+			generation: NumberValue,
+			revision: NumberValue,
+			context: typebox.Type.Array(Json)
+		})
+	},
+	prompt: { args: typebox.Type.Union([Text, typebox.Type.Object({
+		...Message.properties,
+		waitFor: Optional(typebox.Type.Union([typebox.Type.Literal("accepted"), typebox.Type.Literal("settled")]))
+	})]) },
+	steer: { args: typebox.Type.Union([Text, Message]) },
+	abort: {},
+	abortOperation: { args: typebox.Type.Object({ operationId: Text }) },
+	setModel: { args: Model },
+	setThinking: { args: Thinking },
+	setFastMode: { args: Flag },
+	setAgentLock: { args: Flag },
+	followUp: { args: Message },
+	enqueueAutomatic: {
+		args: Message,
+		result: typebox.Type.Object({ id: Text })
+	},
+	removeQueued: {
+		args: typebox.Type.Object({ id: Text }),
+		result: typebox.Type.Union([
+			typebox.Type.Literal("removed"),
+			typebox.Type.Literal("in_flight"),
+			typebox.Type.Literal("already_consumed"),
+			typebox.Type.Literal("not_found")
+		])
+	},
+	promoteQueued: {
+		args: typebox.Type.Object({
+			id: Text,
+			operationId: Optional(Text)
+		}),
+		result: typebox.Type.Union([
+			typebox.Type.Literal("promoted"),
+			typebox.Type.Literal("in_flight"),
+			typebox.Type.Literal("target_changed"),
+			typebox.Type.Literal("not_found")
+		])
+	},
+	resumeQueue: {},
+	clearQueue: { result: typebox.Type.Object({
+		steering: Strings,
+		followUp: Strings
+	}) },
+	rewind: {
+		args: typebox.Type.Object({
+			itemId: Text,
+			summarize: Optional(Flag),
+			customInstructions: Optional(Text),
+			replaceInstructions: Optional(Flag),
+			label: Optional(Text)
+		}),
+		result: typebox.Type.Object({
+			editorText: Optional(Text),
+			cancelled: Flag,
+			aborted: Optional(Flag),
+			summaryEntry: Optional(typebox.Type.Object({
+				id: Text,
+				parentId: typebox.Type.Union([Text, typebox.Type.Null()]),
+				timestamp: Text,
+				fromId: Text,
+				summary: Text,
+				details: Optional(Json),
+				usage: Optional(Usage),
+				fromHook: Optional(Flag)
+			}))
+		})
+	},
+	extensionUiResponse: { args: typebox.Type.Union([
+		typebox.Type.Object({
+			id: Text,
+			value: Text
+		}),
+		typebox.Type.Object({
+			id: Text,
+			confirmed: Flag
+		}),
+		typebox.Type.Object({
+			id: Text,
+			cancelled: typebox.Type.Literal(true)
+		})
+	]) },
+	getState: { result: typebox.Type.Object({
+		model: Optional(Model),
+		thinkingLevel: Thinking,
+		fastMode: Flag,
+		agentLocked: Optional(Flag),
+		isStreaming: Flag,
+		isCompacting: Flag,
+		steeringMode: typebox.Type.Union([typebox.Type.Literal("all"), typebox.Type.Literal("one-at-a-time")]),
+		followUpMode: typebox.Type.Union([typebox.Type.Literal("all"), typebox.Type.Literal("one-at-a-time")]),
+		sessionId: Text,
+		sessionName: Optional(Text),
+		autoCompactionEnabled: Flag,
+		messageCount: NumberValue,
+		pendingMessageCount: NumberValue,
+		operationId: Optional(Text),
+		executionStatus: Optional(typebox.Type.Union([typebox.Type.Literal("open"), typebox.Type.Literal("aborting")])),
+		queuePaused: Optional(Flag),
+		queueRevision: Optional(NumberValue)
+	}) },
+	getSessionStats: { result: typebox.Type.Object({
+		sessionId: Text,
+		totalMessages: NumberValue,
+		tokens: Usage,
+		cost: NumberValue,
+		contextUsage: Optional(typebox.Type.Object({
+			tokens: typebox.Type.Union([NumberValue, typebox.Type.Null()]),
+			contextWindow: NumberValue,
+			percent: typebox.Type.Union([NumberValue, typebox.Type.Null()])
+		}))
+	}) },
+	getCommands: { result: typebox.Type.Array(typebox.Type.Object({
+		name: Text,
+		description: Optional(Text),
+		source: typebox.Type.Union([
+			typebox.Type.Literal("extension"),
+			typebox.Type.Literal("prompt"),
+			typebox.Type.Literal("skill")
+		]),
+		sourceInfo: Optional(typebox.Type.Object({
+			path: Text,
+			source: Text,
+			scope: typebox.Type.Union([
+				typebox.Type.Literal("user"),
+				typebox.Type.Literal("project"),
+				typebox.Type.Literal("temporary")
+			]),
+			origin: typebox.Type.Union([typebox.Type.Literal("package"), typebox.Type.Literal("top-level")]),
+			baseDir: Optional(Text)
+		}))
+	})) },
+	getAvailableModels: { result: typebox.Type.Array(Model) },
+	getAvailableThinkingLevels: { result: typebox.Type.Array(Thinking) },
+	compact: {
+		args: typebox.Type.Object({ customInstructions: Optional(Text) }),
+		result: Json
+	},
+	setName: { args: Text },
+	setGroups: { args: typebox.Type.Array(Text) }
+};
+/** The `po.session` methods as Chord specs. */
+const SessionMethods = require_protocolContracts.chordMethods(SessionMethodSchemas);
+const ErrorSchema = typebox.Type.Object({
+	code: Text,
+	message: Text
+});
+const documented = (id, service, member, direction, input, description) => ({
+	id,
+	scope: service === "po.hub" ? "global" : "session",
+	service,
+	member,
+	direction,
+	kind: direction === "server-to-client" ? "state" : "method",
+	input,
+	...direction === "server-to-client" ? {} : { errors: ErrorSchema },
+	description
+});
+[
+	...Object.entries(SessionMethodSchemas).map(([member, { args, result }]) => ({
+		id: `session.${member}`,
+		scope: "session",
+		service: "po.session",
+		member,
+		direction: "client-to-server",
+		kind: "method",
+		description: `Session ${member}. The Chord call carries the argument; a void result is null.`,
+		input: typebox.Type.Tuple(args === void 0 ? [] : [args]),
+		...result === void 0 ? {} : { output: result },
+		errors: ErrorSchema
+	})),
+	documented("session.state", "po.session", "state", "server-to-client", SessionServiceStateSchema, "The `state` member of `po.session`, reconstructed from Chord snapshot and delta frames."),
+	documented("hub.state", "po.hub", "state", "server-to-client", require_protocolHubContract.PoHubStateSchema, "Sessions and workspaces this connection may see, and notices it has not acknowledged."),
+	documented("thread.frame", "po.thread", "frame", "server-to-client", require_protocolThreadContract.PoThreadFrameSchema, "The latest frame of one child thread: transcript_state while it runs, transcript_ready once finished."),
+	documented("channels.latest", "po.channels", "latest", "server-to-client", require_protocolChannelsContract.PoChannelsStateSchema, "The latest payload of each extension channel frame type for one session."),
+	documented("channels.receive", "po.channels", "receive", "client-to-server", typebox.Type.Tuple([require_protocolChannelsContract.ChannelFrameSchema]), "Send one extension channel frame to the session.")
+];
+//#endregion
+exports.SessionMethodSchemas = SessionMethodSchemas;
+exports.SessionMethods = SessionMethods;
+exports.SessionServiceStateSchema = SessionServiceStateSchema;
+
+//# sourceMappingURL=sessionApiContracts.cjs.map

package/dist/src/schemas/sessionApiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionApiContracts.cjs","names":["Type","chordMethods","PoHubStateSchema","PoThreadFrameSchema","PoChannelsStateSchema","ChannelFrameSchema"],"sources":["../../../src/schemas/sessionApiContracts.ts"],"sourcesContent":["import { Type, type TSchema } from 'typebox';\n\nimport type { PoSocketContract } from './apiContracts';\nimport { ChannelFrameSchema, PoChannelsStateSchema } from './protocolChannelsContract';\nimport { chordMethods, type PoMethodSchemas } from './protocolContracts';\nimport { PoHubStateSchema } from './protocolHubContract';\nimport { PoThreadFrameSchema } from './protocolThreadContract';\nimport type { JsonValue } from './sessionProtocol';\n\nconst Text = Type.String();\nconst NumberValue = Type.Number();\nconst Flag = Type.Boolean();\nconst Json = Type.Unsafe<JsonValue>(\n  Type.Unknown({\n    description:\n      'Strict JSON application value supplied by the active tool, journal entry, or extension; validated by the Pi codec.',\n  }),\n);\nconst Optional = Type.Optional;\nconst Strings = Type.Array(Text);\nconst Model = Type.Object({ provider: Text, id: Text });\nconst Thinking = Type.Union([\n  Type.Literal('off'),\n  Type.Literal('minimal'),\n  Type.Literal('low'),\n  Type.Literal('medium'),\n  Type.Literal('high'),\n  Type.Literal('max'),\n  Type.Literal('xhigh'),\n]);\nconst Phase = Type.Union([\n  Type.Literal('idle'),\n  Type.Literal('turn'),\n  Type.Literal('compaction'),\n  Type.Literal('retry'),\n]);\nconst Image = Type.Object({ type: Type.Literal('image'), data: Text, mimeType: Text });\nconst TextPart = Type.Object({ type: Type.Literal('text'), text: Text });\nconst ThinkingPart = Type.Object({\n  type: Type.Literal('thinking'),\n  thinking: Text,\n  redacted: Optional(Type.Literal(true)),\n});\nconst Content = Type.Union([Image, TextPart]);\nconst Usage = Type.Object({\n  input: NumberValue,\n  output: NumberValue,\n  cacheRead: NumberValue,\n  cacheWrite: NumberValue,\n  total: NumberValue,\n});\nconst Message = Type.Object({ text: Text, images: Optional(Type.Array(Image)) });\nconst Lifecycle = Type.Object({\n  revision: NumberValue,\n  operation: Type.Union([\n    Type.Null(),\n    Type.Object({\n      id: Text,\n      kind: Type.Union([Type.Literal('run'), Type.Literal('compaction'), Type.Literal('navigation')]),\n      status: Type.Union([Type.Literal('open'), Type.Literal('aborting')]),\n    }),\n  ]),\n  paused: Flag,\n  queue: Type.Array(\n    Type.Object({\n      id: Text,\n      text: Text,\n      images: Optional(Type.Array(Image)),\n      delivery: Type.Union([Type.Literal('steer'), Type.Literal('followUp'), Type.Literal('nextRun')]),\n      scheduling: Type.Union([Type.Literal('automatic'), Type.Literal('held')]),\n      disposition: Type.Union([Type.Literal('pending'), Type.Literal('handoff')]),\n    }),\n  ),\n});\nconst Frame = Type.Intersect([Type.Object({ type: Text }), Type.Record(Text, Json)], {\n  description: 'Discriminated extension presentation frame; selected channel schemas describe package payloads.',\n});\nconst ProtocolEvent = Type.Object({ sequence: NumberValue, frame: Frame });\nexport const SessionServiceStateSchema = Type.Object({\n  snapshot: Type.Object({\n    fastMode: Flag,\n    locked: Flag,\n    lifecycle: Optional(Lifecycle),\n  }),\n  presentation: Optional(\n    Type.Object({\n      revision: NumberValue,\n      dropped: NumberValue,\n      resetRevision: Optional(NumberValue),\n      events: Type.Array(ProtocolEvent),\n      projections: Type.Array(ProtocolEvent),\n    }),\n  ),\n  live: Optional(\n    Type.Object({\n      phase: Phase,\n      message: Optional(\n        Type.Object({\n          role: Type.Literal('assistant'),\n          content: Type.Array(Type.Union([TextPart, ThinkingPart])),\n          model: Text,\n          timestamp: NumberValue,\n        }),\n      ),\n      tools: Type.Record(\n        Text,\n        Type.Object({\n          toolCallId: Text,\n          toolName: Text,\n          args: Json,\n          partialResult: Optional(Type.Object({ content: Type.Array(Content), details: Optional(Json) })),\n        }),\n      ),\n    }),\n  ),\n});\n/** Argument and result schemas of the `po.session` methods; the Chord contract and the API docs both read them. */\nexport const SessionMethodSchemas = {\n  readTranscriptPage: {\n    args: Type.Object({\n      cursor: Optional(Text),\n      direction: Optional(Type.Union([Type.Literal('older'), Type.Literal('newer')])),\n      limit: Optional(NumberValue),\n      threadId: Optional(Text),\n    }),\n    result: Type.Object({\n      entries: Type.Array(Json),\n      startCursor: Type.Union([Text, Type.Null()]),\n      endCursor: Type.Union([Text, Type.Null()]),\n      olderCursor: Type.Union([Text, Type.Null()]),\n      newerCursor: Type.Union([Text, Type.Null()]),\n      generation: NumberValue,\n      revision: NumberValue,\n      context: Type.Array(Json),\n    }),\n  },\n  prompt: {\n    args: Type.Union([\n      Text,\n      Type.Object({\n        ...Message.properties,\n        waitFor: Optional(Type.Union([Type.Literal('accepted'), Type.Literal('settled')])),\n      }),\n    ]),\n  },\n  steer: { args: Type.Union([Text, Message]) },\n  abort: {},\n  abortOperation: { args: Type.Object({ operationId: Text }) },\n  setModel: { args: Model },\n  setThinking: { args: Thinking },\n  setFastMode: { args: Flag },\n  setAgentLock: { args: Flag },\n  followUp: { args: Message },\n  enqueueAutomatic: { args: Message, result: Type.Object({ id: Text }) },\n  removeQueued: {\n    args: Type.Object({ id: Text }),\n    result: Type.Union([\n      Type.Literal('removed'),\n      Type.Literal('in_flight'),\n      Type.Literal('already_consumed'),\n      Type.Literal('not_found'),\n    ]),\n  },\n  promoteQueued: {\n    args: Type.Object({ id: Text, operationId: Optional(Text) }),\n    result: Type.Union([\n      Type.Literal('promoted'),\n      Type.Literal('in_flight'),\n      Type.Literal('target_changed'),\n      Type.Literal('not_found'),\n    ]),\n  },\n  resumeQueue: {},\n  clearQueue: { result: Type.Object({ steering: Strings, followUp: Strings }) },\n  rewind: {\n    args: Type.Object({\n      itemId: Text,\n      summarize: Optional(Flag),\n      customInstructions: Optional(Text),\n      replaceInstructions: Optional(Flag),\n      label: Optional(Text),\n    }),\n    result: Type.Object({\n      editorText: Optional(Text),\n      cancelled: Flag,\n      aborted: Optional(Flag),\n      summaryEntry: Optional(\n        Type.Object({\n          id: Text,\n          parentId: Type.Union([Text, Type.Null()]),\n          timestamp: Text,\n          fromId: Text,\n          summary: Text,\n          details: Optional(Json),\n          usage: Optional(Usage),\n          fromHook: Optional(Flag),\n        }),\n      ),\n    }),\n  },\n  extensionUiResponse: {\n    args: Type.Union([\n      Type.Object({ id: Text, value: Text }),\n      Type.Object({ id: Text, confirmed: Flag }),\n      Type.Object({ id: Text, cancelled: Type.Literal(true) }),\n    ]),\n  },\n  getState: {\n    result: Type.Object({\n      model: Optional(Model),\n      thinkingLevel: Thinking,\n      fastMode: Flag,\n      agentLocked: Optional(Flag),\n      isStreaming: Flag,\n      isCompacting: Flag,\n      steeringMode: Type.Union([Type.Literal('all'), Type.Literal('one-at-a-time')]),\n      followUpMode: Type.Union([Type.Literal('all'), Type.Literal('one-at-a-time')]),\n      sessionId: Text,\n      sessionName: Optional(Text),\n      autoCompactionEnabled: Flag,\n      messageCount: NumberValue,\n      pendingMessageCount: NumberValue,\n      operationId: Optional(Text),\n      executionStatus: Optional(Type.Union([Type.Literal('open'), Type.Literal('aborting')])),\n      queuePaused: Optional(Flag),\n      queueRevision: Optional(NumberValue),\n    }),\n  },\n  getSessionStats: {\n    result: Type.Object({\n      sessionId: Text,\n      totalMessages: NumberValue,\n      tokens: Usage,\n      cost: NumberValue,\n      contextUsage: Optional(\n        Type.Object({\n          tokens: Type.Union([NumberValue, Type.Null()]),\n          contextWindow: NumberValue,\n          percent: Type.Union([NumberValue, Type.Null()]),\n        }),\n      ),\n    }),\n  },\n  getCommands: {\n    result: Type.Array(\n      Type.Object({\n        name: Text,\n        description: Optional(Text),\n        source: Type.Union([Type.Literal('extension'), Type.Literal('prompt'), Type.Literal('skill')]),\n        sourceInfo: Optional(\n          Type.Object({\n            path: Text,\n            source: Text,\n            scope: Type.Union([Type.Literal('user'), Type.Literal('project'), Type.Literal('temporary')]),\n            origin: Type.Union([Type.Literal('package'), Type.Literal('top-level')]),\n            baseDir: Optional(Text),\n          }),\n        ),\n      }),\n    ),\n  },\n  getAvailableModels: { result: Type.Array(Model) },\n  getAvailableThinkingLevels: { result: Type.Array(Thinking) },\n  compact: { args: Type.Object({ customInstructions: Optional(Text) }), result: Json },\n  setName: { args: Text },\n  setGroups: { args: Type.Array(Text) },\n};\n/** The `po.session` methods as Chord specs. */\nexport const SessionMethods = chordMethods(SessionMethodSchemas);\n\nconst ErrorSchema = Type.Object({ code: Text, message: Text });\nconst documented = (\n  id: string,\n  service: string,\n  member: string,\n  direction: PoSocketContract['direction'],\n  input: TSchema,\n  description: string,\n): PoSocketContract => ({\n  id,\n  scope: service === 'po.hub' ? 'global' : 'session',\n  service,\n  member,\n  direction,\n  kind: direction === 'server-to-client' ? 'state' : 'method',\n  input,\n  ...(direction === 'server-to-client' ? {} : { errors: ErrorSchema }),\n  description,\n});\nexport const sessionSocketContracts: PoSocketContract[] = [\n  ...Object.entries<PoMethodSchemas>(SessionMethodSchemas).map(([member, { args, result }]): PoSocketContract => ({\n    id: `session.${member}`,\n    scope: 'session',\n    service: 'po.session',\n    member,\n    direction: 'client-to-server',\n    kind: 'method',\n    description: `Session ${member}. The Chord call carries the argument; a void result is null.`,\n    input: Type.Tuple(args === undefined ? [] : ([args] as TSchema[])),\n    ...(result === undefined ? {} : { output: result }),\n    errors: ErrorSchema,\n  })),\n  documented(\n    'session.state',\n    'po.session',\n    'state',\n    'server-to-client',\n    SessionServiceStateSchema,\n    'The `state` member of `po.session`, reconstructed from Chord snapshot and delta frames.',\n  ),\n  documented(\n    'hub.state',\n    'po.hub',\n    'state',\n    'server-to-client',\n    PoHubStateSchema,\n    'Sessions and workspaces this connection may see, and notices it has not acknowledged.',\n  ),\n  documented(\n    'thread.frame',\n    'po.thread',\n    'frame',\n    'server-to-client',\n    PoThreadFrameSchema,\n    'The latest frame of one child thread: transcript_state while it runs, transcript_ready once finished.',\n  ),\n  documented(\n    'channels.latest',\n    'po.channels',\n    'latest',\n    'server-to-client',\n    PoChannelsStateSchema,\n    'The latest payload of each extension channel frame type for one session.',\n  ),\n  documented(\n    'channels.receive',\n    'po.channels',\n    'receive',\n    'client-to-server',\n    Type.Tuple([ChannelFrameSchema]),\n    'Send one extension channel frame to the session.',\n  ),\n];\n"],"mappings":"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"}

package/dist/src/schemas/sessionApiContracts.mjs

@@ -0,0 +1,318 @@
+import { chordMethods } from "./protocolContracts.mjs";
+import { ChannelFrameSchema, PoChannelsStateSchema } from "./protocolChannelsContract.mjs";
+import { PoHubStateSchema } from "./protocolHubContract.mjs";
+import { PoThreadFrameSchema } from "./protocolThreadContract.mjs";
+import { Type } from "typebox";
+//#region src/schemas/sessionApiContracts.ts
+const Text = Type.String();
+const NumberValue = Type.Number();
+const Flag = Type.Boolean();
+const Json = Type.Unsafe(Type.Unknown({ description: "Strict JSON application value supplied by the active tool, journal entry, or extension; validated by the Pi codec." }));
+const Optional = Type.Optional;
+const Strings = Type.Array(Text);
+const Model = Type.Object({
+	provider: Text,
+	id: Text
+});
+const Thinking = Type.Union([
+	Type.Literal("off"),
+	Type.Literal("minimal"),
+	Type.Literal("low"),
+	Type.Literal("medium"),
+	Type.Literal("high"),
+	Type.Literal("max"),
+	Type.Literal("xhigh")
+]);
+const Phase = Type.Union([
+	Type.Literal("idle"),
+	Type.Literal("turn"),
+	Type.Literal("compaction"),
+	Type.Literal("retry")
+]);
+const Image = Type.Object({
+	type: Type.Literal("image"),
+	data: Text,
+	mimeType: Text
+});
+const TextPart = Type.Object({
+	type: Type.Literal("text"),
+	text: Text
+});
+const ThinkingPart = Type.Object({
+	type: Type.Literal("thinking"),
+	thinking: Text,
+	redacted: Optional(Type.Literal(true))
+});
+const Content = Type.Union([Image, TextPart]);
+const Usage = Type.Object({
+	input: NumberValue,
+	output: NumberValue,
+	cacheRead: NumberValue,
+	cacheWrite: NumberValue,
+	total: NumberValue
+});
+const Message = Type.Object({
+	text: Text,
+	images: Optional(Type.Array(Image))
+});
+const Lifecycle = Type.Object({
+	revision: NumberValue,
+	operation: Type.Union([Type.Null(), Type.Object({
+		id: Text,
+		kind: Type.Union([
+			Type.Literal("run"),
+			Type.Literal("compaction"),
+			Type.Literal("navigation")
+		]),
+		status: Type.Union([Type.Literal("open"), Type.Literal("aborting")])
+	})]),
+	paused: Flag,
+	queue: Type.Array(Type.Object({
+		id: Text,
+		text: Text,
+		images: Optional(Type.Array(Image)),
+		delivery: Type.Union([
+			Type.Literal("steer"),
+			Type.Literal("followUp"),
+			Type.Literal("nextRun")
+		]),
+		scheduling: Type.Union([Type.Literal("automatic"), Type.Literal("held")]),
+		disposition: Type.Union([Type.Literal("pending"), Type.Literal("handoff")])
+	}))
+});
+const Frame = Type.Intersect([Type.Object({ type: Text }), Type.Record(Text, Json)], { description: "Discriminated extension presentation frame; selected channel schemas describe package payloads." });
+const ProtocolEvent = Type.Object({
+	sequence: NumberValue,
+	frame: Frame
+});
+const SessionServiceStateSchema = Type.Object({
+	snapshot: Type.Object({
+		fastMode: Flag,
+		locked: Flag,
+		lifecycle: Optional(Lifecycle)
+	}),
+	presentation: Optional(Type.Object({
+		revision: NumberValue,
+		dropped: NumberValue,
+		resetRevision: Optional(NumberValue),
+		events: Type.Array(ProtocolEvent),
+		projections: Type.Array(ProtocolEvent)
+	})),
+	live: Optional(Type.Object({
+		phase: Phase,
+		message: Optional(Type.Object({
+			role: Type.Literal("assistant"),
+			content: Type.Array(Type.Union([TextPart, ThinkingPart])),
+			model: Text,
+			timestamp: NumberValue
+		})),
+		tools: Type.Record(Text, Type.Object({
+			toolCallId: Text,
+			toolName: Text,
+			args: Json,
+			partialResult: Optional(Type.Object({
+				content: Type.Array(Content),
+				details: Optional(Json)
+			}))
+		}))
+	}))
+});
+/** Argument and result schemas of the `po.session` methods; the Chord contract and the API docs both read them. */
+const SessionMethodSchemas = {
+	readTranscriptPage: {
+		args: Type.Object({
+			cursor: Optional(Text),
+			direction: Optional(Type.Union([Type.Literal("older"), Type.Literal("newer")])),
+			limit: Optional(NumberValue),
+			threadId: Optional(Text)
+		}),
+		result: Type.Object({
+			entries: Type.Array(Json),
+			startCursor: Type.Union([Text, Type.Null()]),
+			endCursor: Type.Union([Text, Type.Null()]),
+			olderCursor: Type.Union([Text, Type.Null()]),
+			newerCursor: Type.Union([Text, Type.Null()]),
+			generation: NumberValue,
+			revision: NumberValue,
+			context: Type.Array(Json)
+		})
+	},
+	prompt: { args: Type.Union([Text, Type.Object({
+		...Message.properties,
+		waitFor: Optional(Type.Union([Type.Literal("accepted"), Type.Literal("settled")]))
+	})]) },
+	steer: { args: Type.Union([Text, Message]) },
+	abort: {},
+	abortOperation: { args: Type.Object({ operationId: Text }) },
+	setModel: { args: Model },
+	setThinking: { args: Thinking },
+	setFastMode: { args: Flag },
+	setAgentLock: { args: Flag },
+	followUp: { args: Message },
+	enqueueAutomatic: {
+		args: Message,
+		result: Type.Object({ id: Text })
+	},
+	removeQueued: {
+		args: Type.Object({ id: Text }),
+		result: Type.Union([
+			Type.Literal("removed"),
+			Type.Literal("in_flight"),
+			Type.Literal("already_consumed"),
+			Type.Literal("not_found")
+		])
+	},
+	promoteQueued: {
+		args: Type.Object({
+			id: Text,
+			operationId: Optional(Text)
+		}),
+		result: Type.Union([
+			Type.Literal("promoted"),
+			Type.Literal("in_flight"),
+			Type.Literal("target_changed"),
+			Type.Literal("not_found")
+		])
+	},
+	resumeQueue: {},
+	clearQueue: { result: Type.Object({
+		steering: Strings,
+		followUp: Strings
+	}) },
+	rewind: {
+		args: Type.Object({
+			itemId: Text,
+			summarize: Optional(Flag),
+			customInstructions: Optional(Text),
+			replaceInstructions: Optional(Flag),
+			label: Optional(Text)
+		}),
+		result: Type.Object({
+			editorText: Optional(Text),
+			cancelled: Flag,
+			aborted: Optional(Flag),
+			summaryEntry: Optional(Type.Object({
+				id: Text,
+				parentId: Type.Union([Text, Type.Null()]),
+				timestamp: Text,
+				fromId: Text,
+				summary: Text,
+				details: Optional(Json),
+				usage: Optional(Usage),
+				fromHook: Optional(Flag)
+			}))
+		})
+	},
+	extensionUiResponse: { args: Type.Union([
+		Type.Object({
+			id: Text,
+			value: Text
+		}),
+		Type.Object({
+			id: Text,
+			confirmed: Flag
+		}),
+		Type.Object({
+			id: Text,
+			cancelled: Type.Literal(true)
+		})
+	]) },
+	getState: { result: Type.Object({
+		model: Optional(Model),
+		thinkingLevel: Thinking,
+		fastMode: Flag,
+		agentLocked: Optional(Flag),
+		isStreaming: Flag,
+		isCompacting: Flag,
+		steeringMode: Type.Union([Type.Literal("all"), Type.Literal("one-at-a-time")]),
+		followUpMode: Type.Union([Type.Literal("all"), Type.Literal("one-at-a-time")]),
+		sessionId: Text,
+		sessionName: Optional(Text),
+		autoCompactionEnabled: Flag,
+		messageCount: NumberValue,
+		pendingMessageCount: NumberValue,
+		operationId: Optional(Text),
+		executionStatus: Optional(Type.Union([Type.Literal("open"), Type.Literal("aborting")])),
+		queuePaused: Optional(Flag),
+		queueRevision: Optional(NumberValue)
+	}) },
+	getSessionStats: { result: Type.Object({
+		sessionId: Text,
+		totalMessages: NumberValue,
+		tokens: Usage,
+		cost: NumberValue,
+		contextUsage: Optional(Type.Object({
+			tokens: Type.Union([NumberValue, Type.Null()]),
+			contextWindow: NumberValue,
+			percent: Type.Union([NumberValue, Type.Null()])
+		}))
+	}) },
+	getCommands: { result: Type.Array(Type.Object({
+		name: Text,
+		description: Optional(Text),
+		source: Type.Union([
+			Type.Literal("extension"),
+			Type.Literal("prompt"),
+			Type.Literal("skill")
+		]),
+		sourceInfo: Optional(Type.Object({
+			path: Text,
+			source: Text,
+			scope: Type.Union([
+				Type.Literal("user"),
+				Type.Literal("project"),
+				Type.Literal("temporary")
+			]),
+			origin: Type.Union([Type.Literal("package"), Type.Literal("top-level")]),
+			baseDir: Optional(Text)
+		}))
+	})) },
+	getAvailableModels: { result: Type.Array(Model) },
+	getAvailableThinkingLevels: { result: Type.Array(Thinking) },
+	compact: {
+		args: Type.Object({ customInstructions: Optional(Text) }),
+		result: Json
+	},
+	setName: { args: Text },
+	setGroups: { args: Type.Array(Text) }
+};
+/** The `po.session` methods as Chord specs. */
+const SessionMethods = chordMethods(SessionMethodSchemas);
+const ErrorSchema = Type.Object({
+	code: Text,
+	message: Text
+});
+const documented = (id, service, member, direction, input, description) => ({
+	id,
+	scope: service === "po.hub" ? "global" : "session",
+	service,
+	member,
+	direction,
+	kind: direction === "server-to-client" ? "state" : "method",
+	input,
+	...direction === "server-to-client" ? {} : { errors: ErrorSchema },
+	description
+});
+[
+	...Object.entries(SessionMethodSchemas).map(([member, { args, result }]) => ({
+		id: `session.${member}`,
+		scope: "session",
+		service: "po.session",
+		member,
+		direction: "client-to-server",
+		kind: "method",
+		description: `Session ${member}. The Chord call carries the argument; a void result is null.`,
+		input: Type.Tuple(args === void 0 ? [] : [args]),
+		...result === void 0 ? {} : { output: result },
+		errors: ErrorSchema
+	})),
+	documented("session.state", "po.session", "state", "server-to-client", SessionServiceStateSchema, "The `state` member of `po.session`, reconstructed from Chord snapshot and delta frames."),
+	documented("hub.state", "po.hub", "state", "server-to-client", PoHubStateSchema, "Sessions and workspaces this connection may see, and notices it has not acknowledged."),
+	documented("thread.frame", "po.thread", "frame", "server-to-client", PoThreadFrameSchema, "The latest frame of one child thread: transcript_state while it runs, transcript_ready once finished."),
+	documented("channels.latest", "po.channels", "latest", "server-to-client", PoChannelsStateSchema, "The latest payload of each extension channel frame type for one session."),
+	documented("channels.receive", "po.channels", "receive", "client-to-server", Type.Tuple([ChannelFrameSchema]), "Send one extension channel frame to the session.")
+];
+//#endregion
+export { SessionMethodSchemas, SessionMethods, SessionServiceStateSchema };
+
+//# sourceMappingURL=sessionApiContracts.mjs.map