@xopcai/xopc 0.0.180 → 0.0.188

package/dist/src/agent/tools/composio-tool.js

@@ -1,261 +0,0 @@
-import { consumeConnectorApproval, createConnectorApproval, getConnectorApproval, getConnectorInstallation, listConnectorActionMetadata, listConnectorConnections, listConnectorInstallations, upsertConnectorActionMetadata, upsertConnectorInstallation } from "../../storage/sqlite/connector-repository.js";
-import "../../storage/sqlite/index.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
-import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
-import { ComposioSessionsAdapter } from "../../connectors/composio-sessions.js";
-import { getComposioToolkitScope, isComposioActionAllowedByCatalog, scopeForComposioAction } from "../../connectors/composio.js";
-import { getConnectorDefinition } from "../../connectors/catalog.js";
-import { Type } from "@sinclair/typebox";
-//#region src/agent/tools/composio-tool.ts
-init_session_key();
-const ComposioSearchSchema = Type.Object({
-	query: Type.String({ description: "Describe the task or information you need from connected apps." }),
-	toolkits: Type.Optional(Type.Array(Type.String(), {
-		maxItems: 8,
-		description: "Optional installed app slugs to search."
-	}))
-});
-const ComposioConnectSchema = Type.Object({
-	toolkit: Type.String({ description: "Installed Composio app slug, for example gmail or notion." }),
-	alias: Type.Optional(Type.String({ description: "Optional account label such as Personal or Work." }))
-});
-const ComposioExecuteSchema = Type.Object({
-	actionId: Type.String({ description: "Exact action slug returned by composio_search." }),
-	arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Arguments matching the exact contract returned by composio_search." })),
-	connectionId: Type.Optional(Type.String({ description: "Local connection id when more than one account is connected." })),
-	approvalId: Type.Optional(Type.String({ description: "Approval id after the user explicitly approves a pending write/admin action." }))
-});
-function textResult(value) {
-	return {
-		content: [{
-			type: "text",
-			text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
-		}],
-		details: {}
-	};
-}
-function connectorPrincipalForSession(sessionKey) {
-	const parsed = parseSessionKey(sessionKey);
-	if (!parsed || parsed.source === "cli" || parsed.source === "webchat") return {
-		principalId: "local-owner",
-		agentId: parsed?.agentId,
-		isLocalOwner: true
-	};
-	return {
-		principalId: `channel:${parsed.source}:${parsed.accountId}:${parsed.peerKind}:${parsed.peerId}`,
-		agentId: parsed.agentId,
-		isLocalOwner: false
-	};
-}
-function installedConfigToolkits(config) {
-	return Object.entries(config?.connectors?.instances ?? {}).flatMap(([_instanceId, record]) => {
-		if (!record || typeof record !== "object" || Array.isArray(record)) return [];
-		const row = record;
-		const marker = row.xopcConnector;
-		if (marker && typeof marker === "object" && !Array.isArray(marker) && marker.enabled === false) return [];
-		const connectorId = marker && typeof marker === "object" && !Array.isArray(marker) ? marker.connectorId : void 0;
-		const runtime = row.runtime;
-		if (typeof connectorId !== "string" || !runtime || typeof runtime !== "object" || Array.isArray(runtime) || runtime.type !== "composio" || runtime.role !== "toolkit" || typeof runtime.toolkit !== "string") return [];
-		return [{
-			connectorId,
-			toolkit: runtime.toolkit
-		}];
-	});
-}
-function syncLocalOwnerInstallations(config) {
-	for (const { connectorId, toolkit } of installedConfigToolkits(config)) {
-		const id = `${connectorId}-local-owner`;
-		const existing = getConnectorInstallation(id);
-		upsertConnectorInstallation({
-			id,
-			connectorId,
-			principalId: "local-owner",
-			enabled: true,
-			allowedAgentIds: existing?.allowedAgentIds ?? [],
-			maxScope: getComposioToolkitScope(config, toolkit),
-			confirmationPolicy: existing?.confirmationPolicy ?? "writes",
-			selectedConnectionIds: existing?.selectedConnectionIds ?? [],
-			createdAt: existing?.createdAt
-		});
-	}
-}
-function availableInstallations(deps) {
-	const context = deps.getCurrentContext();
-	const principal = connectorPrincipalForSession(context?.sessionKey);
-	if (principal.isLocalOwner) syncLocalOwnerInstallations(deps.getConfig());
-	const agentId = deps.agentId ?? principal.agentId;
-	const installations = listConnectorInstallations(principal.principalId).filter((installation) => installation.enabled && composioToolkitFromConnectorId(installation.connectorId) !== void 0 && (installation.allowedAgentIds.length === 0 || Boolean(agentId && installation.allowedAgentIds.includes(agentId))));
-	return {
-		principalId: principal.principalId,
-		agentId,
-		context,
-		installations
-	};
-}
-function composioToolkitFromConnectorId(connectorId) {
-	const definition = getConnectorDefinition(connectorId);
-	return definition?.runtime.type === "composio" && definition.runtime.role === "toolkit" ? definition.runtime.toolkit : void 0;
-}
-function toolkitFromInstallation(installation) {
-	const toolkit = composioToolkitFromConnectorId(installation.connectorId);
-	if (!toolkit) throw new Error(`Connector installation is not a Composio toolkit: ${installation.connectorId}`);
-	return toolkit;
-}
-function toolkitForAction(actionId, candidates) {
-	const normalizedAction = actionId.trim().toUpperCase();
-	return [...candidates].sort((left, right) => right.length - left.length).find((toolkit) => normalizedAction === toolkit.toUpperCase() || normalizedAction.startsWith(`${toolkit.toUpperCase()}_`));
-}
-function contractFromSearch(connectorId, toolkit, actionId, value) {
-	const row = value && typeof value === "object" && !Array.isArray(value) ? value : {};
-	const risk = scopeForComposioAction(actionId);
-	return {
-		connectorId,
-		actionId,
-		toolkit,
-		scope: risk.scope,
-		curated: risk.curated,
-		inputSchema: row.inputSchema,
-		cachedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-}
-function createComposioTools(deps) {
-	if (installedConfigToolkits(deps.getConfig()).length === 0) return [];
-	const adapter = deps.adapter ?? new ComposioSessionsAdapter();
-	return [
-		{
-			name: "composio_search",
-			label: "🔎 Connected Apps Search",
-			description: "Discover exact actions and argument contracts for the connected apps allowed in this session. Call this before composio_execute.",
-			parameters: ComposioSearchSchema,
-			async execute(_toolCallId, params) {
-				const available = availableInstallations(deps);
-				const installedToolkits = available.installations.map(toolkitFromInstallation);
-				const requested = params.toolkits?.length ? params.toolkits.map((toolkit) => toolkit.toLowerCase()).filter((toolkit) => installedToolkits.includes(toolkit)) : installedToolkits;
-				if (requested.length === 0) return textResult("No connected apps are allowed for this user and agent.");
-				const result = await (await adapter.createSession({
-					principalId: available.principalId,
-					toolkits: requested
-				})).search({
-					query: params.query,
-					toolkits: requested
-				});
-				let visibleResult = result;
-				if (result && typeof result === "object" && !Array.isArray(result)) {
-					const schemas = result.toolSchemas;
-					if (schemas && typeof schemas === "object" && !Array.isArray(schemas)) {
-						const visibleSchemas = {};
-						for (const [actionId, schema] of Object.entries(schemas)) {
-							const toolkit = toolkitForAction(actionId, requested);
-							if (toolkit && requested.includes(toolkit)) {
-								if (!isComposioActionAllowedByCatalog(actionId)) continue;
-								visibleSchemas[actionId] = schema;
-								const installation = available.installations.find((candidate) => toolkitFromInstallation(candidate) === toolkit);
-								if (installation) upsertConnectorActionMetadata(contractFromSearch(installation.connectorId, toolkit, actionId, schema));
-							}
-						}
-						visibleResult = {
-							...result,
-							toolSchemas: visibleSchemas
-						};
-					}
-				}
-				return textResult(visibleResult);
-			}
-		},
-		{
-			name: "composio_connect",
-			label: "🔐 Connect App Account",
-			description: "Create an authorization link for an installed app. Never claims the connection succeeded until it is checked again.",
-			parameters: ComposioConnectSchema,
-			async execute(_toolCallId, params) {
-				const available = availableInstallations(deps);
-				const toolkit = params.toolkit.trim().toLowerCase();
-				const installation = available.installations.find((candidate) => toolkitFromInstallation(candidate) === toolkit);
-				if (!installation) return textResult("This app is not installed or is not allowed for this user and agent.");
-				const authorization = await adapter.authorize({
-					principalId: available.principalId,
-					toolkit,
-					installationId: installation.id,
-					alias: params.alias
-				});
-				return textResult({
-					status: authorization.status,
-					toolkit,
-					authorizationUrl: authorization.connectUrl,
-					connectionId: authorization.connectionId,
-					instruction: "Ask the user to open the authorization URL. Check the connection again after they finish."
-				});
-			}
-		},
-		{
-			name: "composio_execute",
-			label: "🔌 Connected App Action",
-			description: "Execute an exact action returned by composio_search. Write and admin actions require a user-approved approvalId.",
-			parameters: ComposioExecuteSchema,
-			async execute(_toolCallId, params) {
-				const available = availableInstallations(deps);
-				const toolkit = toolkitForAction(params.actionId, available.installations.map(toolkitFromInstallation));
-				if (!toolkit) return textResult("Unknown toolkit for this action. Call composio_search first.");
-				const installation = available.installations.find((candidate) => toolkitFromInstallation(candidate) === toolkit);
-				if (!installation) return textResult("This app is not allowed for this user and agent.");
-				if (!isComposioActionAllowedByCatalog(params.actionId)) return textResult("This action is not in the connector curated action catalog.");
-				const action = listConnectorActionMetadata(installation.connectorId).find((candidate) => candidate.actionId === params.actionId);
-				if (!action?.inputSchema) return textResult("The exact action contract is not cached. Call composio_search for this task before executing.");
-				await adapter.syncConnections({ principalId: available.principalId }).catch(() => []);
-				const connections = listConnectorConnections({
-					principalId: available.principalId,
-					connectorId: installation.connectorId
-				}).filter((connection) => connection.status === "active");
-				const connection = params.connectionId ? connections.find((candidate) => candidate.id === params.connectionId) : connections.find((candidate) => candidate.isDefault) ?? connections[0];
-				const args = params.arguments ?? {};
-				const argsHash = connectorArgumentsHash(args);
-				let confirmed = false;
-				if (params.approvalId) {
-					const pending = getConnectorApproval(params.approvalId);
-					if (!pending || pending.principalId !== available.principalId || pending.connectorId !== installation.connectorId || pending.actionId !== action.actionId || pending.sessionKey !== available.context?.sessionKey) return textResult("The connector approval is invalid for this session or action.");
-					confirmed = Boolean(consumeConnectorApproval(params.approvalId, argsHash));
-					if (!confirmed) return textResult("The connector approval is not approved, has expired, or was already used.");
-				}
-				const result = await adapter.executeWithPolicy({
-					context: {
-						principalId: available.principalId,
-						toolkits: [toolkit]
-					},
-					installation,
-					connection,
-					action,
-					args,
-					agentId: available.agentId,
-					sessionKey: available.context?.sessionKey,
-					confirmed
-				});
-				if (result.decision === "confirmation_required") {
-					const approval = createConnectorApproval({
-						principalId: available.principalId,
-						connectorId: installation.connectorId,
-						connectionId: connection?.id,
-						agentId: available.agentId,
-						sessionKey: available.context?.sessionKey,
-						actionId: action.actionId,
-						scope: action.scope,
-						argumentsHash: argsHash,
-						argumentsPreview: connectorArgumentsPreview(args),
-						expiresAt: new Date(Date.now() + 10 * 6e4).toISOString()
-					});
-					return textResult({
-						status: "confirmation_required",
-						approvalId: approval.id,
-						actionId: approval.actionId,
-						scope: approval.scope,
-						argumentsPreview: approval.argumentsPreview,
-						expiresAt: approval.expiresAt,
-						instruction: "Ask the user to approve this exact action in xopc, then retry with the approvalId and unchanged arguments."
-					});
-				}
-				return textResult(result.decision === "allowed" ? result.result : result.reason);
-			}
-		}
-	];
-}
-//#endregion
-export { connectorPrincipalForSession, createComposioTools };

package/dist/src/agent/tools/curated-memory-tool.d.ts

@@ -1,3 +0,0 @@
-import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { MemoryManager } from '../memory/manager.js';
-export declare function createCuratedMemoryTool(getMemoryManager: () => MemoryManager): AgentTool;

package/dist/src/agent/tools/curated-memory-tool.js

@@ -1,174 +0,0 @@
-import { Type } from "@sinclair/typebox";
-//#region src/agent/tools/curated-memory-tool.ts
-const CuratedMemorySchema = Type.Object({
-	action: Type.Union([
-		Type.Literal("add"),
-		Type.Literal("propose"),
-		Type.Literal("replace"),
-		Type.Literal("remove"),
-		Type.Literal("read")
-	]),
-	target: Type.Union([Type.Literal("memory"), Type.Literal("user")]),
-	kind: Type.Optional(Type.Union([
-		Type.Literal("user_profile"),
-		Type.Literal("curated_note"),
-		Type.Literal("workspace_fact"),
-		Type.Literal("daily_note"),
-		Type.Literal("session_summary"),
-		Type.Literal("derived_insight"),
-		Type.Literal("task_lesson"),
-		Type.Literal("tool_preference"),
-		Type.Literal("long_term_goal")
-	])),
-	sensitivity: Type.Optional(Type.Union([
-		Type.Literal("normal"),
-		Type.Literal("personal"),
-		Type.Literal("secret"),
-		Type.Literal("regulated")
-	])),
-	confidence: Type.Optional(Type.Number({
-		minimum: 0,
-		maximum: 1
-	})),
-	source_text: Type.Optional(Type.String({ description: "Short evidence excerpt supporting a proposed memory." })),
-	content: Type.Optional(Type.String({ description: "Required for add; new text for replace." })),
-	old_text: Type.Optional(Type.String({ description: "Substring to match one entry for replace/remove." }))
-});
-function createCuratedMemoryTool(getMemoryManager) {
-	return {
-		name: "curated_memory",
-		label: "Curated memory",
-		description: "Read, edit, or propose bounded memory in the shared user store (user/memories/MEMORY.md for curated notes and user/MEMORY.md for the user profile). Use propose when a memory should be reviewed by the user before it becomes active recall context. Entries are separated by a section-sign delimiter (see store format). System prompt shows a frozen snapshot from session start; this tool reads/writes live state on disk. Use add/replace/remove for structured updates; use read to inspect current entries.",
-		parameters: CuratedMemorySchema,
-		async execute(_toolCallId, params, _signal) {
-			const memoryManager = getMemoryManager();
-			const { action, target } = params;
-			try {
-				if (action === "read") {
-					const entries = (await memoryManager.list({ target })).map((record) => record.content);
-					return {
-						content: [{
-							type: "text",
-							text: JSON.stringify({
-								target,
-								entries,
-								count: entries.length
-							}, null, 2)
-						}],
-						details: { entries }
-					};
-				}
-				if (action === "add") {
-					const content = params.content?.trim() ?? "";
-					const result = await memoryManager.write({
-						kind: target === "user" ? "user_profile" : "curated_note",
-						target,
-						content
-					});
-					if (!result.success) return {
-						content: [{
-							type: "text",
-							text: result.error ?? "Unknown error"
-						}],
-						details: { error: result.error }
-					};
-					memoryManager.onMemoryWrite("add", target, content);
-					return {
-						content: [{
-							type: "text",
-							text: result.message ?? "OK"
-						}],
-						details: { success: true }
-					};
-				}
-				if (action === "propose") {
-					const p = params;
-					const content = p.content?.trim() ?? "";
-					const sourceText = p.source_text?.trim();
-					const result = await memoryManager.write({
-						kind: p.kind ?? (target === "user" ? "user_profile" : "curated_note"),
-						target,
-						content,
-						status: "candidate",
-						sensitivity: p.sensitivity ?? (target === "user" ? "personal" : "normal"),
-						confidence: p.confidence,
-						evidence: sourceText ? [{ sourceText }] : void 0
-					});
-					if (!result.success) return {
-						content: [{
-							type: "text",
-							text: result.error ?? "Unknown error"
-						}],
-						details: { error: result.error }
-					};
-					return {
-						content: [{
-							type: "text",
-							text: result.message ?? "Memory candidate added to inbox"
-						}],
-						details: {
-							success: true,
-							recordId: result.record?.id,
-							status: result.record?.status
-						}
-					};
-				}
-				if (action === "replace") {
-					const oldText = params.old_text?.trim() ?? "";
-					const newContent = params.content?.trim() ?? "";
-					const result = await memoryManager.update({
-						target,
-						matchText: oldText,
-						content: newContent
-					});
-					if (!result.success) return {
-						content: [{
-							type: "text",
-							text: result.error ?? "Unknown error"
-						}],
-						details: { error: result.error }
-					};
-					memoryManager.onMemoryWrite("replace", target, newContent);
-					return {
-						content: [{
-							type: "text",
-							text: result.message ?? "OK"
-						}],
-						details: { success: true }
-					};
-				}
-				const oldText = params.old_text?.trim() ?? "";
-				const result = await memoryManager.delete({
-					target,
-					matchText: oldText
-				});
-				if (!result.success) return {
-					content: [{
-						type: "text",
-						text: result.error ?? "Unknown error"
-					}],
-					details: { error: result.error }
-				};
-				memoryManager.onMemoryWrite("remove", target, oldText);
-				return {
-					content: [{
-						type: "text",
-						text: result.message ?? "OK"
-					}],
-					details: { success: true }
-				};
-			} catch (err) {
-				const message = err instanceof Error ? err.message : String(err);
-				return {
-					content: [{
-						type: "text",
-						text: `curated_memory error: ${message}`
-					}],
-					details: { error: message }
-				};
-			}
-		}
-	};
-}
-//#endregion
-export { createCuratedMemoryTool };

package/dist/src/agent/tools/goal-evidence-recorder.d.ts

@@ -1,6 +0,0 @@
-import { type GoalEvidence } from '../../goals/index.js';
-export type GoalEvidenceRecordInput = Pick<GoalEvidence, 'kind' | 'title' | 'summary' | 'uri' | 'data'>;
-export interface GoalEvidenceRecorderOptions {
-    getSessionKey: () => string | undefined;
-}
-export declare function createGoalEvidenceRecorder(options: GoalEvidenceRecorderOptions): (input: GoalEvidenceRecordInput) => Promise<void>;

package/dist/src/agent/tools/goal-evidence-recorder.js

@@ -1,32 +0,0 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
-import { GoalService } from "../../goals/goal-service.js";
-import "../../goals/index.js";
-//#region src/agent/tools/goal-evidence-recorder.ts
-init_logger();
-const log = createLogger("GoalEvidence");
-function createGoalEvidenceRecorder(options) {
-	const goals = new GoalService();
-	return async (input) => {
-		const sessionKey = options.getSessionKey()?.trim();
-		if (!sessionKey) return;
-		const goal = goals.getActiveForSession(sessionKey);
-		if (!goal || goal.status !== "active") return;
-		try {
-			goals.addEvidence({
-				goalId: goal.id,
-				runId: goal.currentRunId,
-				...input
-			});
-		} catch (err) {
-			log.warn({
-				err,
-				sessionKey,
-				goalId: goal.id,
-				kind: input.kind
-			}, `Goal evidence record failed: ${err instanceof Error ? err.message : String(err)}`);
-		}
-	};
-}
-//#endregion
-export { createGoalEvidenceRecorder };

package/dist/src/agent/tools/goal-tool.d.ts

@@ -1,29 +0,0 @@
-import type { AgentTool } from '@earendil-works/pi-agent-core';
-import { type ProductDeliveryEnvelope } from '@xopcai/gateway-contract';
-import { type Goal } from '../../goals/index.js';
-declare const GoalToolSchema: import("@sinclair/typebox").TObject<{
-    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">]>;
-    goalId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"needs_input">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"archived">]>>;
-    priority: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"low">, import("@sinclair/typebox").TLiteral<"normal">, import("@sinclair/typebox").TLiteral<"high">]>>;
-    maxTurns: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    deadlineAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    nextAction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    blockedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    judgeModelRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    agentId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    sessionKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>;
-export interface GoalToolOptions {
-    getCurrentSessionKey?: () => string | undefined;
-}
-type GoalToolDetails = {
-    goal?: Goal;
-    delivery?: ProductDeliveryEnvelope;
-};
-export declare function createGoalTool(options?: GoalToolOptions): AgentTool<typeof GoalToolSchema, GoalToolDetails>;
-export {};

package/dist/src/agent/tools/goal-tool.js

@@ -1,136 +0,0 @@
-import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
-import "../../storage/sqlite/index.js";
-import { GoalService } from "../../goals/goal-service.js";
-import "../../goals/index.js";
-import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
-import { OutcomeExecutionService } from "../../work/outcome-execution-service.js";
-import "../../work/index.js";
-import { Type } from "@sinclair/typebox";
-//#region src/agent/tools/goal-tool.ts
-const GoalToolSchema = Type.Object({
-	action: Type.Union([
-		Type.Literal("list"),
-		Type.Literal("create"),
-		Type.Literal("update")
-	]),
-	goalId: Type.Optional(Type.String({ description: "Goal id for update." })),
-	title: Type.Optional(Type.String({ description: "Goal title for create/update." })),
-	description: Type.Optional(Type.String({ description: "Goal description." })),
-	status: Type.Optional(Type.Union([
-		Type.Literal("active"),
-		Type.Literal("paused"),
-		Type.Literal("blocked"),
-		Type.Literal("needs_input"),
-		Type.Literal("done"),
-		Type.Literal("archived")
-	])),
-	priority: Type.Optional(Type.Union([
-		Type.Literal("low"),
-		Type.Literal("normal"),
-		Type.Literal("high")
-	])),
-	maxTurns: Type.Optional(Type.Number({
-		minimum: 1,
-		maximum: 500
-	})),
-	deadlineAt: Type.Optional(Type.Number({ description: "Unix timestamp in milliseconds." })),
-	nextAction: Type.Optional(Type.String()),
-	blockedReason: Type.Optional(Type.String()),
-	judgeModelRef: Type.Optional(Type.String()),
-	agentId: Type.Optional(Type.String()),
-	sessionKey: Type.Optional(Type.String()),
-	projectId: Type.Optional(Type.String()),
-	limit: Type.Optional(Type.Number({
-		minimum: 1,
-		maximum: 100
-	}))
-});
-function goalDelivery(goal, operation) {
-	return {
-		version: 1,
-		operation,
-		primary: {
-			kind: "goal",
-			id: goal.id,
-			title: goal.title,
-			summary: goal.description?.trim() || goal.nextAction?.trim() || void 0,
-			status: goal.status,
-			revision: String(goal.updatedAt),
-			projectId: goal.projectId ?? void 0,
-			capabilities: [
-				"open",
-				"edit",
-				"continue_in_chat",
-				"pause",
-				"resume"
-			]
-		}
-	};
-}
-function textResult(text, details = {}) {
-	return {
-		content: [{
-			type: "text",
-			text: appendProductDeliveryText(text, details.delivery)
-		}],
-		details
-	};
-}
-function createGoalTool(options = {}) {
-	return {
-		name: "goal",
-		label: "Goal",
-		description: "Create, list, or update durable goals. Use this from workflows when work should become a tracked long-running goal.",
-		parameters: GoalToolSchema,
-		async execute(_toolCallId, params) {
-			const goals = new GoalService();
-			if (params.action === "list") {
-				const rows = goals.list({ limit: Math.max(1, Math.min(100, Math.floor(params.limit ?? 20))) });
-				if (!rows.length) return textResult("No goals.");
-				return textResult(rows.map((g) => `${g.id} [${g.status}] ${g.title}`).join("\n"));
-			}
-			if (params.action === "create") {
-				const title = params.title?.trim();
-				if (!title) return textResult("Error: title is required.");
-				const sessionKey = params.sessionKey?.trim() || options.getCurrentSessionKey?.()?.trim();
-				const projectId = params.projectId?.trim() || (sessionKey ? getSessionMetadata(sessionKey)?.projectId : void 0);
-				const goal = new OutcomeExecutionService().create({
-					objective: title,
-					description: params.description,
-					agentId: params.agentId,
-					sessionKey,
-					projectId,
-					priority: params.priority,
-					deadlineAt: params.deadlineAt,
-					judgeModelRef: params.judgeModelRef,
-					maxTurns: params.maxTurns,
-					source: "workflow"
-				}).goal;
-				return textResult(`Created goal ${goal.id}\n${goal.title}`, {
-					goal,
-					delivery: goalDelivery(goal, "created")
-				});
-			}
-			const goalId = params.goalId?.trim();
-			if (!goalId) return textResult("Error: goalId is required.");
-			let goal = goals.update(goalId, {
-				...params.title !== void 0 ? { title: params.title } : {},
-				...params.description !== void 0 ? { description: params.description } : {},
-				...params.priority !== void 0 ? { priority: params.priority } : {},
-				...params.deadlineAt !== void 0 ? { deadlineAt: params.deadlineAt } : {},
-				...params.maxTurns !== void 0 ? { maxTurns: params.maxTurns } : {},
-				...params.nextAction !== void 0 ? { nextAction: params.nextAction } : {},
-				...params.blockedReason !== void 0 ? { blockedReason: params.blockedReason } : {},
-				...params.judgeModelRef !== void 0 ? { judgeModelRef: params.judgeModelRef } : {}
-			});
-			if (!goal) return textResult(`Goal not found: ${goalId}`);
-			if (params.status) goal = goals.setStatus(goalId, params.status, { reason: params.blockedReason });
-			return textResult(`Updated goal ${goalId}\n${goal?.title ?? ""}`, goal ? {
-				goal,
-				delivery: goalDelivery(goal, "updated")
-			} : {});
-		}
-	};
-}
-//#endregion
-export { createGoalTool };

package/dist/src/chat-commands/builtins/goal.d.ts

@@ -1,4 +0,0 @@
-/**
- * `/goal` — first-class goal control from any command surface.
- */
-export declare function registerGoalCommand(): void;