@agimon-ai/po-author 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @agimon-ai/po-author
+
+Private, optional Po minor mode for focused document review and bounded visual authoring.
+
+## Behavior
+
+Author is a session-scoped minor mode. Its three tools remain registered for the life of the extension but are active only while Author mode is active:
+
+- `open_authoring_file({"path":"relative/file.png","alias":"review"})` validates a repository file and opens or reuses its temporary canvas without writing the file. Alias is optional. Opening the same file under another name returns the original alias; an alias cannot be reassigned to another file.
+- `describe_author_tools({})` lists canvas aliases and readiness. `describe_author_tools({"alias":"review"})` returns that canvas's current capability catalog and server-issued token when ready. Opening does not wait for the tab to become ready; describe again after it opens.
+- `use_author_tools({"alias":"review","catalogToken":"...","name":"...","arguments":{}})` invokes one capability with exactly the advertised arguments. Alias is optional only if one open canvas is unambiguous.
+
+Catalog tokens rotate whenever capabilities change. Document-backed tools remain targetable from the main conversation while the canvas is open; live viewport grid operations require a visible tab. Closed canvases can be reopened by path and alias. Viewport document content is untrusted data, never agent instructions.
+
+Unsent annotations belong to their document and leave the canvas once a send is accepted; the dock's request log keeps the request for the open document. Messages typed in an Author file tab carry `Author document: <path> (canvas <alias>)` as referenced context. Slash commands are sent unchanged.
+The package declares session API, cockpit client, and web hub entries. Each canvas has an isolated ownership lease and catalog token; stale bindings and cross-canvas tokens are rejected. Without the host session API socket and token, catalog operations fail as unavailable.
+
+## Public API
+
+```ts
+import { activateAuthorExtension } from '@agimon-ai/po-author/extensions/pi';
+import { createAuthorCatalog, DescribeAuthorToolsInputSchema, UseAuthorToolInputSchema } from '@agimon-ai/po-author';
+```
+
+The Pi host entry is available at `@agimon-ai/po-author/extensions/pi`.
+
+## Development
+
+```bash
+pnpm fixcode
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## Plugin lifecycle
+
+Author uses the shared [plugin lifecycle contract](../../core/po-core/docs/plugins.md). Pi and server entries compose shared tool and command declarations; controllers own Author behavior, and the helpers own registration and disposal. Minor-mode entry and exit are independent of plugin mounting.

package/dist/apiContracts.cjs

@@ -0,0 +1,348 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_po_core_apiContracts = require("@agimon-ai/po-core/apiContracts");
+let typebox = require("typebox");
+require("@agimon-ai/po-core/pluginProtocol");
+//#region src/schemas/authorFacade.ts
+const AuthorCapabilityNameSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: 30,
+	pattern: "^[a-z][a-z0-9_]*$"
+});
+const AuthorAliasSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: 64,
+	pattern: "^[a-z][a-z0-9_-]{0,63}$"
+});
+typebox.Type.Object({ alias: typebox.Type.Optional(AuthorAliasSchema) }, { additionalProperties: false });
+/** Invokes one capability exposed by the current Author viewport. */
+const AuthorUseToolsInputSchema = typebox.Type.Object({
+	alias: typebox.Type.Optional(AuthorAliasSchema),
+	catalogToken: typebox.Type.String({
+		minLength: 1,
+		maxLength: 256
+	}),
+	name: AuthorCapabilityNameSchema,
+	arguments: typebox.Type.Record(typebox.Type.String(), typebox.Type.Unknown())
+}, { additionalProperties: false });
+const AuthorBridgeBase = {
+	alias: AuthorAliasSchema,
+	generation: typebox.Type.Number({ minimum: 0 })
+};
+/** Browser-to-server lease messages, validated before Author sees the payload. */
+const AuthorBridgeMessageSchema = typebox.Type.Union([
+	typebox.Type.Object({
+		...AuthorBridgeBase,
+		kind: typebox.Type.Literal("register")
+	}, { additionalProperties: false }),
+	typebox.Type.Object({
+		...AuthorBridgeBase,
+		kind: typebox.Type.Literal("release")
+	}, { additionalProperties: false }),
+	typebox.Type.Object({
+		...AuthorBridgeBase,
+		kind: typebox.Type.Literal("catalog"),
+		ownerToken: typebox.Type.String({ minLength: 1 }),
+		tools: typebox.Type.Array(typebox.Type.Object({
+			name: typebox.Type.String({ minLength: 1 }),
+			label: typebox.Type.String(),
+			description: typebox.Type.String(),
+			inputSchema: typebox.Type.Record(typebox.Type.String(), typebox.Type.Unknown())
+		}, { additionalProperties: false }))
+	}, { additionalProperties: false }),
+	typebox.Type.Object({
+		...AuthorBridgeBase,
+		kind: typebox.Type.Literal("result"),
+		ownerToken: typebox.Type.String({ minLength: 1 }),
+		catalogToken: typebox.Type.String({ minLength: 1 }),
+		requestId: typebox.Type.String({ minLength: 1 }),
+		result: typebox.Type.Unknown()
+	}, { additionalProperties: false }),
+	typebox.Type.Object({
+		...AuthorBridgeBase,
+		kind: typebox.Type.Literal("cancelled"),
+		ownerToken: typebox.Type.String({ minLength: 1 }),
+		catalogToken: typebox.Type.String({ minLength: 1 }),
+		requestId: typebox.Type.String({ minLength: 1 })
+	}, { additionalProperties: false })
+]);
+const AuthorBridgeInputSchema = typebox.Type.Object({
+	sessionId: typebox.Type.String({ minLength: 1 }),
+	message: AuthorBridgeMessageSchema
+}, { additionalProperties: false });
+//#endregion
+//#region src/schemas/apiContracts.ts
+const S = typebox.Type.String();
+const N = typebox.Type.Number();
+const B = typebox.Type.Boolean();
+const O = typebox.Type.Optional;
+const Json = typebox.Type.Unknown({ description: "Runtime author capability value, validated against the capability catalog inputSchema." });
+const values = (items) => typebox.Type.Union(items.map((item) => typebox.Type.Literal(item)));
+const Capability = typebox.Type.Object({
+	name: S,
+	label: S,
+	description: S,
+	inputSchema: typebox.Type.Record(S, Json)
+});
+const Accepted = typebox.Type.Object({
+	alias: AuthorAliasSchema,
+	kind: typebox.Type.Literal("accepted"),
+	generation: N,
+	ownerToken: S,
+	catalogToken: O(S),
+	leaseMs: N
+});
+const Identity = {
+	alias: AuthorAliasSchema,
+	generation: N,
+	ownerToken: S,
+	catalogToken: S,
+	requestId: S
+};
+const Request = typebox.Type.Object({
+	kind: typebox.Type.Literal("request"),
+	...Identity,
+	name: S,
+	arguments: typebox.Type.Record(S, Json)
+});
+const Cancel = typebox.Type.Object({
+	kind: typebox.Type.Literal("cancel"),
+	...Identity
+});
+const AuthorHubMessageSchema = typebox.Type.Union([
+	Accepted,
+	Request,
+	Cancel,
+	typebox.Type.Object({
+		alias: AuthorAliasSchema,
+		kind: typebox.Type.Literal("rejected"),
+		reason: S
+	})
+]);
+const Binding = {
+	alias: AuthorAliasSchema,
+	bindingId: S,
+	generation: typebox.Type.Integer({ minimum: 0 })
+};
+const Owner = {
+	...Binding,
+	ownerToken: S
+};
+const ResultIdentity = {
+	...Owner,
+	catalogToken: S,
+	requestId: S
+};
+const Format = values([
+	"markdown-slides",
+	"csv",
+	"pptx",
+	"xlsx"
+]);
+const Manifest = typebox.Type.Object({
+	format: Format,
+	sourceDigest: S,
+	byteLength: N,
+	fragmentCount: N,
+	metadata: typebox.Type.Record(S, typebox.Type.Union([
+		S,
+		N,
+		B
+	]))
+});
+const Operation = {
+	fragmentId: S,
+	replacement: S
+};
+const Log = typebox.Type.Array(typebox.Type.Object({
+	...Operation,
+	previous: S
+}));
+const Document = {
+	path: S,
+	format: Format,
+	operations: O(typebox.Type.Array(typebox.Type.Object(Operation), { maxItems: 1e5 })),
+	csvDialect: O(typebox.Type.Object({
+		delimiter: O(values([
+			",",
+			";",
+			"	",
+			"|"
+		])),
+		quote: O(values(["\"", "'"])),
+		recordDelimiter: O(values(["\n", "\r\n"]))
+	}))
+};
+const ParsedDocument = typebox.Type.Object({
+	manifest: Manifest,
+	fragments: typebox.Type.Array(typebox.Type.Object({
+		id: S,
+		kind: values([
+			"slide",
+			"cell",
+			"text-run"
+		]),
+		text: S,
+		readOnly: O(B),
+		location: S
+	})),
+	renderModel: typebox.Type.Object({
+		format: Format,
+		blocks: typebox.Type.Array(typebox.Type.Object({
+			id: S,
+			text: S,
+			readOnly: B
+		}))
+	})
+});
+const post = (id, path, schema, output) => ({
+	id,
+	scope: "session",
+	basePath: "author",
+	path,
+	method: "POST",
+	authentication: "owner",
+	description: `Author ${id}.`,
+	body: {
+		required: true,
+		contentType: "application/json",
+		schema
+	},
+	responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(output)
+});
+const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
+	version: 1,
+	dynamic: ["Author capability catalogs supply input JSON Schemas and arbitrary JSON results at runtime."],
+	http: [
+		{
+			id: "author.state",
+			scope: "session",
+			basePath: "author",
+			path: "/state",
+			method: "GET",
+			authentication: "owner",
+			description: "Read author activation.",
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
+				sessionId: typebox.Type.Union([S, typebox.Type.Null()]),
+				activation: values(["inactive", "active"]),
+				capabilityCount: N
+			}))
+		},
+		post("bridge.register", "/bridge/register", typebox.Type.Object(Binding), Accepted),
+		post("bridge.catalog", "/bridge/catalog", typebox.Type.Object({
+			...Owner,
+			tools: typebox.Type.Array(Capability)
+		}), Accepted),
+		post("bridge.next", "/bridge/next", typebox.Type.Object(Owner), typebox.Type.Union([Request, Cancel])),
+		post("bridge.result", "/bridge/result", typebox.Type.Object({
+			...ResultIdentity,
+			result: Json
+		}), typebox.Type.Object({ accepted: typebox.Type.Literal(true) })),
+		post("bridge.cancelled", "/bridge/cancelled", typebox.Type.Object(ResultIdentity), typebox.Type.Object({ accepted: typebox.Type.Literal(true) })),
+		post("bridge.disconnect", "/bridge/disconnect", typebox.Type.Object(Binding), typebox.Type.Object({ accepted: typebox.Type.Literal(true) })),
+		post("bridge.close", "/bridge/close", typebox.Type.Object({ alias: AuthorAliasSchema }), typebox.Type.Object({ accepted: typebox.Type.Literal(true) })),
+		{
+			id: "bridge.describe",
+			scope: "session",
+			basePath: "author",
+			path: "/bridge/describe",
+			method: "GET",
+			authentication: "owner",
+			description: "Read runtime author capabilities.",
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
+				catalogToken: S,
+				tools: typebox.Type.Array(Capability),
+				canvases: typebox.Type.Array(typebox.Type.Object({
+					alias: S,
+					path: S,
+					status: values([
+						"opening",
+						"ready",
+						"unavailable"
+					])
+				}))
+			}))
+		},
+		post("bridge.invoke", "/bridge/invoke", AuthorUseToolsInputSchema, typebox.Type.Object({
+			alias: AuthorAliasSchema,
+			catalogToken: S,
+			name: S,
+			result: Json
+		})),
+		post("documents.open", "/documents/open", typebox.Type.Object({
+			...Document,
+			format: O(Format),
+			alias: O(AuthorAliasSchema)
+		}), typebox.Type.Union([typebox.Type.Object({
+			path: S,
+			byteLength: N,
+			alias: AuthorAliasSchema,
+			status: values([
+				"opening",
+				"ready",
+				"unavailable"
+			]),
+			reused: B
+		}), ParsedDocument])),
+		post("documents.preflight", "/documents/preflight", typebox.Type.Object(Document), typebox.Type.Object({
+			accepted: B,
+			digest: S,
+			sourceDigest: S,
+			operations: Log,
+			issues: typebox.Type.Array(typebox.Type.Object({
+				code: S,
+				message: S,
+				fragmentId: O(S)
+			}))
+		})),
+		post("documents.serialize", "/documents/serialize", typebox.Type.Object({
+			...Document,
+			preflightDigest: S
+		}), typebox.Type.Object({
+			bytes: S,
+			encoding: typebox.Type.Literal("base64"),
+			manifest: Manifest,
+			operationLog: Log
+		}))
+	],
+	sockets: ["global", "workspace"].flatMap((scope) => [
+		{
+			id: "author.send",
+			scope,
+			service: "author.bridge",
+			member: "send",
+			kind: "method",
+			direction: "client-to-server",
+			description: "Scoped author bridge method invoked through po.plugin.v1.",
+			input: AuthorBridgeInputSchema,
+			output: typebox.Type.Object({}, { additionalProperties: false })
+		},
+		{
+			id: "author.browser",
+			scope,
+			service: "po.hub.v1",
+			member: "author_webmcp",
+			kind: "channel",
+			direction: "client-to-server",
+			description: "Browser author channel payload.",
+			input: AuthorBridgeMessageSchema
+		},
+		{
+			id: "author.hub",
+			scope,
+			service: "po.hub.v1",
+			member: "author_webmcp",
+			kind: "channel",
+			direction: "server-to-client",
+			description: "Hub author channel payload.",
+			input: AuthorHubMessageSchema
+		}
+	])
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["Type","Type","jsonApiResponses","defineApiContract"],"sources":["../src/schemas/authorFacade.ts","../src/schemas/apiContracts.ts"],"sourcesContent":["import type { DoomApiScope } from '@agimon-ai/po-core/packageApi';\nimport { defineDoomPluginMethod } from '@agimon-ai/po-core/pluginProtocol';\nimport { type Static, Type } from 'typebox';\n\nconst AuthorCapabilityNameSchema = Type.String({\n  minLength: 1,\n  maxLength: 30,\n  pattern: '^[a-z][a-z0-9_]*$',\n});\n\nexport const AuthorAliasSchema = Type.String({ minLength: 1, maxLength: 64, pattern: '^[a-z][a-z0-9_-]{0,63}$' });\n\n/** Lists canvases or the capabilities of one named canvas. */\nexport const AuthorDescribeToolsInputSchema = Type.Object(\n  { alias: Type.Optional(AuthorAliasSchema) },\n  { additionalProperties: false },\n);\nexport type AuthorDescribeToolsInput = Static<typeof AuthorDescribeToolsInputSchema>;\n\n/** Invokes one capability exposed by the current Author viewport. */\nexport const AuthorUseToolsInputSchema = Type.Object(\n  {\n    alias: Type.Optional(AuthorAliasSchema),\n    catalogToken: Type.String({ minLength: 1, maxLength: 256 }),\n    name: AuthorCapabilityNameSchema,\n    arguments: Type.Record(Type.String(), Type.Unknown()),\n  },\n  { additionalProperties: false },\n);\nexport type AuthorUseToolsInput = Static<typeof AuthorUseToolsInputSchema>;\n\nconst AuthorBridgeBase = {\n  alias: AuthorAliasSchema,\n  generation: Type.Number({ minimum: 0 }),\n};\n\n/** Browser-to-server lease messages, validated before Author sees the payload. */\nexport const AuthorBridgeMessageSchema = Type.Union([\n  Type.Object({ ...AuthorBridgeBase, kind: Type.Literal('register') }, { additionalProperties: false }),\n  Type.Object({ ...AuthorBridgeBase, kind: Type.Literal('release') }, { additionalProperties: false }),\n  Type.Object(\n    {\n      ...AuthorBridgeBase,\n      kind: Type.Literal('catalog'),\n      ownerToken: Type.String({ minLength: 1 }),\n      tools: Type.Array(\n        Type.Object(\n          {\n            name: Type.String({ minLength: 1 }),\n            label: Type.String(),\n            description: Type.String(),\n            inputSchema: Type.Record(Type.String(), Type.Unknown()),\n          },\n          { additionalProperties: false },\n        ),\n      ),\n    },\n    { additionalProperties: false },\n  ),\n  Type.Object(\n    {\n      ...AuthorBridgeBase,\n      kind: Type.Literal('result'),\n      ownerToken: Type.String({ minLength: 1 }),\n      catalogToken: Type.String({ minLength: 1 }),\n      requestId: Type.String({ minLength: 1 }),\n      result: Type.Unknown(),\n    },\n    { additionalProperties: false },\n  ),\n  Type.Object(\n    {\n      ...AuthorBridgeBase,\n      kind: Type.Literal('cancelled'),\n      ownerToken: Type.String({ minLength: 1 }),\n      catalogToken: Type.String({ minLength: 1 }),\n      requestId: Type.String({ minLength: 1 }),\n    },\n    { additionalProperties: false },\n  ),\n]);\n\nexport const AuthorBridgeInputSchema = Type.Object(\n  { sessionId: Type.String({ minLength: 1 }), message: AuthorBridgeMessageSchema },\n  { additionalProperties: false },\n);\n\nexport function authorBridgeMethod(scope: Extract<DoomApiScope, 'global' | 'workspace'>) {\n  return defineDoomPluginMethod({\n    service: 'author.bridge',\n    method: 'send',\n    scope,\n    direction: 'client-to-server',\n    input: AuthorBridgeInputSchema,\n    output: Type.Object({}, { additionalProperties: false }),\n  });\n}\n","import { defineApiContract, jsonApiResponses, type DoomHttpContract } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nimport {\n  AuthorAliasSchema,\n  AuthorBridgeMessageSchema,\n  AuthorBridgeInputSchema,\n  AuthorUseToolsInputSchema,\n} from './authorFacade';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst Json = Type.Unknown({\n  description: 'Runtime author capability value, validated against the capability catalog inputSchema.',\n});\nconst values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Capability = Type.Object({ name: S, label: S, description: S, inputSchema: Type.Record(S, Json) });\nconst Accepted = Type.Object({\n  alias: AuthorAliasSchema,\n  kind: Type.Literal('accepted'),\n  generation: N,\n  ownerToken: S,\n  catalogToken: O(S),\n  leaseMs: N,\n});\nconst Identity = { alias: AuthorAliasSchema, generation: N, ownerToken: S, catalogToken: S, requestId: S };\nconst Request = Type.Object({ kind: Type.Literal('request'), ...Identity, name: S, arguments: Type.Record(S, Json) });\nconst Cancel = Type.Object({ kind: Type.Literal('cancel'), ...Identity });\nexport const AuthorHubMessageSchema = Type.Union([\n  Accepted,\n  Request,\n  Cancel,\n  Type.Object({ alias: AuthorAliasSchema, kind: Type.Literal('rejected'), reason: S }),\n]);\nconst Binding = { alias: AuthorAliasSchema, bindingId: S, generation: Type.Integer({ minimum: 0 }) };\nconst Owner = { ...Binding, ownerToken: S };\nconst ResultIdentity = { ...Owner, catalogToken: S, requestId: S };\nconst Format = values(['markdown-slides', 'csv', 'pptx', 'xlsx']);\nconst Manifest = Type.Object({\n  format: Format,\n  sourceDigest: S,\n  byteLength: N,\n  fragmentCount: N,\n  metadata: Type.Record(S, Type.Union([S, N, B])),\n});\nconst Operation = { fragmentId: S, replacement: S };\nconst Log = Type.Array(Type.Object({ ...Operation, previous: S }));\nconst Document = {\n  path: S,\n  format: Format,\n  operations: O(Type.Array(Type.Object(Operation), { maxItems: 100000 })),\n  csvDialect: O(\n    Type.Object({\n      delimiter: O(values([',', ';', '\\t', '|'])),\n      quote: O(values(['\"', \"'\"])),\n      recordDelimiter: O(values(['\\n', '\\r\\n'])),\n    }),\n  ),\n};\nconst ParsedDocument = Type.Object({\n  manifest: Manifest,\n  fragments: Type.Array(\n    Type.Object({ id: S, kind: values(['slide', 'cell', 'text-run']), text: S, readOnly: O(B), location: S }),\n  ),\n  renderModel: Type.Object({ format: Format, blocks: Type.Array(Type.Object({ id: S, text: S, readOnly: B })) }),\n});\nconst post = (id: string, path: string, schema: object, output: object): DoomHttpContract => ({\n  id,\n  scope: 'session',\n  basePath: 'author',\n  path,\n  method: 'POST',\n  authentication: 'owner',\n  description: `Author ${id}.`,\n  body: { required: true, contentType: 'application/json', schema },\n  responses: jsonApiResponses(output),\n});\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: ['Author capability catalogs supply input JSON Schemas and arbitrary JSON results at runtime.'],\n  http: [\n    {\n      id: 'author.state',\n      scope: 'session',\n      basePath: 'author',\n      path: '/state',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read author activation.',\n      responses: jsonApiResponses(\n        Type.Object({\n          sessionId: Type.Union([S, Type.Null()]),\n          activation: values(['inactive', 'active']),\n          capabilityCount: N,\n        }),\n      ),\n    },\n    post('bridge.register', '/bridge/register', Type.Object(Binding), Accepted),\n    post('bridge.catalog', '/bridge/catalog', Type.Object({ ...Owner, tools: Type.Array(Capability) }), Accepted),\n    post('bridge.next', '/bridge/next', Type.Object(Owner), Type.Union([Request, Cancel])),\n    post(\n      'bridge.result',\n      '/bridge/result',\n      Type.Object({ ...ResultIdentity, result: Json }),\n      Type.Object({ accepted: Type.Literal(true) }),\n    ),\n    post(\n      'bridge.cancelled',\n      '/bridge/cancelled',\n      Type.Object(ResultIdentity),\n      Type.Object({ accepted: Type.Literal(true) }),\n    ),\n    post(\n      'bridge.disconnect',\n      '/bridge/disconnect',\n      Type.Object(Binding),\n      Type.Object({ accepted: Type.Literal(true) }),\n    ),\n    post(\n      'bridge.close',\n      '/bridge/close',\n      Type.Object({ alias: AuthorAliasSchema }),\n      Type.Object({ accepted: Type.Literal(true) }),\n    ),\n    {\n      id: 'bridge.describe',\n      scope: 'session',\n      basePath: 'author',\n      path: '/bridge/describe',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read runtime author capabilities.',\n      responses: jsonApiResponses(\n        Type.Object({\n          catalogToken: S,\n          tools: Type.Array(Capability),\n          canvases: Type.Array(Type.Object({ alias: S, path: S, status: values(['opening', 'ready', 'unavailable']) })),\n        }),\n      ),\n    },\n    post(\n      'bridge.invoke',\n      '/bridge/invoke',\n      AuthorUseToolsInputSchema,\n      Type.Object({ alias: AuthorAliasSchema, catalogToken: S, name: S, result: Json }),\n    ),\n    post(\n      'documents.open',\n      '/documents/open',\n      Type.Object({ ...Document, format: O(Format), alias: O(AuthorAliasSchema) }),\n      Type.Union([\n        Type.Object({\n          path: S,\n          byteLength: N,\n          alias: AuthorAliasSchema,\n          status: values(['opening', 'ready', 'unavailable']),\n          reused: B,\n        }),\n        ParsedDocument,\n      ]),\n    ),\n    post(\n      'documents.preflight',\n      '/documents/preflight',\n      Type.Object(Document),\n      Type.Object({\n        accepted: B,\n        digest: S,\n        sourceDigest: S,\n        operations: Log,\n        issues: Type.Array(Type.Object({ code: S, message: S, fragmentId: O(S) })),\n      }),\n    ),\n    post(\n      'documents.serialize',\n      '/documents/serialize',\n      Type.Object({ ...Document, preflightDigest: S }),\n      Type.Object({ bytes: S, encoding: Type.Literal('base64'), manifest: Manifest, operationLog: Log }),\n    ),\n  ],\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'author.send',\n      scope,\n      service: 'author.bridge',\n      member: 'send',\n      kind: 'method',\n      direction: 'client-to-server',\n      description: 'Scoped author bridge method invoked through po.plugin.v1.',\n      input: AuthorBridgeInputSchema,\n      output: Type.Object({}, { additionalProperties: false }),\n    },\n    {\n      id: 'author.browser',\n      scope,\n      service: 'po.hub.v1',\n      member: 'author_webmcp',\n      kind: 'channel',\n      direction: 'client-to-server',\n      description: 'Browser author channel payload.',\n      input: AuthorBridgeMessageSchema,\n    },\n    {\n      id: 'author.hub',\n      scope,\n      service: 'po.hub.v1',\n      member: 'author_webmcp',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Hub author channel payload.',\n      input: AuthorHubMessageSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.d.ts
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBA+Ea"}