@xemahq/opencode-xema-plugin 0.2.0 → 0.4.0

package/dist/tools/xema-memory.js

@@ -1,157 +0,0 @@
-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-xema-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

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