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

package/dist/src/schemas/httpApiContracts.mjs

@@ -0,0 +1,434 @@
+import { CURRENT_ROUTE, ITEM_ROUTE } from "../constants/contextApi.mjs";
+import { Type } from "typebox";
+//#region src/schemas/httpApiContracts.ts
+const Text = Type.String();
+const Optional = Type.Optional;
+const Strings = Type.Array(Text);
+const Flag = Type.Boolean();
+const NumberValue = Type.Number();
+const ApiErrorSchema = Type.Object({
+	error: Text,
+	hash: Optional(Text)
+});
+const ApiOkSchema = Type.Object({ ok: Type.Literal(true) });
+const Json = Type.Unknown({ description: "Value whose schema is supplied by the selected runtime contribution." });
+/** Common JSON response construction; status and payload remain explicit at the declaration. */
+function jsonApiResponses(schema, status = 200) {
+	return {
+		[status]: {
+			description: "Successful response",
+			contentType: "application/json",
+			schema
+		},
+		"400": {
+			description: "Invalid request",
+			schema: ApiErrorSchema
+		},
+		"401": {
+			description: "Authentication required",
+			schema: ApiErrorSchema
+		},
+		"403": {
+			description: "Request is not authorized",
+			schema: ApiErrorSchema
+		},
+		"404": {
+			description: "Resource or capability unavailable",
+			schema: ApiErrorSchema
+		},
+		"409": {
+			description: "Conflicting state",
+			schema: ApiErrorSchema
+		},
+		"422": {
+			description: "Invalid operation",
+			schema: ApiErrorSchema
+		},
+		"500": {
+			description: "Host operation failed",
+			schema: ApiErrorSchema
+		},
+		"502": {
+			description: "Provider failed",
+			schema: ApiErrorSchema
+		},
+		"503": {
+			description: "Service unavailable",
+			schema: ApiErrorSchema
+		}
+	};
+}
+const WebCompositionSchema = Type.Object({
+	id: Text,
+	scope: Type.Union([
+		Type.Literal("global"),
+		Type.Literal("workspace"),
+		Type.Literal("session")
+	]),
+	revision: NumberValue,
+	manifestUrl: Text,
+	rawAssetBaseUrl: Text,
+	verifiedAssetBaseUrl: Text,
+	pluginEntries: Type.Array(Type.Tuple([Text, Text])),
+	assetPaths: Strings,
+	stylePaths: Strings,
+	channels: Strings
+});
+const NativeCompositionSchema = Type.Object({
+	id: Text,
+	scope: Type.Union([
+		Type.Literal("global"),
+		Type.Literal("workspace"),
+		Type.Literal("session")
+	]),
+	revision: NumberValue,
+	manifestUrl: Text,
+	rawAssetBaseUrl: Text,
+	entryPath: Text,
+	channels: Strings,
+	plugins: Strings
+});
+/** A configured template id and the mount whose compositions offer it. */
+const TemplateDecisionSchema = Type.Object({
+	id: Optional(Text),
+	mount: Type.Union([Type.Object({ scope: Type.Literal("global") }), Type.Object({
+		scope: Type.Literal("workspace"),
+		workspaceId: Text
+	})])
+});
+const SessionSummarySchema = Type.Object({
+	id: Text,
+	workspaceId: Optional(Text),
+	webComposition: Optional(WebCompositionSchema),
+	nativeComposition: Optional(NativeCompositionSchema),
+	name: Text,
+	cwd: Text,
+	createdAt: Text,
+	updatedAt: Text,
+	phase: Type.Union([
+		Type.Literal("idle"),
+		Type.Literal("turn"),
+		Type.Literal("compaction"),
+		Type.Literal("retry")
+	]),
+	phaseSince: Text,
+	attach: Type.Literal("attached"),
+	pendingMessageCount: NumberValue,
+	everPrompted: Flag,
+	awaitingInput: Flag,
+	lastSettledAt: Optional(Text),
+	git: Optional(Type.Object({
+		branch: Text,
+		dirty: Flag
+	})),
+	profile: Optional(Type.Object({
+		name: Text,
+		displayName: Optional(Text),
+		iconVersion: Optional(Text)
+	})),
+	parentSessionId: Optional(Text),
+	sessionProvenance: Optional(Text),
+	/** The line the session's extension published about background work it runs. */
+	activity: Optional(Type.Object({
+		label: Text,
+		attention: Optional(Flag),
+		since: Optional(Text)
+	})),
+	pendingSetups: Optional(Type.Array(Type.Object({
+		id: Text,
+		name: Text,
+		createdAt: Text,
+		cwd: Optional(Text),
+		setupKind: Optional(Type.Union([Type.Literal("managed-worktree"), Type.Literal("existing-directory")])),
+		status: Optional(Type.Union([
+			Type.Literal("provisioning"),
+			Type.Literal("failed"),
+			Type.Literal("interrupted")
+		])),
+		errorCode: Optional(Type.Union([Type.Literal("SESSION_WORKTREE_PROVISION_FAILED"), Type.Literal("SESSION_UNAVAILABLE")]))
+	}))),
+	groups: Optional(Strings),
+	backgroundWorkActive: Optional(Flag),
+	/** Present and true for a recorded session the server has not reopened yet. */
+	dormant: Optional(Flag)
+});
+const WorkspaceSchema = Type.Object({
+	id: Text,
+	root: Text,
+	name: Optional(Text),
+	available: Optional(Flag)
+});
+const SavedSession = Type.Object({
+	id: Text,
+	name: Optional(Text),
+	firstMessage: Text,
+	createdAt: Text,
+	updatedAt: Text
+});
+const query = (name, schema = Text, required = false) => ({
+	name,
+	in: "query",
+	required,
+	schema
+});
+const body = (schema) => ({
+	contentType: "application/json",
+	required: true,
+	schema
+});
+const host = (id, path, method, result, extra = {}) => ({
+	id,
+	path,
+	method,
+	scope: "global",
+	authentication: "owner",
+	description: id,
+	responses: jsonApiResponses(result),
+	...extra
+});
+const Binary = Type.String({ contentEncoding: "binary" });
+host("health", "/api/health", "GET", Type.Object({
+	ok: Type.Literal(true),
+	role: Type.Literal("hub"),
+	protocol: Type.Literal(1),
+	sessions: NumberValue
+}), { authentication: "none" }), host("telemetry.browser", "/api/telemetry/browser", "POST", ApiOkSchema, { body: body(Type.Object({
+	v: Type.Literal(1),
+	events: Type.Array(Type.Object({
+		name: Type.String({ pattern: "^web\\.browser\\.[a-z_]{1,40}$" }),
+		duration_ms: Optional(NumberValue),
+		count: Optional(NumberValue)
+	}), { maxItems: 10 })
+})) }), host("compositions", "/api/compositions", "GET", Type.Object({
+	global: Optional(WebCompositionSchema),
+	nativeGlobal: Optional(NativeCompositionSchema),
+	publicKey: Optional(Text),
+	shell: Optional(Type.Object({
+		publicKey: Text,
+		revision: NumberValue
+	})),
+	template: Optional(TemplateDecisionSchema),
+	/** The phone app's `native.template` choice, resolved the same way. */
+	nativeTemplate: Optional(TemplateDecisionSchema),
+	workspaces: Type.Array(Type.Object({
+		id: Text,
+		root: Text,
+		webComposition: Optional(WebCompositionSchema),
+		nativeComposition: Optional(NativeCompositionSchema)
+	}))
+})), host("directories", "/api/directories", "GET", Type.Object({ directories: Strings }), { parameters: [query("q")] }), host("directories.children", "/api/directories/children", "GET", Type.Object({
+	path: Text,
+	parent: Optional(Text),
+	directories: Strings
+}), { parameters: [query("path")] }), host("directories.po", "/api/directories/po", "GET", Type.Object({ directories: Strings })), host("sessions.list", "/api/workspaces/{workspaceId}/sessions", "GET", Type.Object({ sessions: Type.Array(SessionSummarySchema) })), host("sessions.create", "/api/workspaces/{workspaceId}/sessions", "POST", Type.Object({ sessionId: Text }), {
+	body: body(Type.Object({ name: Optional(Text) })),
+	responses: jsonApiResponses(Type.Object({ sessionId: Text }), 201)
+}), host("sessions.get", "/api/workspaces/{workspaceId}/sessions/{sessionId}", "GET", SessionSummarySchema), host("sessions.delete", "/api/workspaces/{workspaceId}/sessions/{sessionId}", "DELETE", ApiOkSchema), host("sessions.history", "/api/workspaces/{workspaceId}/sessions/{sessionId}/history", "GET", Type.Object({ sessions: Type.Array(SavedSession) }), { availability: "Host provides sessionHistory" }), host("sessions.restart", "/api/workspaces/{workspaceId}/sessions/{sessionId}/restart", "POST", ApiOkSchema, { availability: "Host provides restartSession" }), host("sessions.revive", "/api/workspaces/{workspaceId}/sessions/{sessionId}/revive", "POST", ApiOkSchema, { availability: "Host provides reviveSession" }), host("sessions.resume", "/api/workspaces/{workspaceId}/sessions/{sessionId}/resume", "POST", Type.Object({ sessionId: Text }), {
+	availability: "Host provides resumeSession",
+	body: body(Type.Object({ targetSessionId: Type.String({ pattern: "^[A-Za-z0-9_-]+$" }) }))
+}), host("sessions.file", "/api/workspaces/{workspaceId}/sessions/{sessionId}/file", "GET", Binary, {
+	parameters: [query("path", Text, true)],
+	responses: {
+		...jsonApiResponses(Binary),
+		"200": {
+			description: "File bytes, MIME type follows the file extension",
+			contentType: "*/*",
+			schema: Binary
+		}
+	}
+}), host("workspaces.list", "/api/workspaces", "GET", Type.Object({ workspaces: Type.Array(WorkspaceSchema) })), host("workspaces.admit", "/api/workspaces", "POST", Type.Object({ workspace: WorkspaceSchema }), {
+	body: body(Type.Object({
+		root: Optional(Text),
+		name: Optional(Text)
+	})),
+	responses: jsonApiResponses(Type.Object({ workspace: WorkspaceSchema }), 201)
+}), host("workspaces.get", "/api/workspaces/{workspaceId}", "GET", Type.Object({ workspace: WorkspaceSchema })), host("workspaces.history", "/api/workspaces/{workspaceId}/history", "GET", Type.Object({ sessions: Type.Array(SavedSession) }), { availability: "Host provides workspaceHistory" }), host("workspaces.resume", "/api/workspaces/{workspaceId}/resume", "POST", Type.Object({ sessionId: Text }), {
+	availability: "Host provides resumeWorkspaceSession",
+	body: body(Type.Object({ targetSessionId: Type.String({ pattern: "^[A-Za-z0-9_-]+$" }) }))
+}), host("workspaces.remove", "/api/workspaces/{workspaceId}", "DELETE", ApiOkSchema);
+const AuthType = Type.Union([Type.Literal("api_key"), Type.Literal("oauth")]);
+const Provider = Type.Object({
+	id: Text,
+	name: Text,
+	methods: Type.Array(Type.Object({
+		type: AuthType,
+		label: Text
+	})),
+	authenticated: Optional(Type.Object({
+		type: AuthType,
+		source: Optional(Text)
+	}))
+});
+const LoginEvent = Type.Union([
+	Type.Object({
+		type: Type.Literal("info"),
+		message: Text,
+		links: Optional(Type.Array(Type.Object({
+			url: Text,
+			label: Optional(Text)
+		})))
+	}),
+	Type.Object({
+		type: Type.Literal("auth_url"),
+		url: Text,
+		instructions: Optional(Text)
+	}),
+	Type.Object({
+		type: Type.Literal("device_code"),
+		userCode: Text,
+		verificationUri: Text,
+		intervalSeconds: Optional(NumberValue),
+		expiresInSeconds: Optional(NumberValue)
+	}),
+	Type.Object({
+		type: Type.Literal("progress"),
+		message: Text
+	})
+]);
+const LoginFlowSchema = Type.Object({
+	id: Text,
+	providerId: Text,
+	providerName: Text,
+	type: AuthType,
+	status: Type.Union([
+		Type.Literal("running"),
+		Type.Literal("succeeded"),
+		Type.Literal("failed"),
+		Type.Literal("cancelled")
+	]),
+	events: Type.Array(LoginEvent),
+	prompt: Optional(Type.Object({
+		id: Text,
+		type: Type.Union([
+			Type.Literal("text"),
+			Type.Literal("secret"),
+			Type.Literal("select"),
+			Type.Literal("manual_code")
+		]),
+		message: Text,
+		placeholder: Optional(Text),
+		options: Optional(Type.Array(Type.Object({
+			id: Text,
+			label: Text,
+			description: Optional(Text)
+		})))
+	})),
+	remote: Optional(Flag),
+	error: Optional(Text)
+});
+const Flow = Type.Object({ flow: LoginFlowSchema });
+[
+	host("providers.list", "/providers", "GET", Type.Object({ providers: Type.Array(Provider) })),
+	host("models.list", "/models", "GET", Type.Object({ models: Type.Array(Type.Object({
+		value: Text,
+		label: Text,
+		group: Text
+	})) })),
+	host("providers.logout", "/providers/{providerId}", "DELETE", ApiOkSchema),
+	host("logins.create", "/logins", "POST", Flow, {
+		body: body(Type.Object({
+			providerId: Text,
+			type: AuthType
+		})),
+		responses: jsonApiResponses(Flow, 201)
+	}),
+	host("logins.get", "/logins/{flowId}", "GET", Flow),
+	host("logins.cancel", "/logins/{flowId}", "DELETE", Flow),
+	host("logins.answer", "/logins/{flowId}/answer", "POST", Flow, { body: body(Type.Object({
+		promptId: Text,
+		value: Text
+	})) })
+].map((route) => ({
+	...route,
+	basePath: "po"
+}));
+const Source = Type.Union([
+	Type.Literal("extension"),
+	Type.Literal("mcp"),
+	Type.Literal("plugin"),
+	Type.Literal("core")
+]);
+const Detail = Type.Union([
+	Type.Object({
+		itemKind: Type.Literal("tool"),
+		name: Text,
+		owner: Text,
+		source: Source,
+		active: Flag,
+		tokens: Type.Object({
+			schemaTokens: NumberValue,
+			promptTokens: NumberValue,
+			totalTokens: NumberValue
+		}),
+		description: Optional(Text),
+		promptSnippet: Optional(Text),
+		promptGuidelines: Optional(Strings),
+		parameters: Optional(Json)
+	}),
+	Type.Object({
+		itemKind: Type.Literal("skill"),
+		name: Text,
+		owner: Text,
+		source: Source,
+		active: Type.Literal(true),
+		tokens: NumberValue,
+		description: Text,
+		filePath: Optional(Text),
+		modelInvocable: Flag
+	}),
+	Type.Object({
+		itemKind: Type.Literal("prompt"),
+		name: Type.Literal("system"),
+		tokens: NumberValue,
+		stage: Type.Union([Type.Literal("base"), Type.Literal("effective")]),
+		text: Text
+	})
+]);
+const ContextProjection = Type.Object({
+	version: Type.Literal(1),
+	revision: NumberValue,
+	selection: Type.Object({
+		majorMode: Text,
+		domains: Strings,
+		profile: Optional(Text)
+	}),
+	groups: Type.Array(Type.Object({
+		id: Text,
+		label: Text,
+		kind: Type.Union([
+			Type.Literal("major"),
+			Type.Literal("minor"),
+			Type.Literal("domain"),
+			Type.Literal("core")
+		]),
+		items: Type.Array(Type.Object({
+			name: Text,
+			itemKind: Type.Union([Type.Literal("tool"), Type.Literal("skill")]),
+			source: Source,
+			owner: Text,
+			tokens: NumberValue,
+			active: Flag
+		})),
+		tokens: NumberValue,
+		inactiveTokens: NumberValue
+	})),
+	totalTokens: NumberValue,
+	inactiveTokens: NumberValue,
+	systemPrompt: Optional(Type.Object({
+		tokens: NumberValue,
+		stage: Type.Union([Type.Literal("base"), Type.Literal("effective")])
+	})),
+	estimator: Type.Literal("gpt-tokenizer")
+});
+({ ...host("context.current", CURRENT_ROUTE, "GET", ContextProjection) }), { ...host("context.item", ITEM_ROUTE, "GET", Type.Object({
+	revision: NumberValue,
+	item: Detail
+}), { parameters: [query("kind", Type.Union([
+	Type.Literal("tool"),
+	Type.Literal("skill"),
+	Type.Literal("prompt")
+]), true), query("name", Text, true)] }) }, { ...host("files.complete", "/", "GET", Type.Object({ files: Strings }), { parameters: [query("q", Type.String({ maxLength: 256 }))] }) };
+//#endregion
+export { ApiErrorSchema, ApiOkSchema, LoginFlowSchema, NativeCompositionSchema, SessionSummarySchema, WebCompositionSchema, WorkspaceSchema, jsonApiResponses };
+
+//# sourceMappingURL=httpApiContracts.mjs.map

package/dist/src/schemas/httpApiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpApiContracts.mjs","names":[],"sources":["../../../src/schemas/httpApiContracts.ts"],"sourcesContent":["import { Type, type TSchema } from 'typebox';\n\nimport { API_BASE_PATH, CURRENT_ROUTE, ITEM_ROUTE } from '../constants/contextApi';\nimport type { PoHttpContract } from './apiContracts';\n\nconst Text = Type.String();\nconst Optional = Type.Optional;\nconst Strings = Type.Array(Text);\nconst Flag = Type.Boolean();\nconst NumberValue = Type.Number();\nexport const ApiErrorSchema = Type.Object({ error: Text, hash: Optional(Text) });\nexport const ApiOkSchema = Type.Object({ ok: Type.Literal(true) });\nconst Json = Type.Unknown({ description: 'Value whose schema is supplied by the selected runtime contribution.' });\n\n/** Common JSON response construction; status and payload remain explicit at the declaration. */\nexport function jsonApiResponses(schema: object | boolean, status = 200): PoHttpContract['responses'] {\n  return {\n    [status]: { description: 'Successful response', contentType: 'application/json', schema },\n    '400': { description: 'Invalid request', schema: ApiErrorSchema },\n    '401': { description: 'Authentication required', schema: ApiErrorSchema },\n    '403': { description: 'Request is not authorized', schema: ApiErrorSchema },\n    '404': { description: 'Resource or capability unavailable', schema: ApiErrorSchema },\n    '409': { description: 'Conflicting state', schema: ApiErrorSchema },\n    '422': { description: 'Invalid operation', schema: ApiErrorSchema },\n    '500': { description: 'Host operation failed', schema: ApiErrorSchema },\n    '502': { description: 'Provider failed', schema: ApiErrorSchema },\n    '503': { description: 'Service unavailable', schema: ApiErrorSchema },\n  };\n}\nexport const WebCompositionSchema = Type.Object({\n  id: Text,\n  scope: Type.Union([Type.Literal('global'), Type.Literal('workspace'), Type.Literal('session')]),\n  revision: NumberValue,\n  manifestUrl: Text,\n  rawAssetBaseUrl: Text,\n  verifiedAssetBaseUrl: Text,\n  pluginEntries: Type.Array(Type.Tuple([Text, Text])),\n  assetPaths: Strings,\n  stylePaths: Strings,\n  channels: Strings,\n});\nexport const NativeCompositionSchema = Type.Object({\n  id: Text,\n  scope: Type.Union([Type.Literal('global'), Type.Literal('workspace'), Type.Literal('session')]),\n  revision: NumberValue,\n  manifestUrl: Text,\n  rawAssetBaseUrl: Text,\n  entryPath: Text,\n  channels: Strings,\n  plugins: Strings,\n});\n/** A configured template id and the mount whose compositions offer it. */\nconst TemplateDecisionSchema = Type.Object({\n  id: Optional(Text),\n  mount: Type.Union([\n    Type.Object({ scope: Type.Literal('global') }),\n    Type.Object({ scope: Type.Literal('workspace'), workspaceId: Text }),\n  ]),\n});\nexport const SessionSummarySchema = Type.Object({\n  id: Text,\n  workspaceId: Optional(Text),\n  webComposition: Optional(WebCompositionSchema),\n  nativeComposition: Optional(NativeCompositionSchema),\n  name: Text,\n  cwd: Text,\n  createdAt: Text,\n  updatedAt: Text,\n  phase: Type.Union([Type.Literal('idle'), Type.Literal('turn'), Type.Literal('compaction'), Type.Literal('retry')]),\n  phaseSince: Text,\n  attach: Type.Literal('attached'),\n  pendingMessageCount: NumberValue,\n  everPrompted: Flag,\n  awaitingInput: Flag,\n  lastSettledAt: Optional(Text),\n  git: Optional(Type.Object({ branch: Text, dirty: Flag })),\n  profile: Optional(Type.Object({ name: Text, displayName: Optional(Text), iconVersion: Optional(Text) })),\n  parentSessionId: Optional(Text),\n  sessionProvenance: Optional(Text),\n  /** The line the session's extension published about background work it runs. */\n  activity: Optional(Type.Object({ label: Text, attention: Optional(Flag), since: Optional(Text) })),\n  pendingSetups: Optional(\n    Type.Array(\n      Type.Object({\n        id: Text,\n        name: Text,\n        createdAt: Text,\n        cwd: Optional(Text),\n        setupKind: Optional(Type.Union([Type.Literal('managed-worktree'), Type.Literal('existing-directory')])),\n        status: Optional(\n          Type.Union([Type.Literal('provisioning'), Type.Literal('failed'), Type.Literal('interrupted')]),\n        ),\n        errorCode: Optional(\n          Type.Union([Type.Literal('SESSION_WORKTREE_PROVISION_FAILED'), Type.Literal('SESSION_UNAVAILABLE')]),\n        ),\n      }),\n    ),\n  ),\n  groups: Optional(Strings),\n  backgroundWorkActive: Optional(Flag),\n  /** Present and true for a recorded session the server has not reopened yet. */\n  dormant: Optional(Flag),\n});\nexport const WorkspaceSchema = Type.Object({ id: Text, root: Text, name: Optional(Text), available: Optional(Flag) });\nconst SavedSession = Type.Object({\n  id: Text,\n  name: Optional(Text),\n  firstMessage: Text,\n  createdAt: Text,\n  updatedAt: Text,\n});\nconst query = (\n  name: string,\n  schema: TSchema = Text,\n  required = false,\n): NonNullable<PoHttpContract['parameters']>[number] => ({ name, in: 'query', required, schema });\nconst body = (schema: TSchema): NonNullable<PoHttpContract['body']> => ({\n  contentType: 'application/json',\n  required: true,\n  schema,\n});\nconst host = (\n  id: string,\n  path: string,\n  method: PoHttpContract['method'],\n  result: TSchema,\n  extra: Partial<PoHttpContract> = {},\n): PoHttpContract => ({\n  id,\n  path,\n  method,\n  scope: 'global',\n  authentication: 'owner',\n  description: id,\n  responses: jsonApiResponses(result),\n  ...extra,\n});\nconst Binary = Type.String({ contentEncoding: 'binary' });\nexport const headlessHttpContracts: PoHttpContract[] = [\n  host(\n    'health',\n    '/api/health',\n    'GET',\n    Type.Object({\n      ok: Type.Literal(true),\n      role: Type.Literal('hub'),\n      protocol: Type.Literal(1),\n      sessions: NumberValue,\n    }),\n    { authentication: 'none' },\n  ),\n  host('telemetry.browser', '/api/telemetry/browser', 'POST', ApiOkSchema, {\n    body: body(\n      Type.Object({\n        v: Type.Literal(1),\n        events: Type.Array(\n          Type.Object({\n            name: Type.String({ pattern: '^web\\\\.browser\\\\.[a-z_]{1,40}$' }),\n            duration_ms: Optional(NumberValue),\n            count: Optional(NumberValue),\n          }),\n          { maxItems: 10 },\n        ),\n      }),\n    ),\n  }),\n  host(\n    'compositions',\n    '/api/compositions',\n    'GET',\n    Type.Object({\n      global: Optional(WebCompositionSchema),\n      nativeGlobal: Optional(NativeCompositionSchema),\n      publicKey: Optional(Text),\n      shell: Optional(Type.Object({ publicKey: Text, revision: NumberValue })),\n      template: Optional(TemplateDecisionSchema),\n      /** The phone app's `native.template` choice, resolved the same way. */\n      nativeTemplate: Optional(TemplateDecisionSchema),\n      workspaces: Type.Array(\n        Type.Object({\n          id: Text,\n          root: Text,\n          webComposition: Optional(WebCompositionSchema),\n          nativeComposition: Optional(NativeCompositionSchema),\n        }),\n      ),\n    }),\n  ),\n  host('directories', '/api/directories', 'GET', Type.Object({ directories: Strings }), { parameters: [query('q')] }),\n  host(\n    'directories.children',\n    '/api/directories/children',\n    'GET',\n    Type.Object({ path: Text, parent: Optional(Text), directories: Strings }),\n    { parameters: [query('path')] },\n  ),\n  host('directories.po', '/api/directories/po', 'GET', Type.Object({ directories: Strings })),\n  host(\n    'sessions.list',\n    '/api/workspaces/{workspaceId}/sessions',\n    'GET',\n    Type.Object({ sessions: Type.Array(SessionSummarySchema) }),\n  ),\n  host('sessions.create', '/api/workspaces/{workspaceId}/sessions', 'POST', Type.Object({ sessionId: Text }), {\n    body: body(Type.Object({ name: Optional(Text) })),\n    responses: jsonApiResponses(Type.Object({ sessionId: Text }), 201),\n  }),\n  host('sessions.get', '/api/workspaces/{workspaceId}/sessions/{sessionId}', 'GET', SessionSummarySchema),\n  host('sessions.delete', '/api/workspaces/{workspaceId}/sessions/{sessionId}', 'DELETE', ApiOkSchema),\n  host(\n    'sessions.history',\n    '/api/workspaces/{workspaceId}/sessions/{sessionId}/history',\n    'GET',\n    Type.Object({ sessions: Type.Array(SavedSession) }),\n    { availability: 'Host provides sessionHistory' },\n  ),\n  host('sessions.restart', '/api/workspaces/{workspaceId}/sessions/{sessionId}/restart', 'POST', ApiOkSchema, {\n    availability: 'Host provides restartSession',\n  }),\n  host('sessions.revive', '/api/workspaces/{workspaceId}/sessions/{sessionId}/revive', 'POST', ApiOkSchema, {\n    availability: 'Host provides reviveSession',\n  }),\n  host(\n    'sessions.resume',\n    '/api/workspaces/{workspaceId}/sessions/{sessionId}/resume',\n    'POST',\n    Type.Object({ sessionId: Text }),\n    {\n      availability: 'Host provides resumeSession',\n      body: body(Type.Object({ targetSessionId: Type.String({ pattern: '^[A-Za-z0-9_-]+$' }) })),\n    },\n  ),\n  host('sessions.file', '/api/workspaces/{workspaceId}/sessions/{sessionId}/file', 'GET', Binary, {\n    parameters: [query('path', Text, true)],\n    responses: {\n      ...jsonApiResponses(Binary),\n      '200': { description: 'File bytes, MIME type follows the file extension', contentType: '*/*', schema: Binary },\n    },\n  }),\n  host('workspaces.list', '/api/workspaces', 'GET', Type.Object({ workspaces: Type.Array(WorkspaceSchema) })),\n  host('workspaces.admit', '/api/workspaces', 'POST', Type.Object({ workspace: WorkspaceSchema }), {\n    body: body(Type.Object({ root: Optional(Text), name: Optional(Text) })),\n    responses: jsonApiResponses(Type.Object({ workspace: WorkspaceSchema }), 201),\n  }),\n  host('workspaces.get', '/api/workspaces/{workspaceId}', 'GET', Type.Object({ workspace: WorkspaceSchema })),\n  host(\n    'workspaces.history',\n    '/api/workspaces/{workspaceId}/history',\n    'GET',\n    Type.Object({ sessions: Type.Array(SavedSession) }),\n    {\n      availability: 'Host provides workspaceHistory',\n    },\n  ),\n  host('workspaces.resume', '/api/workspaces/{workspaceId}/resume', 'POST', Type.Object({ sessionId: Text }), {\n    availability: 'Host provides resumeWorkspaceSession',\n    body: body(Type.Object({ targetSessionId: Type.String({ pattern: '^[A-Za-z0-9_-]+$' }) })),\n  }),\n  host('workspaces.remove', '/api/workspaces/{workspaceId}', 'DELETE', ApiOkSchema),\n];\nconst AuthType = Type.Union([Type.Literal('api_key'), Type.Literal('oauth')]);\nconst Provider = Type.Object({\n  id: Text,\n  name: Text,\n  methods: Type.Array(Type.Object({ type: AuthType, label: Text })),\n  authenticated: Optional(Type.Object({ type: AuthType, source: Optional(Text) })),\n});\nconst LoginEvent = Type.Union([\n  Type.Object({\n    type: Type.Literal('info'),\n    message: Text,\n    links: Optional(Type.Array(Type.Object({ url: Text, label: Optional(Text) }))),\n  }),\n  Type.Object({ type: Type.Literal('auth_url'), url: Text, instructions: Optional(Text) }),\n  Type.Object({\n    type: Type.Literal('device_code'),\n    userCode: Text,\n    verificationUri: Text,\n    intervalSeconds: Optional(NumberValue),\n    expiresInSeconds: Optional(NumberValue),\n  }),\n  Type.Object({ type: Type.Literal('progress'), message: Text }),\n]);\nexport const LoginFlowSchema = Type.Object({\n  id: Text,\n  providerId: Text,\n  providerName: Text,\n  type: AuthType,\n  status: Type.Union([\n    Type.Literal('running'),\n    Type.Literal('succeeded'),\n    Type.Literal('failed'),\n    Type.Literal('cancelled'),\n  ]),\n  events: Type.Array(LoginEvent),\n  prompt: Optional(\n    Type.Object({\n      id: Text,\n      type: Type.Union([\n        Type.Literal('text'),\n        Type.Literal('secret'),\n        Type.Literal('select'),\n        Type.Literal('manual_code'),\n      ]),\n      message: Text,\n      placeholder: Optional(Text),\n      options: Optional(Type.Array(Type.Object({ id: Text, label: Text, description: Optional(Text) }))),\n    }),\n  ),\n  remote: Optional(Flag),\n  error: Optional(Text),\n});\nconst Flow = Type.Object({ flow: LoginFlowSchema });\nexport const machineHttpContracts: PoHttpContract[] = [\n  host('providers.list', '/providers', 'GET', Type.Object({ providers: Type.Array(Provider) })),\n  host(\n    'models.list',\n    '/models',\n    'GET',\n    Type.Object({ models: Type.Array(Type.Object({ value: Text, label: Text, group: Text })) }),\n  ),\n  host('providers.logout', '/providers/{providerId}', 'DELETE', ApiOkSchema),\n  host('logins.create', '/logins', 'POST', Flow, {\n    body: body(Type.Object({ providerId: Text, type: AuthType })),\n    responses: jsonApiResponses(Flow, 201),\n  }),\n  host('logins.get', '/logins/{flowId}', 'GET', Flow),\n  host('logins.cancel', '/logins/{flowId}', 'DELETE', Flow),\n  host('logins.answer', '/logins/{flowId}/answer', 'POST', Flow, {\n    body: body(Type.Object({ promptId: Text, value: Text })),\n  }),\n].map((route) => ({ ...route, basePath: 'po' }));\nconst Source = Type.Union([\n  Type.Literal('extension'),\n  Type.Literal('mcp'),\n  Type.Literal('plugin'),\n  Type.Literal('core'),\n]);\nconst Detail = Type.Union([\n  Type.Object({\n    itemKind: Type.Literal('tool'),\n    name: Text,\n    owner: Text,\n    source: Source,\n    active: Flag,\n    tokens: Type.Object({ schemaTokens: NumberValue, promptTokens: NumberValue, totalTokens: NumberValue }),\n    description: Optional(Text),\n    promptSnippet: Optional(Text),\n    promptGuidelines: Optional(Strings),\n    parameters: Optional(Json),\n  }),\n  Type.Object({\n    itemKind: Type.Literal('skill'),\n    name: Text,\n    owner: Text,\n    source: Source,\n    active: Type.Literal(true),\n    tokens: NumberValue,\n    description: Text,\n    filePath: Optional(Text),\n    modelInvocable: Flag,\n  }),\n  Type.Object({\n    itemKind: Type.Literal('prompt'),\n    name: Type.Literal('system'),\n    tokens: NumberValue,\n    stage: Type.Union([Type.Literal('base'), Type.Literal('effective')]),\n    text: Text,\n  }),\n]);\nconst ContextProjection = Type.Object({\n  version: Type.Literal(1),\n  revision: NumberValue,\n  selection: Type.Object({ majorMode: Text, domains: Strings, profile: Optional(Text) }),\n  groups: Type.Array(\n    Type.Object({\n      id: Text,\n      label: Text,\n      kind: Type.Union([Type.Literal('major'), Type.Literal('minor'), Type.Literal('domain'), Type.Literal('core')]),\n      items: Type.Array(\n        Type.Object({\n          name: Text,\n          itemKind: Type.Union([Type.Literal('tool'), Type.Literal('skill')]),\n          source: Source,\n          owner: Text,\n          tokens: NumberValue,\n          active: Flag,\n        }),\n      ),\n      tokens: NumberValue,\n      inactiveTokens: NumberValue,\n    }),\n  ),\n  totalTokens: NumberValue,\n  inactiveTokens: NumberValue,\n  systemPrompt: Optional(\n    Type.Object({\n      tokens: NumberValue,\n      stage: Type.Union([Type.Literal('base'), Type.Literal('effective')]),\n    }),\n  ),\n  estimator: Type.Literal('gpt-tokenizer'),\n});\nexport const sessionHttpContracts: PoHttpContract[] = [\n  {\n    ...host('context.current', CURRENT_ROUTE, 'GET', ContextProjection),\n    scope: 'session',\n    basePath: API_BASE_PATH,\n  },\n  {\n    ...host('context.item', ITEM_ROUTE, 'GET', Type.Object({ revision: NumberValue, item: Detail }), {\n      parameters: [\n        query('kind', Type.Union([Type.Literal('tool'), Type.Literal('skill'), Type.Literal('prompt')]), true),\n        query('name', Text, true),\n      ],\n    }),\n    scope: 'session',\n    basePath: API_BASE_PATH,\n  },\n  {\n    ...host('files.complete', '/', 'GET', Type.Object({ files: Strings }), {\n      parameters: [query('q', Type.String({ maxLength: 256 }))],\n    }),\n    scope: 'session',\n    basePath: 'files',\n  },\n];\n"],"mappings":"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"}

package/dist/src/schemas/hubChannel.cjs

@@ -13,7 +13,10 @@ const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
 * parent. Like a detached helper, it takes no row in the session rail.
 */
 const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
+/** Provenance of a conversation an external MCP client opened and drives. */
+const REMOTE_CONVERSATION_SESSION_PROVENANCE = "remote-conversation";
 //#endregion
+exports.REMOTE_CONVERSATION_SESSION_PROVENANCE = REMOTE_CONVERSATION_SESSION_PROVENANCE;
 exports.WORKFLOW_DISPATCHER_SESSION_PROVENANCE = WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
 exports.WORKFLOW_STEP_SESSION_PROVENANCE = WORKFLOW_STEP_SESSION_PROVENANCE;
 

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

@@ -1 +1 @@
-{"version":3,"file":"hubChannel.cjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["import type { DoomBackgroundWorkSnapshot } from './backgroundWork';\n\nexport interface DoomHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface DoomDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface DoomDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: DoomDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface DoomSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface DoomHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: DoomSessionContext;\n}\n\nexport interface DoomHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type DoomHubReservedWorktreeProvisioner = (\n  request: DoomHubReservedWorktreeRequest,\n) => Promise<DoomHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface DoomHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\nexport interface DoomHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: DoomHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface DoomHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface DoomHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface DoomSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  close(): void;\n}\nexport interface DoomPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/**\n * One short line a session's extension publishes about work it runs for that\n * session, such as a background job. The host shows it on the session's rail\n * card but never interprets it.\n */\nexport interface DoomSessionActivity {\n  readonly label: string;\n  /** The work needs the reader: the rail marks the card the way it marks a pending question. */\n  readonly attention?: boolean;\n  /** ISO 8601 start of the work; the rail appends the elapsed time. */\n  readonly since?: string;\n}\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface DoomHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;\n}\n\n/** Authoritative execution state. Missing background coordination is unknown, not empty. */\nexport interface DoomHubSessionExecutionState {\n  readonly isIdle: boolean;\n  readonly hasPendingMessages: boolean;\n  readonly backgroundWork?: DoomBackgroundWorkSnapshot;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface DoomHubSessionService {\n  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Reads a live child's ownership without starting a turn. */\n  readExecutionState?(\n    sessionId: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<DoomHubSessionExecutionState>;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: DoomHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;\n  /** True only when both live sessions have a direct parent-child relationship. */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;\n}\n\nexport interface DoomHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface DoomComputerUseHostRequest {\n  readonly operation: DoomComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string, headers?: Headers): void;\n  ownsSession?(sessionId: string): boolean;\n  /** Server-authenticated paired identity, checked against live native approval for this session. */\n  authorizeSession?(sessionId: string, headers: Headers): boolean;\n  authorizeRecording?(sessionId: string, headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  /** Own pending activation only, never general session control. */\n  authorizePending?(sessionId: string, headers: Headers): boolean;\n  revokeDevice?(deviceId: string): void;\n  readRecording?(scope: DoomHubSessionScope, artifactId: string, range: string): Promise<Response>;\n  forgetSession?(sessionId: string): void;\n  subscribe?(listener: () => void, sessionId?: string): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface DoomComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  authorizeRecording?(headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  authorizePending?(headers: Headers): boolean;\n  claim(headers?: Headers): void;\n  fetchRecording?(artifactId: string, range: string): Promise<Response>;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface DoomHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n  /** Live session authorization evaluated by the host, never a client frame. */\n  computerUseAuthorized?: boolean;\n}\n\nexport interface DoomHubChannelHost {\n  sessions(): readonly DoomHubSessionScope[];\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: DoomHubSessionService;\n  /** Same-process events emitted by session facets. */\n  readonly directEvents: DoomDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;\n  computerUse?: DoomComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface DoomHubChannelSource {\n  payloadFor(scope: DoomHubSessionScope): unknown;\n  sessionAdded?(scope: DoomHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;\n  close(): void;\n}\n\nexport type DoomHubChannelLifecycle = 'session' | 'hub';\n\nexport interface DoomHubChannel {\n  frameType: string;\n  lifecycle?: DoomHubChannelLifecycle;\n  start(host: DoomHubChannelHost): DoomHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;\n  disconnected?(connection: DoomHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAmFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC"}
+{"version":3,"file":"hubChannel.cjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["import type { PoBackgroundWorkSnapshot } from './backgroundWork';\nimport type { HomeProjection } from './home';\nimport type { PoSessionStorageService } from './platform';\n\nexport interface PoHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface PoDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface PoDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: PoDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface PoSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface PoHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: PoSessionContext;\n}\n\nexport interface PoHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type PoHubReservedWorktreeProvisioner = (request: PoHubReservedWorktreeRequest) => Promise<PoHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface PoHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\n/** Provenance of a conversation an external MCP client opened and drives. */\nexport const REMOTE_CONVERSATION_SESSION_PROVENANCE = 'remote-conversation';\n\nexport interface PoHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: PoHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface PoHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface PoHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface PoSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  /** Current human-readable session name, read live so renames are reflected. */\n  readonly sessionName?: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  /** Describes a live peer authorized to communicate, including same-checkout peers. */\n  describePeer?(peerSessionId: string): PoSessionPeerDescription | undefined;\n  close(): void;\n}\n\n/** How a session sees a peer it may message, so an agent can address it by the name a person uses. */\nexport interface PoSessionPeerDescription {\n  readonly sessionId: string;\n  readonly name: string;\n  readonly profile?: string;\n  /** Groups both sessions belong to; empty when related through parentage or checkout. */\n  readonly sharedGroups: readonly string[];\n}\nexport interface PoPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/**\n * One short line a session's extension publishes about work it runs for that\n * session, such as a background job. The host shows it on the session's rail\n * card but never interprets it.\n */\nexport interface PoSessionActivity {\n  readonly label: string;\n  /** The work needs the reader: the rail marks the card the way it marks a pending question. */\n  readonly attention?: boolean;\n  /** ISO 8601 start of the work; the rail appends the elapsed time. */\n  readonly since?: string;\n}\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface PoHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<PoHubSessionScope>;\n}\n\n/** Authoritative execution state. Missing background coordination is unknown, not empty. */\nexport interface PoHubSessionExecutionState {\n  readonly isIdle: boolean;\n  readonly hasPendingMessages: boolean;\n  readonly backgroundWork?: PoBackgroundWorkSnapshot;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface PoHubSessionService {\n  create(request: PoHubSessionCreateRequest): Promise<PoHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Reads a live child's ownership without starting a turn. */\n  readExecutionState?(\n    sessionId: string,\n    options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<PoHubSessionExecutionState>;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: PoHubSessionPromptOptions): Promise<PoHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: PoHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: PoHubReservedWorktreeRequest): Promise<PoHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: PoHubReservedWorktreeProvisioner): () => void;\n  /**\n   * True when both live sessions have a direct parent-child relationship, or execute in the same\n   * checkout. Remote conversations only qualify through the parent-child relationship.\n   */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): PoSessionCommunicationEndpoint;\n}\n\nexport interface PoHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type PoComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface PoComputerUseHostRequest {\n  readonly operation: PoComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface PoComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: PoHubSessionScope, request: PoComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string, headers?: Headers): void;\n  ownsSession?(sessionId: string): boolean;\n  /** Server-authenticated paired identity, checked against live native approval for this session. */\n  authorizeSession?(sessionId: string, headers: Headers): boolean;\n  authorizeRecording?(sessionId: string, headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  /** Own pending activation only, never general session control. */\n  authorizePending?(sessionId: string, headers: Headers): boolean;\n  revokeDevice?(deviceId: string): void;\n  readRecording?(scope: PoHubSessionScope, artifactId: string, range: string): Promise<Response>;\n  forgetSession?(sessionId: string): void;\n  /** Without `sessionId` the listener hears every session's ownership change. */\n  subscribe?(listener: () => void, sessionId?: string): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface PoComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  authorizeRecording?(headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  authorizePending?(headers: Headers): boolean;\n  claim(headers?: Headers): void;\n  fetchRecording?(artifactId: string, range: string): Promise<Response>;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface PoHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n  /** Live session authorization evaluated by the host, never a client frame. */\n  computerUseAuthorized?: boolean;\n}\n\nexport interface PoHubChannelHost {\n  sessions(): readonly PoHubSessionScope[];\n  /** Host facts and storage for trusted in-process channels, never client-supplied roots. */\n  readonly homeDirectory?: string;\n  readonly sessionStorage?: PoSessionStorageService;\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: PoHubSessionService;\n  /** Same-process events emitted by session packages. */\n  readonly directEvents: PoDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: PoHubSessionScope, request: PoHubSessionApiRequest): Promise<Response>;\n  computerUse?: PoComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface PoHubChannelSource {\n  payloadFor(scope: PoHubSessionScope): unknown;\n  /** Read-only compact projection of already-owned state. Must not start work or add watchers. */\n  homeFor?(scope: PoHubSessionScope): HomeProjection;\n  sessionAdded?(scope: PoHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  close(): void;\n}\n\nexport type PoHubChannelLifecycle = 'session' | 'hub';\n\nexport interface PoHubChannel {\n  frameType: string;\n  lifecycle?: PoHubChannelLifecycle;\n  start(host: PoHubChannelHost): PoHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: PoHubSessionScope, payload: unknown, connection: PoHubChannelConnection): void;\n  disconnected?(connection: PoHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAmFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC;;AAGtD,MAAa,yCAAyC"}