@xemahq/opencode-xema-plugin 0.1.5 → 0.1.8

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,220 +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';
-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

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

package/src/context.ts

@@ -1,154 +0,0 @@
-// ═══════════════════════════════════════════════════════════════════════════
-// ── /workspace/context.json reader ──
-// Read once per tool/hook invocation. Surfaces invocation identity (role,
-// surface, runId, sessionId) and the per-invocation `authority` block to
-// the plugin's tools and the system-prompt overlay hook.
-// ═══════════════════════════════════════════════════════════════════════════
-
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { z } from 'zod';
-
-import { warn } from './logger.js';
-
-const ContextJsonSchema = z.object({
-  invocation: z.object({
-    runId: z.string().nullable().optional(),
-    sessionId: z.string().nullable().optional(),
-    attempt: z.number().int().min(1).default(1),
-    role: z.enum([
-      'unit-worker',
-      'coordinator',
-      'gate-reviewer',
-      'clarification-coordinator',
-      'scope-validator',
-      'agent-session',
-      'design-system-builder',
-      'engineer',
-      'generic-agent',
-      'auditor',
-      // Document Buddy: agent collaborates on a single KB document page
-      // by editing a real working file (`/workspace/document/<slug>.<ext>`)
-      // natively; workspace-proxy's document-sync component derives the
-      // reviewable change set from those edits.
-      'document',
-    ]),
-    surface: z
-      .enum(['pipeline-run', 'agent-session', 'design-system-builder', 'gate-review'])
-      .optional(),
-  }),
-  project: z
-    .object({
-      orgId: z.string(),
-      projectId: z.string().nullish(),
-      // Pipeline invocations outside a run (interactive sessions,
-      // brainstorming, gate reviews not tied to a specific branch)
-      // emit `pipelineBranch: null` — distinct from "absent". Accept
-      // both null and undefined here so the context validation survives.
-      pipelineBranch: z.string().nullish(),
-    })
-    .nullish(),
-  authority: z.object({
-    mayWriteWorkspace: z.array(z.string()).default(['/workspace/deliverables']),
-    mayWriteSlugs: z.array(z.string()).default([]),
-    mayWriteKnowledgeBase: z.boolean().default(true),
-    mayEditRepos: z.boolean().default(false),
-    writePolicy: z.enum(['read-only', 'own-pages-only', 'full-write']),
-    /**
-     * Closed list of Xema-namespaced tool names this invocation may call.
-     * Resolved from the `RoleCapabilityProfile` for `invocation.role` by
-     * llm-registry-api's `agent-run-context.service.ts` and written into
-     * context.json verbatim. `session-state.ensureRoleAllowed` checks
-     * every Xema tool call against this list — no fallback to a per-role
-     * registry baked into the plugin.
-     */
-    allowedXemaTools: z.array(z.string()).min(1),
-  }),
-  /**
-   * Optional `git` block consumed by the `session.idle` auto-commit hook
-   * (see `hooks/session-idle-autocommit.ts`). Written by the orchestrator
-   * when the session's `BranchMode` opts into per-turn auto-commit
-   * (`shared_dev_publish_to_prod` — the default). Absent / `disabled` for
-   * `branch_per_session` sessions, where commits are user-controlled.
-   *
-   * `repoSubPath` is the working repo's path relative to the workspace
-   * root. When omitted, the hook commits at the workspace root itself
-   * (single-repo workspace contract — multi-repo workspaces are handled
-   * by a future follow-up; see TODO(multi-repo) in the
-   * hook).
-   */
-  git: z
-    .object({
-      autoCommit: z.enum(['enabled', 'disabled']),
-      repoSubPath: z.string().nullish(),
-    })
-    .nullish(),
-  /**
-   * Optional `actor` block consumed by the `session.idle` auto-commit
-   * hook. Mirrors `ActorRefDto` in workspace-git-api: the subject that
-   * triggered the turn. Stamped at session-start by the orchestrator
-   * (single-user binding) or rotated per-turn by the multi-user session
-   * extension. Absent for non-session invocations (pipeline-run agents
-   * never auto-commit).
-   */
-  actor: z
-    .object({
-      kind: z.enum(['org_user']),
-      subjectRef: z.string().min(1),
-      displayName: z.string().min(1),
-    })
-    .nullish(),
-});
-
-export type InvocationContext = z.infer<typeof ContextJsonSchema>;
-export type InvocationRole = InvocationContext['invocation']['role'];
-
-/**
- * Read and validate /workspace/context.json. Returns null if the file is
- * absent — the plugin then registers no Xema-specific tools (non-Xema
- * sessions simply pass through). Throws on malformed JSON or schema
- * violations so programmatic consumers (tests, tools) see the underlying
- * error; hooks call {@link readInvocationContextForHook} instead to get
- * a log-and-skip shape.
- */
-export function readInvocationContext(
-  workspaceDir: string,
-): InvocationContext | null {
-  const path = join(workspaceDir, 'context.json');
-  if (!existsSync(path)) {
-    return null;
-  }
-  const raw = readFileSync(path, 'utf-8');
-  const parsed = JSON.parse(raw) as unknown;
-  return ContextJsonSchema.parse(parsed);
-}
-
-/**
- * Hook-friendly variant of {@link readInvocationContext}. Silently returns
- * `null` when `context.json` is absent (expected for non-Xema sessions /
- * pre-mount calls), and emits a prefixed warn to stderr when the file is
- * present but malformed — previously these errors propagated into
- * opencode's hook dispatcher and were swallowed by the runtime, leaving
- * operators with no signal that the plugin had gone blind mid-session.
- */
-export function readInvocationContextForHook(
-  workspaceDir: string,
-  hookName: string,
-): InvocationContext | null {
-  const path = join(workspaceDir, 'context.json');
-  if (!existsSync(path)) {
-    return null;
-  }
-  try {
-    const raw = readFileSync(path, 'utf-8');
-    const parsed = JSON.parse(raw) as unknown;
-    return ContextJsonSchema.parse(parsed);
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    warn(
-      `hook=${hookName}: failed to read/validate ${path}: ${message}. ` +
-        `Hook will skip this invocation; fix context.json to re-enable plugin behavior.`,
-    );
-    return null;
-  }
-}

package/src/errors.ts

@@ -1,24 +0,0 @@
-// ═══════════════════════════════════════════════════════════════════════════
-// ── Plugin error types ──
-// Typed errors surfaced to the LLM as tool results. Opencode naturally
-// retries tool errors in the same session, so these are our in-session
-// correction signals.
-// ═══════════════════════════════════════════════════════════════════════════
-
-/**
- * Thrown by the `experimental.chat.system.transform` hook when a Xema
- * session boots but `/workspace/.xema/system-overlay.md` is missing.
- *
- * Fail-closed: the run's platform contract is undefined; we refuse to
- * start the chat rather than letting the agent operate without the AWP
- * base layer + deliverable contract + authority guidance the rest of
- * the platform assumes is in scope.
- */
-export class XemaSystemOverlayMissingError extends Error {
-  readonly code = 'XEMA_SYSTEM_OVERLAY_MISSING';
-  constructor(message: string) {
-    super(message);
-    this.name = 'XemaSystemOverlayMissingError';
-  }
-}
-