@xopcai/xopc 0.0.150 → 0.0.152

package/dist/src/agent/tools/xopc-use-tool.js

@@ -2,6 +2,7 @@ import { runWithActivityContext } from "../../activity/context.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import "../../activity/index.js";
+import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { Type } from "@sinclair/typebox";
@@ -10,9 +11,11 @@ const XopcUseToolSchema = Type.Object({
 	mode: Type.Union([
 		Type.Literal("project"),
 		Type.Literal("note"),
-		Type.Literal("work_item")
+		Type.Literal("work_item"),
+		Type.Literal("local_app"),
+		Type.Literal("settings")
 	]),
-	command: Type.String({ description: "Object command. Supports project list/get/create/update/resolve_workspace, note list/get/create/append/update/preview_edit, and work_item list/get/create/update." }),
+	command: Type.String({ description: "Object command. Supports project list/get/create/update/resolve_workspace, note list/get/create/append/update/preview_edit, work_item list/get/create/update, local_app list/get/create/validate, and settings open." }),
 	args: Type.Optional(Type.Record(Type.String(), Type.Any())),
 	dryRun: Type.Optional(Type.Boolean({ description: "Validate and preview the action without mutating xopc state." }))
 });
@@ -56,7 +59,7 @@ function okText(details) {
 	return {
 		content: [{
 			type: "text",
-			text: JSON.stringify(details.result ?? {}, null, 2)
+			text: appendProductDeliveryText(JSON.stringify(details.result ?? {}, null, 2), details.delivery)
 		}],
 		details
 	};
@@ -113,6 +116,120 @@ function nullableNumber(value) {
 function ensureArgs(input) {
 	return input.args && typeof input.args === "object" && !Array.isArray(input.args) ? input.args : {};
 }
+function record(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function deliveryText(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function deliveryRevision(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return String(value);
+	return deliveryText(value);
+}
+function deliverySummary(...values) {
+	const value = values.map(deliveryText).find(Boolean);
+	if (!value) return void 0;
+	return value.length > 180 ? `${value.slice(0, 177)}…` : value;
+}
+function deliveryForXopcResult(mode, command, result, dryRun) {
+	if (dryRun || command === "list") return void 0;
+	const resultRecord = record(result);
+	if (!resultRecord || resultRecord.ok === false) return void 0;
+	let source;
+	let primary;
+	if (mode === "project") {
+		const match = record(resultRecord.match);
+		source = record(resultRecord.project) ?? record(match?.project) ?? match;
+		const id = deliveryText(source?.id);
+		if (id) primary = {
+			kind: "project",
+			id,
+			title: deliveryText(source?.name) ?? "Project",
+			summary: deliverySummary(source?.description, source?.brief),
+			status: deliveryText(source?.status),
+			revision: deliveryRevision(source?.updatedAt),
+			capabilities: [
+				"open",
+				"edit",
+				"continue_in_chat"
+			]
+		};
+	} else if (mode === "note") {
+		source = record(resultRecord.note);
+		const id = deliveryText(source?.id);
+		if (id) primary = {
+			kind: "note",
+			id,
+			title: deliveryText(source?.title) ?? "Untitled note",
+			summary: deliverySummary(source?.markdown),
+			status: deliveryText(source?.status),
+			revision: deliveryRevision(source?.localVersion) ?? deliveryRevision(source?.updatedAt),
+			capabilities: [
+				"open",
+				"preview",
+				"edit",
+				"continue_in_chat",
+				"share"
+			]
+		};
+	} else if (mode === "work_item") {
+		source = record(resultRecord.item);
+		const id = deliveryText(source?.id);
+		if (id) primary = {
+			kind: "work_item",
+			id,
+			title: deliveryText(source?.title) ?? "Work item",
+			summary: deliverySummary(source?.description, source?.nextAction),
+			status: deliveryText(source?.status),
+			revision: deliveryRevision(source?.updatedAt),
+			projectId: deliveryText(source?.projectId),
+			capabilities: [
+				"open",
+				"edit",
+				"continue_in_chat"
+			]
+		};
+	} else if (mode === "local_app") {
+		source = record(resultRecord.app);
+		const id = deliveryText(source?.id);
+		if (id) primary = {
+			kind: "local_app",
+			id,
+			title: deliveryText(source?.name) ?? "Local app",
+			summary: deliverySummary(source?.description, source?.idea),
+			status: deliveryText(source?.installationState) ?? deliveryText(source?.status),
+			revision: deliveryRevision(source?.updatedAt),
+			projectId: deliveryText(source?.projectId),
+			capabilities: [
+				"open",
+				"preview",
+				"edit",
+				"continue_in_chat",
+				"run"
+			]
+		};
+	} else {
+		source = record(resultRecord.settings);
+		const id = deliveryText(source?.section);
+		if (id) primary = {
+			kind: "settings",
+			id,
+			title: deliveryText(source?.title) ?? "Settings",
+			summary: deliverySummary(source?.summary),
+			capabilities: [
+				"open",
+				"configure",
+				"continue_in_chat"
+			]
+		};
+	}
+	if (!primary) return void 0;
+	return {
+		version: 1,
+		operation: command === "create" ? "created" : command === "get" || command === "resolve_workspace" || mode === "settings" ? "opened" : command === "validate" ? "completed" : "updated",
+		primary
+	};
+}
 function currentProjectId(args, deps) {
 	const explicit = trimString(args.projectId);
 	if (explicit) return explicit;
@@ -578,11 +695,103 @@ async function handleWorkItem(command, args, deps, dryRun) {
 		error: `Unsupported work_item command: ${command}`
 	};
 }
+async function handleLocalApp(command, args, deps, dryRun) {
+	const localApps = deps.getLocalAppService?.();
+	if (!localApps) return {
+		ok: false,
+		error: "Local app service is unavailable"
+	};
+	if (command === "list") return {
+		ok: true,
+		apps: localApps.list()
+	};
+	const id = trimString(args.localAppId) ?? trimString(args.id);
+	if (command === "get") {
+		if (!id) return {
+			ok: false,
+			error: "localAppId is required"
+		};
+		const app = localApps.get(id);
+		return app ? {
+			ok: true,
+			app
+		} : {
+			ok: false,
+			error: `Local app not found: ${id}`
+		};
+	}
+	if (command === "create") {
+		const name = trimString(args.name);
+		const idea = trimString(args.idea);
+		if (!name) return {
+			ok: false,
+			error: "name is required"
+		};
+		if (!idea) return {
+			ok: false,
+			error: "idea is required"
+		};
+		const input = {
+			name,
+			idea,
+			description: trimString(args.description)
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "create_local_app",
+			input
+		};
+		return {
+			ok: true,
+			app: localApps.create(input)
+		};
+	}
+	if (command === "validate") {
+		if (!id) return {
+			ok: false,
+			error: "localAppId is required"
+		};
+		const app = localApps.get(id);
+		if (!app) return {
+			ok: false,
+			error: `Local app not found: ${id}`
+		};
+		return {
+			ok: true,
+			app,
+			validation: localApps.validate(id)
+		};
+	}
+	return {
+		ok: false,
+		error: `Unsupported local_app command: ${command}`
+	};
+}
+function handleSettings(command, args) {
+	if (command !== "open") return {
+		ok: false,
+		error: `Unsupported settings command: ${command}`
+	};
+	const section = trimString(args.section) ?? "overview";
+	if (!/^[a-z0-9][a-z0-9/_-]*$/i.test(section) || section.includes("..")) return {
+		ok: false,
+		error: "Invalid settings section"
+	};
+	return {
+		ok: true,
+		settings: {
+			section,
+			title: trimString(args.title) ?? "Settings",
+			summary: trimString(args.summary)
+		}
+	};
+}
 function createXopcUseTool(deps) {
 	return {
 		name: "xopc_use",
 		label: "XOPC Use",
-		description: "Operate first-class xopc objects through one safe entry point. Use for projects, notes, and project work items instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
+		description: "Operate first-class xopc objects through one safe entry point. Use for projects, notes, project work items, local apps, and exact settings jump targets instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
 		parameters: XopcUseToolSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
@@ -616,13 +825,14 @@ function createXopcUseTool(deps) {
 						kind: "xopc_use",
 						toolCallId
 					}
-				}, async () => mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "work_item" ? await handleWorkItem(command, args, deps, dryRun) : {
+				}, async () => mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "work_item" ? await handleWorkItem(command, args, deps, dryRun) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "settings" ? handleSettings(command, args) : {
 					ok: false,
 					error: `Unsupported mode: ${String(mode)}`
 				});
 				return okText({
 					...details,
-					result
+					result,
+					delivery: deliveryForXopcResult(mode, command, result, dryRun)
 				});
 			} catch (err) {
 				return errorText(err instanceof Error ? err.message : String(err), details);

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/gateway/agents-admin.js

@@ -1,5 +1,5 @@
-import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
+import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths, resolveUserProfilePath } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";

package/dist/src/gateway/hono/routes/status.d.ts

@@ -1,3 +1,11 @@
 import type { Hono } from 'hono';
 import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function buildEvalRuntimeIdentity(service: AuthenticatedRouteDeps['service'], agentId: string): {
+    ok: true;
+    payload: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+};
 export declare function registerStatusRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void;

package/dist/src/gateway/hono/routes/status.js

@@ -2,8 +2,62 @@ import { getDefaultModelSync, init_providers, resolveModel } from "../../../prov
 import { isSTTAvailable } from "../../../voice/stt/availability.js";
 import "../../../voice/stt/index.js";
 import { mergeSttConfigFromAppConfig } from "../../../channels/attachments/voice-stt-webchat.js";
+import { getGatewayAgentEffectiveManifest } from "../../agents-admin.js";
+import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/status.ts
 init_providers();
+function stableValue(value) {
+	if (Array.isArray(value)) return value.map(stableValue);
+	if (!value || typeof value !== "object") return value;
+	return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, child]) => [key, stableValue(child)]));
+}
+function contentHash(value) {
+	return createHash("sha256").update(JSON.stringify(stableValue(value))).digest("hex");
+}
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function buildEvalRuntimeIdentity(service, agentId) {
+	const config = service.currentConfig;
+	if (!config) return {
+		ok: false,
+		error: "Gateway configuration is unavailable",
+		status: 503
+	};
+	const effective = getGatewayAgentEffectiveManifest(config, agentId);
+	if ("error" in effective) return {
+		ok: false,
+		error: effective.error,
+		status: effective.status ?? 400
+	};
+	const manifest = asRecord(effective.data.manifest);
+	const models = asRecord(manifest.models);
+	const tools = asRecord(manifest.tools);
+	const skills = manifest.skills ?? [];
+	const codeIntelligence = config.codeIntelligence;
+	return {
+		ok: true,
+		payload: {
+			schemaVersion: 1,
+			version: service.getHealth().version,
+			buildCommit: process.env.XOPC_BUILD_COMMIT?.trim() || process.env.GITHUB_SHA?.trim() || null,
+			agentId,
+			modelRef: models.primary ?? null,
+			thinkingLevel: manifest.thinkingDefault ?? null,
+			manifestHash: contentHash(effective.data.manifest),
+			systemPromptConfigHash: contentHash(manifest.systemPrompt ?? null),
+			toolPolicyHash: contentHash(tools),
+			skillPolicyHash: contentHash(skills),
+			codeIntelligence: {
+				enabled: codeIntelligence?.enabled === true,
+				configuredForAgent: codeIntelligence?.agentIds?.includes(agentId) === true,
+				indexMode: codeIntelligence?.indexMode ?? null,
+				configHash: contentHash(codeIntelligence ?? null)
+			},
+			presetChain: effective.data.sources
+		}
+	};
+}
 function isRefineAvailable(config) {
 	if (!config) return false;
 	for (const candidate of [
@@ -53,6 +107,22 @@ function registerStatusRoutes(authenticated, deps) {
 	const handler = (c) => c.json(buildStatusPayload(service));
 	authenticated.get("/status", handler);
 	authenticated.get("/api/status", handler);
+	authenticated.get("/api/eval/runtime-identity", (c) => {
+		const agentId = c.req.query("agentId")?.trim();
+		if (!agentId) return c.json({
+			ok: false,
+			error: "agentId is required"
+		}, 400);
+		const result = buildEvalRuntimeIdentity(service, agentId);
+		if ("error" in result) {
+			const status = result.status === 404 ? 404 : result.status === 503 ? 503 : 400;
+			return c.json({
+				ok: false,
+				error: result.error
+			}, status);
+		}
+		return c.json(result);
+	});
 	/**
 	* POST /api/gateway/restart — respawn gateway process when supported (foreground `xopc gateway`).
 	*/
@@ -70,4 +140,4 @@ function registerStatusRoutes(authenticated, deps) {
 	});
 }
 //#endregion
-export { registerStatusRoutes };
+export { buildEvalRuntimeIdentity, registerStatusRoutes };

package/dist/src/gateway/service.js

@@ -318,6 +318,7 @@ var GatewayService = class {
 			getNotesService: () => this.notesService,
 			getProjectService: () => this.projects,
 			getWorkItemService: () => new WorkItemService(),
+			getLocalAppService: () => this.localApps,
 			getWorkflowRunService: () => this.createWorkflowRunService(),
 			sourceContextResolver: async (binding) => {
 				if (binding.kind === "note") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.150",
+  "version": "0.0.152",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -103,7 +103,8 @@
     "undici": "^8.5.0",
     "uuid": "^14.0.0",
     "ws": "^8.21.0",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@xopcai/gateway-contract": "0.0.0"
   },
   "peerDependencies": {
     "@composio/core": "0.14.0",
@@ -218,6 +219,14 @@
     "test:startup:gateway": "node --import tsx scripts/bench-gateway-startup.ts",
     "test:startup:gateway:check": "node --import tsx scripts/bench-gateway-startup.ts --runs 2 --warmup 0 --ready-budget-ms 20000",
     "test:startup:imports": "node scripts/check-cli-bootstrap-imports.mjs",
+    "eval:coder": "tsx evals/coder/apps/cli/src/main.ts",
+    "eval:coder:check": "pnpm -C evals/coder run check",
+    "eval:coder:smoke": "pnpm -C evals/coder run smoke",
+    "eval:coder:web": "tsx evals/coder/apps/web/src/server.ts",
+    "eval:coder:xopc:prepare": "tsx evals/coder/scripts/prepare-xopc-cbm-config.ts",
+    "eval:coder:xopc:pilot-checks": "tsx evals/coder/scripts/check-xopc-cbm-hidden.ts",
+    "eval:coder:xopc:fixture-check": "tsx evals/coder/scripts/check-xopc-cbm-fixtures.ts",
+    "eval:coder:github:experiment": "tsx evals/coder/scripts/prepare-github-experiment.ts",
     "tunnel:broker-tls:verify": "node scripts/tunnel-broker-tls-verify.mjs",
     "release:patch": "bash scripts/release-patch.sh",
     "growth:snapshot": "node scripts/growth-snapshot.mjs",