@xemahq/opencode-xema-plugin 0.1.1

package/dist/tools/xema-memory.js

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { tool } from '../opencode-types.js';
+import { loadSessionStateForTool } from './runtime.js';
+import { serviceTokenAuthorizationHeader } from './service-token.js';
+import { toJsonString } from './shared.js';
+const MEMORY_KINDS = [
+    'GENERAL',
+    'DECISION',
+    'CONSTRAINT',
+    'PATTERN',
+    'LESSON',
+    'EPISODIC',
+    'PROCEDURAL',
+    'CORRECTION',
+];
+const SET_ARGS = {
+    content: z
+        .string()
+        .min(5)
+        .describe('The memory statement. A short fact / preference / lesson phrased as ' +
+        'a complete sentence. Avoid ephemeral context ("just now the user said"); ' +
+        'memory persists across turns.'),
+    kind: z
+        .enum(MEMORY_KINDS)
+        .default('GENERAL')
+        .describe('Kind of memory. Use DECISION for choices made, CONSTRAINT for ' +
+        'hard limits, LESSON for insights from failures, PATTERN for ' +
+        'recurring structures, CORRECTION when overriding a prior memory, ' +
+        'GENERAL otherwise.'),
+    tag: z
+        .string()
+        .optional()
+        .describe('Optional short tag that appears in the originRef so the memory can ' +
+        'later be recalled by the same tag (e.g. "preferences", "style").'),
+    importance: z
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe('1=LOW, 2=NORMAL (default), 3=HIGH, 4=CRITICAL.'),
+};
+const GET_ARGS = {
+    kind: z
+        .enum(MEMORY_KINDS)
+        .optional()
+        .describe('Filter to a specific kind. Omit for all.'),
+    tag: z
+        .string()
+        .optional()
+        .describe('Filter to memories written with this tag. Matches on originRef suffix.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe('Maximum number of memories to return.'),
+};
+function resolveMemoryApiCtx(workspaceDir, toolName) {
+    const state = loadSessionStateForTool(workspaceDir, toolName);
+    const baseUrl = process.env.MEMORY_API_URL?.trim();
+    if (!baseUrl) {
+        throw new Error('MEMORY_API_URL is not configured on this worker. The operator must ' +
+            'set it for xema_memory_* tools to work.');
+    }
+    const project = state.ctx.project;
+    if (!project || !project.projectId) {
+        throw new Error('Session memory requires a projectId in context.json; this session is ' +
+            'not bound to a project (orgId-only). Skip xema_memory_* tools here.');
+    }
+    const sessionId = state.ctx.invocation.sessionId ?? state.ctx.invocation.runId ?? 'no-session';
+    return {
+        baseUrl: baseUrl.replace(/\/+$/, ''),
+        orgId: project.orgId,
+        projectId: project.projectId,
+        actorId: `xema:${state.ctx.invocation.role}`,
+        sessionId,
+        role: state.ctx.invocation.role,
+    };
+}
+function memoryApiHeaders(ctx) {
+    return {
+        'Content-Type': 'application/json',
+        Authorization: serviceTokenAuthorizationHeader(),
+        'x-org-id': ctx.orgId,
+        'x-project-id': ctx.projectId,
+        'x-actor-type': 'agent',
+        'x-actor-id': ctx.actorId,
+    };
+}
+export function buildXemaMemorySetTool(workspaceDir) {
+    return tool({
+        description: 'Persist a project-scoped memory that survives context compaction and ' +
+            'future sessions. Use sparingly — for durable preferences, decisions, ' +
+            'lessons, or patterns worth recalling next time. Do NOT use for ' +
+            'conversational context or task-local notes.',
+        args: SET_ARGS,
+        async execute(args) {
+            const ctx = resolveMemoryApiCtx(workspaceDir, 'xema_memory_set');
+            const originRef = args.tag
+                ? `session:${ctx.sessionId}:${args.tag}`
+                : `session:${ctx.sessionId}`;
+            const body = {
+                content: args.content,
+                type: args.kind ?? 'GENERAL',
+                source: ctx.actorId,
+                originType: 'SESSION',
+                originRef,
+            };
+            if (args.importance !== undefined)
+                body.importance = args.importance;
+            const res = await fetch(`${ctx.baseUrl}/memories`, {
+                method: 'POST',
+                headers: memoryApiHeaders(ctx),
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!res.ok) {
+                const errText = await res.text().catch(() => '');
+                throw new Error(`memory-api rejected write (${res.status}): ${errText.slice(0, 400)}`);
+            }
+            const stored = (await res.json().catch(() => null));
+            return toJsonString({ stored, originRef });
+        },
+    });
+}
+export function buildXemaMemoryGetTool(workspaceDir) {
+    return tool({
+        description: 'Recall project-scoped memories written by earlier sessions or by ' +
+            'xema_memory_set. Returns the most relevant items subject to an ' +
+            'optional kind or tag filter. Read this BEFORE large decisions so ' +
+            'prior lessons and preferences inform the work.',
+        args: GET_ARGS,
+        async execute(args) {
+            const ctx = resolveMemoryApiCtx(workspaceDir, 'xema_memory_get');
+            const params = new URLSearchParams();
+            params.set('limit', String(args.limit ?? 20));
+            if (args.kind)
+                params.set('type', args.kind);
+            if (args.tag)
+                params.set('originRefContains', `:${args.tag}`);
+            const res = await fetch(`${ctx.baseUrl}/memories?${params.toString()}`, {
+                method: 'GET',
+                headers: memoryApiHeaders(ctx),
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!res.ok) {
+                const errText = await res.text().catch(() => '');
+                throw new Error(`memory-api rejected read (${res.status}): ${errText.slice(0, 400)}`);
+            }
+            const raw = (await res.json().catch(() => null));
+            return toJsonString(raw ?? []);
+        },
+    });
+}
+//# sourceMappingURL=xema-memory.js.map

package/dist/tools/xema-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xema-memory.js","sourceRoot":"","sources":["../../src/tools/xema-memory.ts"],"names":[],"mappings":"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"}

package/dist/tools/xema-studio.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare enum StudioKind {
+    Workflow = "workflow",
+    Spec = "spec"
+}
+export declare function buildXemaStudioFetchSchemaTool(workspaceDir: string): import("../opencode-types.js").ToolDefinition<{
+    kind: z.ZodEnum<{
+        workflow: StudioKind.Workflow;
+        spec: StudioKind.Spec;
+    }>;
+}>;
+export declare function buildXemaStudioValidateTool(workspaceDir: string): import("../opencode-types.js").ToolDefinition<{
+    kind: z.ZodEnum<{
+        workflow: StudioKind.Workflow;
+        spec: StudioKind.Spec;
+    }>;
+    rawYaml: z.ZodString;
+    isReusable: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare function buildXemaStudioListExistingArtifactsTool(workspaceDir: string): import("../opencode-types.js").ToolDefinition<{
+    kind: z.ZodEnum<{
+        workflow: StudioKind.Workflow;
+        spec: StudioKind.Spec;
+    }>;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}>;
+//# sourceMappingURL=xema-studio.d.ts.map

package/dist/tools/xema-studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xema-studio.d.ts","sourceRoot":"","sources":["../../src/tools/xema-studio.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AA4HD,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM;;;;;GAoBlE;AAyBD,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM;;;;;;;GAmC/D;AAyDD,wBAAgB,wCAAwC,CAAC,YAAY,EAAE,MAAM;;;;;;;GAqC5E"}

package/dist/tools/xema-studio.js

@@ -0,0 +1,220 @@
+import { z } from 'zod';
+import { tool } from '../opencode-types.js';
+import { loadSessionStateForTool } from './runtime.js';
+import { serviceTokenAuthorizationHeader } from './service-token.js';
+import { toJsonString } from './shared.js';
+export var StudioKind;
+(function (StudioKind) {
+    StudioKind["Workflow"] = "workflow";
+    StudioKind["Spec"] = "spec";
+})(StudioKind || (StudioKind = {}));
+const STUDIO_KINDS = [StudioKind.Workflow, StudioKind.Spec];
+function trimSlash(value) {
+    return value.replace(/\/+$/, '');
+}
+function readEnv(name) {
+    const v = process.env[name]?.trim();
+    if (!v) {
+        throw new Error(`${name} is not configured on this worker. The operator must set it ` +
+            'for xema_studio_* tools to work.');
+    }
+    return v;
+}
+function resolveStudioApiCtx(workspaceDir, toolName) {
+    const state = loadSessionStateForTool(workspaceDir, toolName);
+    const project = state.ctx.project;
+    if (!project || !project.projectId) {
+        throw new Error('xema_studio_* tools require a projectId in context.json; this session ' +
+            'is not bound to a project (orgId-only).');
+    }
+    return {
+        workflowEngineUrl: trimSlash(readEnv('WORKFLOW_ENGINE_API_URL')),
+        deliverableSpecsUrl: trimSlash(readEnv('DELIVERABLE_SPECS_API_URL')),
+        orgId: project.orgId,
+        projectId: project.projectId,
+        actorId: `xema:${state.ctx.invocation.role}`,
+    };
+}
+function studioHeaders(ctx) {
+    return {
+        'Content-Type': 'application/json',
+        Authorization: serviceTokenAuthorizationHeader(),
+        'x-org-id': ctx.orgId,
+        'x-project-id': ctx.projectId,
+        'x-actor-type': 'agent',
+        'x-actor-id': ctx.actorId,
+    };
+}
+function routesFor(kind, ctx) {
+    switch (kind) {
+        case StudioKind.Workflow:
+            return {
+                schema: `${ctx.workflowEngineUrl}/schemas/workflow/v1alpha1/Workflow.json`,
+                validate: `${ctx.workflowEngineUrl}/compiler/preview-raw`,
+                list: `${ctx.workflowEngineUrl}/workflows`,
+            };
+        case StudioKind.Spec:
+            return {
+                schema: `${ctx.deliverableSpecsUrl}/schemas/deliverable/v1/DeliverableSpec.json`,
+                validate: `${ctx.deliverableSpecsUrl}/deliverable-specs/preview-content`,
+                list: `${ctx.deliverableSpecsUrl}/deliverable-specs`,
+            };
+    }
+}
+async function httpJson(url, init, toolName) {
+    const res = await fetch(url, {
+        ...init,
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok) {
+        const errText = await res.text().catch(() => '');
+        throw new Error(`${toolName}: upstream ${res.status} at ${url} — ${errText.slice(0, 400)}`);
+    }
+    try {
+        return (await res.json());
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`${toolName}: upstream 2xx at ${url} returned non-JSON body — ${message}`);
+    }
+}
+const FETCH_SCHEMA_ARGS = {
+    kind: z
+        .enum(STUDIO_KINDS)
+        .describe('Which Studio artifact kind to fetch the live JSON Schema for. ' +
+        '`workflow` → /schemas/workflow/v1alpha1/Workflow.json (engine), ' +
+        '`spec` → /schemas/deliverable/v1/DeliverableSpec.json.'),
+};
+export function buildXemaStudioFetchSchemaTool(workspaceDir) {
+    return tool({
+        description: 'Fetch the live JSON Schema for a Studio artifact kind. Returns the ' +
+            'deterministic schema document published by the owning service so ' +
+            'every proposal cites real field names + enum values, never guessed. ' +
+            'Call this BEFORE proposing YAML so required keys and enum values ' +
+            'come from the live schema, not training data.',
+        args: FETCH_SCHEMA_ARGS,
+        async execute(args) {
+            const ctx = resolveStudioApiCtx(workspaceDir, 'xema_studio_fetch_schema');
+            const routes = routesFor(args.kind, ctx);
+            const schema = await httpJson(routes.schema, { method: 'GET', headers: studioHeaders(ctx) }, 'xema_studio_fetch_schema');
+            return toJsonString({ kind: args.kind, schema });
+        },
+    });
+}
+const VALIDATE_ARGS = {
+    kind: z
+        .enum(STUDIO_KINDS)
+        .describe('Studio artifact kind being validated.'),
+    rawYaml: z
+        .string()
+        .min(1)
+        .describe('Raw YAML body for the artifact. The tool routes to the service-side ' +
+        'compile-preview / preview / preview-content endpoint and reports ' +
+        'the typed result.'),
+    isReusable: z
+        .boolean()
+        .optional()
+        .describe('For `kind="workflow"`, when true selects the reusable-workflow ' +
+        'trigger envelope (`workflow_call`). Ignored for spec.'),
+};
+export function buildXemaStudioValidateTool(workspaceDir) {
+    return tool({
+        description: 'Validate proposed YAML against the live schema + compiler/preview ' +
+            'endpoint BEFORE emitting a StudioAuthorProposal. Returns the typed ' +
+            'compile-preview / validate result so the agent can either correct ' +
+            'errors and retry or include the successful summary in its proposal.',
+        args: VALIDATE_ARGS,
+        async execute(args) {
+            const ctx = resolveStudioApiCtx(workspaceDir, 'xema_studio_validate');
+            const routes = routesFor(args.kind, ctx);
+            let body;
+            if (args.kind === StudioKind.Workflow) {
+                body = {
+                    rawYaml: args.rawYaml,
+                    isReusable: args.isReusable === true,
+                };
+            }
+            else {
+                body = { rawYaml: args.rawYaml };
+            }
+            const result = await httpJson(routes.validate, {
+                method: 'POST',
+                headers: studioHeaders(ctx),
+                body: JSON.stringify(body),
+            }, 'xema_studio_validate');
+            return toJsonString({ kind: args.kind, result });
+        },
+    });
+}
+const LIST_ARGS = {
+    kind: z
+        .enum(STUDIO_KINDS)
+        .describe('Studio artifact kind to list.'),
+    search: z
+        .string()
+        .optional()
+        .describe('Optional case-insensitive substring filter applied to slug + title.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(25)
+        .describe('Maximum entries to return — keep small to save tokens.'),
+};
+function projectListRows(rows) {
+    if (!Array.isArray(rows))
+        return [];
+    const out = [];
+    for (const row of rows) {
+        if (row === null || typeof row !== 'object')
+            continue;
+        const r = row;
+        if (typeof r.slug !== 'string')
+            continue;
+        out.push({
+            slug: r.slug,
+            ...(typeof r.title === 'string' ? { title: r.title } : {}),
+            ...(typeof r.version === 'string' ? { version: r.version } : {}),
+            ...(typeof r.currentVersion === 'string'
+                ? { version: r.currentVersion }
+                : {}),
+            ...(typeof r.source === 'string' ? { source: r.source } : {}),
+        });
+    }
+    return out;
+}
+function matchesSearch(entry, search) {
+    const needle = search.toLowerCase();
+    if (entry.slug.toLowerCase().includes(needle))
+        return true;
+    if (entry.title && entry.title.toLowerCase().includes(needle))
+        return true;
+    return false;
+}
+export function buildXemaStudioListExistingArtifactsTool(workspaceDir) {
+    return tool({
+        description: 'List existing artifacts of a given kind within the active org/project ' +
+            'so the agent can reference them by real slug instead of inventing ' +
+            'names. Returns a slim array of { slug, title, version, source }; ' +
+            'never full bodies. Use this BEFORE suggesting `uses:` actions, ' +
+            '`extends:` chains, or spec refs.',
+        args: LIST_ARGS,
+        async execute(args) {
+            const ctx = resolveStudioApiCtx(workspaceDir, 'xema_studio_list_existing_artifacts');
+            const routes = routesFor(args.kind, ctx);
+            const raw = await httpJson(routes.list, { method: 'GET', headers: studioHeaders(ctx) }, 'xema_studio_list_existing_artifacts');
+            const rows = raw !== null && typeof raw === 'object' && 'data' in raw
+                ? raw.data
+                : raw;
+            let entries = projectListRows(rows);
+            if (args.search && args.search.trim().length > 0) {
+                const filter = args.search.trim();
+                entries = entries.filter((e) => matchesSearch(e, filter));
+            }
+            const limit = args.limit ?? 25;
+            return toJsonString({ kind: args.kind, entries: entries.slice(0, limit) });
+        },
+    });
+}
+//# sourceMappingURL=xema-studio.js.map

package/dist/tools/xema-studio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xema-studio.js","sourceRoot":"","sources":["../../src/tools/xema-studio.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@xemahq/opencode-xema-plugin",
+  "version": "0.1.1",
+  "description": "Opencode plugin providing Xema-namespaced runtime tools (xema_memory_*) and the dynamic system-prompt overlay hook.",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0",
+    "zod": ">=4"
+  },
+  "dependencies": {
+    "@xemahq/kernel-contracts": "^0.2.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.15.10",
+    "@types/node": "25.2.3",
+    "esbuild": "^0.25.4",
+    "typescript": "5.9.3",
+    "zod": "^4.3.6"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test tests/*.test.mjs"
+  }
+}