@renseiai/agentfactory 0.8.18 → 0.8.19

package/dist/src/providers/codex-provider.js

@@ -1,10 +1,22 @@
 /**
  * OpenAI Codex Agent Provider
  *
- * Spawns the `codex` CLI (from @openai/codex) as a child process and parses
- * its JSONL event stream into normalized AgentEvents.
+ * Unified Codex provider with two execution modes:
  *
- * CLI invocation patterns:
+ * 1. **App Server mode** (default when CODEX_USE_APP_SERVER=1):
+ *    Uses a long-lived `codex app-server` process communicating via JSON-RPC 2.0
+ *    over stdio. Supports multiple concurrent threads on a single process.
+ *
+ * 2. **Exec fallback mode** (backward compatibility):
+ *    Spawns the `codex` CLI as a child process and parses its JSONL event stream.
+ *    Used for CI/CD or when app-server is unavailable.
+ *
+ * Mode selection:
+ *   - CODEX_USE_APP_SERVER=1  → App Server mode (JSON-RPC 2.0)
+ *   - CODEX_USE_APP_SERVER=0  → Exec fallback mode (CLI JSONL)
+ *   - Not set                 → Exec fallback mode (default, backward compatible)
+ *
+ * Exec CLI invocation patterns:
  *   New session:  codex exec --json --full-auto -C <cwd> "<prompt>"
  *   Resume:       codex exec resume --json --full-auto <session_id> "<prompt>"
  *
@@ -18,6 +30,7 @@
  */
 import { spawn } from 'child_process';
 import { createInterface } from 'readline';
+import { CodexAppServerProvider } from './codex-app-server-provider.js';
 /**
  * Map a single Codex JSONL event to one or more normalized AgentEvents.
  * Exported for unit testing — the AgentHandle uses this internally.
@@ -186,19 +199,58 @@ export function mapCodexItemEvent(event) {
 // ---------------------------------------------------------------------------
 // Provider
 // ---------------------------------------------------------------------------
+/**
+ * Check whether App Server mode is enabled.
+ *
+ * Returns true when CODEX_USE_APP_SERVER=1 (or 'true').
+ * The env var can be set globally or per-spawn via config.env.
+ */
+function isAppServerEnabled(config) {
+    const envVal = config?.env?.CODEX_USE_APP_SERVER
+        ?? process.env.CODEX_USE_APP_SERVER
+        ?? '';
+    return envVal === '1' || envVal.toLowerCase() === 'true';
+}
 export class CodexProvider {
     name = 'codex';
     capabilities = {
         supportsMessageInjection: false,
         supportsSessionResume: true,
     };
+    /** App Server delegate — created lazily when App Server mode is enabled */
+    appServerProvider = null;
     spawn(config) {
-        return this.createHandle(config);
+        if (isAppServerEnabled(config)) {
+            return this.getAppServerProvider().spawn(config);
+        }
+        return this.createExecHandle(config);
     }
     resume(sessionId, config) {
-        return this.createHandle(config, sessionId);
+        if (isAppServerEnabled(config)) {
+            return this.getAppServerProvider().resume(sessionId, config);
+        }
+        return this.createExecHandle(config, sessionId);
+    }
+    /**
+     * Shut down the App Server process if running.
+     * No-op if in exec fallback mode.
+     */
+    async shutdown() {
+        if (this.appServerProvider) {
+            await this.appServerProvider.shutdown();
+            this.appServerProvider = null;
+        }
+    }
+    getAppServerProvider() {
+        if (!this.appServerProvider) {
+            this.appServerProvider = new CodexAppServerProvider();
+        }
+        return this.appServerProvider;
     }
-    createHandle(config, resumeSessionId) {
+    // -------------------------------------------------------------------------
+    // Exec fallback mode (backward compatibility — SUP-1739)
+    // -------------------------------------------------------------------------
+    createExecHandle(config, resumeSessionId) {
         const abortController = config.abortController;
         // Resolve the codex binary — prefer CODEX_BIN env var, then fall back to 'codex'
         const codexBin = config.env.CODEX_BIN || process.env.CODEX_BIN || 'codex';

package/dist/src/providers/index.d.ts

@@ -32,6 +32,7 @@ export type { AgentInitEvent, AgentSystemEvent, AgentAssistantTextEvent, AgentTo
 export type { ActionDefinition, ActionResult, AuthResult, ConditionContext, ConditionDefinition, CredentialDefinition, CredentialField, DynamicOptionField, NormalizedEvent, ProviderExecutionContext, ProviderPlugin, TriggerDefinition, WebhookConfig, WebhookRegistration, } from './plugin-types.js';
 export { ClaudeProvider, createClaudeProvider } from './claude-provider.js';
 export { CodexProvider, createCodexProvider } from './codex-provider.js';
+export { CodexAppServerProvider, createCodexAppServerProvider } from './codex-app-server-provider.js';
 export { AmpProvider, createAmpProvider } from './amp-provider.js';
 export { SpringAiProvider, createSpringAiProvider } from './spring-ai-provider.js';
 export { A2aProvider, createA2aProvider } from './a2a-provider.js';

package/dist/src/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACxI,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AACrG,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAYxD,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC9C,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC9C;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACzC;AAED,iFAAiF;AACjF,MAAM,WAAW,8BAA+B,SAAQ,yBAAyB;IAC/E,iEAAiE;IACjE,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAMD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAK9D,CAAA;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAkBrE;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA6BjF;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,wBAAwB,CAgEvG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,iBAAiB,CAE1F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,wBAAwB,CAAC,CA8FnC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,iBAAiB,CAE3E"}

package/dist/src/providers/index.js

@@ -29,6 +29,7 @@
  */
 export { ClaudeProvider, createClaudeProvider } from './claude-provider.js';
 export { CodexProvider, createCodexProvider } from './codex-provider.js';
+export { CodexAppServerProvider, createCodexAppServerProvider } from './codex-app-server-provider.js';
 export { AmpProvider, createAmpProvider } from './amp-provider.js';
 export { SpringAiProvider, createSpringAiProvider } from './spring-ai-provider.js';
 export { A2aProvider, createA2aProvider } from './a2a-provider.js';

package/dist/src/routing/observation-recorder.test.js

@@ -14,7 +14,7 @@ function makeProcess(overrides = {}) {
 function makeMockStores() {
     const observationStore = {
         recordObservation: vi.fn().mockResolvedValue(undefined),
-        getObservations: vi.fn().mockResolvedValue([]),
+        getObservations: vi.fn().mockResolvedValue({ observations: [] }),
         getRecentObservations: vi.fn().mockResolvedValue([]),
     };
     const posteriorStore = {

package/dist/src/routing/observation-store.d.ts

@@ -1,6 +1,14 @@
 import type { AgentProviderName } from '../providers/types.js';
 import type { AgentWorkType } from '../orchestrator/work-types.js';
 import type { RoutingObservation } from './types.js';
+/**
+ * Result of a paginated observation query.
+ */
+export interface ObservationQueryResult {
+    observations: RoutingObservation[];
+    /** Opaque cursor for fetching the next page. Undefined when no more results. */
+    nextCursor?: string;
+}
 /**
  * Observation Store Interface
  *
@@ -20,13 +28,19 @@ export interface ObservationStore {
      * @param opts.workType  - Filter by work type
      * @param opts.limit     - Maximum number of observations to return
      * @param opts.since     - Only return observations with timestamp >= since (epoch ms)
+     * @param opts.from      - Start of time range (epoch ms), inclusive
+     * @param opts.to        - End of time range (epoch ms), inclusive
+     * @param opts.cursor    - Opaque cursor for pagination (Redis Stream ID)
      */
     getObservations(opts: {
         provider?: AgentProviderName;
         workType?: AgentWorkType;
         limit?: number;
         since?: number;
-    }): Promise<RoutingObservation[]>;
+        from?: number;
+        to?: number;
+        cursor?: string;
+    }): Promise<ObservationQueryResult>;
     /**
      * Get the most recent observations for a specific provider + work type pair.
      * Results are returned newest-first, up to `windowSize` entries.

package/dist/src/routing/observation-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observation-store.d.ts","sourceRoot":"","sources":["../../../src/routing/observation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE;QACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;QAC5B,QAAQ,CAAC,EAAE,aAAa,CAAA;QACxB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;IAEjC;;;;;;;OAOG;IACH,qBAAqB,CACnB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;CACjC"}
+{"version":3,"file":"observation-store.d.ts","sourceRoot":"","sources":["../../../src/routing/observation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,kBAAkB,EAAE,CAAA;IAClC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;;;;;;;;OAUG;IACH,eAAe,CAAC,IAAI,EAAE;QACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;QAC5B,QAAQ,CAAC,EAAE,aAAa,CAAA;QACxB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEnC;;;;;;;OAOG;IACH,qBAAqB,CACnB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;CACjC"}

package/dist/src/routing/observation-store.test.js

@@ -41,10 +41,16 @@ function createInMemoryStore() {
             if (opts.since) {
                 result = result.filter((o) => o.timestamp >= opts.since);
             }
+            if (opts.from) {
+                result = result.filter((o) => o.timestamp >= opts.from);
+            }
+            if (opts.to) {
+                result = result.filter((o) => o.timestamp <= opts.to);
+            }
             if (opts.limit) {
                 result = result.slice(0, opts.limit);
             }
-            return result;
+            return { observations: result };
         },
         async getRecentObservations(provider, workType, windowSize) {
             return observations
@@ -67,8 +73,8 @@ describe('ObservationStore interface', () => {
         const obs = makeObservation();
         await store.recordObservation(obs);
         const all = await store.getObservations({});
-        expect(all).toHaveLength(1);
-        expect(all[0]).toEqual(obs);
+        expect(all.observations).toHaveLength(1);
+        expect(all.observations[0]).toEqual(obs);
     });
     it('getObservations filters by provider', async () => {
         const store = createInMemoryStore();
@@ -76,16 +82,16 @@ describe('ObservationStore interface', () => {
         await store.recordObservation(makeObservation({ provider: 'codex' }));
         await store.recordObservation(makeObservation({ provider: 'claude' }));
         const result = await store.getObservations({ provider: 'claude' });
-        expect(result).toHaveLength(2);
-        expect(result.every((o) => o.provider === 'claude')).toBe(true);
+        expect(result.observations).toHaveLength(2);
+        expect(result.observations.every((o) => o.provider === 'claude')).toBe(true);
     });
     it('getObservations filters by workType', async () => {
         const store = createInMemoryStore();
         await store.recordObservation(makeObservation({ workType: 'development' }));
         await store.recordObservation(makeObservation({ workType: 'qa' }));
         const result = await store.getObservations({ workType: 'qa' });
-        expect(result).toHaveLength(1);
-        expect(result[0].workType).toBe('qa');
+        expect(result.observations).toHaveLength(1);
+        expect(result.observations[0].workType).toBe('qa');
     });
     it('getObservations filters by since', async () => {
         const store = createInMemoryStore();
@@ -93,8 +99,8 @@ describe('ObservationStore interface', () => {
         await store.recordObservation(makeObservation({ timestamp: 2000 }));
         await store.recordObservation(makeObservation({ timestamp: 3000 }));
         const result = await store.getObservations({ since: 2000 });
-        expect(result).toHaveLength(2);
-        expect(result.every((o) => o.timestamp >= 2000)).toBe(true);
+        expect(result.observations).toHaveLength(2);
+        expect(result.observations.every((o) => o.timestamp >= 2000)).toBe(true);
     });
     it('getObservations respects limit', async () => {
         const store = createInMemoryStore();
@@ -102,7 +108,7 @@ describe('ObservationStore interface', () => {
             await store.recordObservation(makeObservation({ timestamp: i }));
         }
         const result = await store.getObservations({ limit: 3 });
-        expect(result).toHaveLength(3);
+        expect(result.observations).toHaveLength(3);
     });
     it('getRecentObservations returns newest-first for a provider+workType pair', async () => {
         const store = createInMemoryStore();
@@ -128,7 +134,7 @@ describe('ObservationStore interface', () => {
         const store = createInMemoryStore();
         await store.recordObservation(makeObservation({ provider: 'claude' }));
         const result = await store.getObservations({ provider: 'codex' });
-        expect(result).toEqual([]);
+        expect(result.observations).toEqual([]);
     });
     it('getRecentObservations returns empty array when no observations match', async () => {
         const store = createInMemoryStore();

package/dist/src/templates/index.d.ts

@@ -5,7 +5,8 @@
  */
 export type { WorkflowTemplate, PartialTemplate, TemplateContext, ToolPermission, ToolPermissionAdapter, TemplateRegistryConfig, } from './types.js';
 export { WorkflowTemplateSchema, PartialTemplateSchema, TemplateContextSchema, AgentWorkTypeSchema, ToolPermissionSchema, validateWorkflowTemplate, validatePartialTemplate, } from './types.js';
-export { TemplateRegistry } from './registry.js';
+export { TemplateRegistry, type TemplateValidationResult } from './registry.js';
+export { generateTemplateSchema, extractTemplateVariables, type TemplateSchemaOptions } from './schema.js';
 export { loadTemplatesFromDir, loadTemplateFile, loadPartialsFromDir, getBuiltinDefaultsDir, getBuiltinPartialsDir, } from './loader.js';
 export { ClaudeToolPermissionAdapter, CodexToolPermissionAdapter, createToolPermissionAdapter } from './adapters.js';
 export { renderPromptWithFallback } from './renderer.js';

package/dist/src/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAEpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAExD,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAE/E,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAE1G,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAEpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAExD,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/src/templates/index.js

@@ -5,6 +5,7 @@
  */
 export { WorkflowTemplateSchema, PartialTemplateSchema, TemplateContextSchema, AgentWorkTypeSchema, ToolPermissionSchema, validateWorkflowTemplate, validatePartialTemplate, } from './types.js';
 export { TemplateRegistry } from './registry.js';
+export { generateTemplateSchema, extractTemplateVariables } from './schema.js';
 export { loadTemplatesFromDir, loadTemplateFile, loadPartialsFromDir, getBuiltinDefaultsDir, getBuiltinPartialsDir, } from './loader.js';
 export { ClaudeToolPermissionAdapter, CodexToolPermissionAdapter, createToolPermissionAdapter } from './adapters.js';
 export { renderPromptWithFallback } from './renderer.js';

package/dist/src/templates/registry.d.ts

@@ -5,8 +5,10 @@
  * Supports layered resolution with built-in defaults, project overrides,
  * and inline config overrides.
  */
+import type { JSONSchema7 } from 'json-schema';
 import type { AgentWorkType } from '../orchestrator/work-types.js';
 import type { WorkflowTemplate, TemplateContext, TemplateRegistryConfig, ToolPermission, ToolPermissionAdapter } from './types.js';
+import { type TemplateSchemaOptions } from './schema.js';
 /**
  * Template Registry manages workflow templates and renders prompts.
  *
@@ -76,5 +78,26 @@ export declare class TemplateRegistry {
      * Register a partial template for use in Handlebars rendering.
      */
     registerPartial(name: string, content: string): void;
+    /**
+     * Get JSON Schema 7 for a template's parameters.
+     *
+     * The schema is derived from the template's prompt by extracting
+     * Handlebars expression references and mapping them to the known
+     * TemplateContext fields. Returns null if no template is registered.
+     */
+    getSchema(templateName: string, options?: TemplateSchemaOptions): JSONSchema7 | null;
+    /**
+     * Validate a config object against a template's JSON Schema.
+     *
+     * Template expressions ({{ }}) in string values are treated as valid
+     * placeholders and are not validated against the schema type.
+     *
+     * Returns a validation result with `valid` boolean and any `errors`.
+     */
+    validateConfig(templateName: string, config: Record<string, unknown>): TemplateValidationResult;
+}
+export interface TemplateValidationResult {
+    valid: boolean;
+    errors: string[];
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/src/templates/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAQnB;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,qBAAqB,CAAC,CAAuB;;IAcrD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,GAAE,sBAA2B,GAAG,gBAAgB;IAMpE;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,GAAE,sBAA2B,GAAG,IAAI;IA4CrD;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI9D;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IASrF;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAQhE;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBjG;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAgBpF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,SAAS;IAK5F;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAGrD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAOnB,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEhF;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,qBAAqB,CAAC,CAAuB;;IAcrD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,GAAE,sBAA2B,GAAG,gBAAgB;IAMpE;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,GAAE,sBAA2B,GAAG,IAAI;IA4CrD;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI9D;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IASrF;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAQhE;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBjG;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAgBpF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,SAAS;IAK5F;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,WAAW,GAAG,IAAI;IAMpF;;;;;;;OAOG;IACH,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB;CAS5B;AAMD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB"}

package/dist/src/templates/registry.js

@@ -7,6 +7,7 @@
  */
 import Handlebars from 'handlebars';
 import { loadTemplatesFromDir, loadPartialsFromDir, getBuiltinDefaultsDir, getBuiltinPartialsDir, } from './loader.js';
+import { generateTemplateSchema } from './schema.js';
 /**
  * Template Registry manages workflow templates and renders prompts.
  *
@@ -174,4 +175,83 @@ export class TemplateRegistry {
     registerPartial(name, content) {
         this.handlebars.registerPartial(name, content);
     }
+    /**
+     * Get JSON Schema 7 for a template's parameters.
+     *
+     * The schema is derived from the template's prompt by extracting
+     * Handlebars expression references and mapping them to the known
+     * TemplateContext fields. Returns null if no template is registered.
+     */
+    getSchema(templateName, options) {
+        const template = this.templates.get(templateName);
+        if (!template)
+            return null;
+        return generateTemplateSchema(template, options);
+    }
+    /**
+     * Validate a config object against a template's JSON Schema.
+     *
+     * Template expressions ({{ }}) in string values are treated as valid
+     * placeholders and are not validated against the schema type.
+     *
+     * Returns a validation result with `valid` boolean and any `errors`.
+     */
+    validateConfig(templateName, config) {
+        const template = this.templates.get(templateName);
+        if (!template) {
+            return { valid: false, errors: [`Template "${templateName}" not found`] };
+        }
+        const schema = generateTemplateSchema(template);
+        return validateConfigAgainstSchema(config, schema);
+    }
+}
+/** Handlebars expression pattern: {{ ... }} */
+const TEMPLATE_EXPRESSION_RE = /^\{\{.*\}\}$/s;
+/**
+ * Validate a config object against a JSON Schema 7.
+ * Template expressions ({{ }}) are treated as valid for any field.
+ */
+function validateConfigAgainstSchema(config, schema) {
+    const errors = [];
+    const properties = schema.properties ?? {};
+    const required = schema.required ?? [];
+    // Check required fields
+    for (const field of required) {
+        if (!(field in config)) {
+            errors.push(`Missing required field: "${field}"`);
+        }
+    }
+    // Type-check provided fields
+    for (const [key, value] of Object.entries(config)) {
+        const fieldSchema = properties[key];
+        if (!fieldSchema || typeof fieldSchema === 'boolean')
+            continue;
+        // Template expressions are always valid
+        if (typeof value === 'string' && TEMPLATE_EXPRESSION_RE.test(value.trim())) {
+            continue;
+        }
+        const typeError = checkType(key, value, fieldSchema);
+        if (typeError)
+            errors.push(typeError);
+    }
+    return { valid: errors.length === 0, errors };
+}
+function checkType(key, value, schema) {
+    const schemaType = schema.type;
+    if (!schemaType)
+        return null;
+    // Normalize to array of type strings
+    const types = Array.isArray(schemaType) ? schemaType : [schemaType];
+    const valueType = Array.isArray(value) ? 'array' : typeof value;
+    // null is a valid JSON Schema type
+    if (value === null && types.includes('null'))
+        return null;
+    if (value === null)
+        return `Field "${key}" is null but expected ${types.join(' | ')}`;
+    // 'integer' matches typeof 'number' in JS
+    const effectiveTypes = types.map(t => t === 'integer' ? 'number' : t);
+    if (!effectiveTypes.includes(valueType)) {
+        return `Field "${key}" has type "${valueType}" but expected ${types.join(' | ')}`;
+    }
+    return null;
 }

package/dist/src/templates/schema.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Template JSON Schema Generation
+ *
+ * Generates JSON Schema 7 definitions from WorkflowTemplate objects.
+ * Schema is derived from TemplateContext fields referenced in the template's
+ * prompt via Handlebars expressions.
+ *
+ * @see SUP-1758
+ */
+import type { JSONSchema7 } from 'json-schema';
+import type { WorkflowTemplate } from './types.js';
+export interface TemplateSchemaOptions {
+    /** Include all TemplateContext fields, not just those referenced in the prompt */
+    includeAllFields?: boolean;
+}
+/**
+ * Extract Handlebars variable references from a template prompt.
+ * Matches {{ varName }}, {{ varName.property }}, and handles
+ * conditionals like {{#if varName}} and {{#unless varName}}.
+ *
+ * Returns the set of top-level variable names referenced.
+ */
+export declare function extractTemplateVariables(prompt: string): Set<string>;
+/**
+ * Generate a JSON Schema 7 definition for a WorkflowTemplate's parameters.
+ *
+ * By default, only includes fields that are referenced in the template's
+ * prompt. Set `includeAllFields: true` to include all known TemplateContext fields.
+ */
+export declare function generateTemplateSchema(template: WorkflowTemplate, options?: TemplateSchemaOptions): JSONSchema7;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/templates/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/templates/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAMlD,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AA4DD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CA2BpE;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,WAAW,CAqCb"}

package/dist/src/templates/schema.js

@@ -0,0 +1,139 @@
+/**
+ * Template JSON Schema Generation
+ *
+ * Generates JSON Schema 7 definitions from WorkflowTemplate objects.
+ * Schema is derived from TemplateContext fields referenced in the template's
+ * prompt via Handlebars expressions.
+ *
+ * @see SUP-1758
+ */
+// ---------------------------------------------------------------------------
+// Known TemplateContext field definitions
+// ---------------------------------------------------------------------------
+/**
+ * Maps TemplateContext field names to their JSON Schema 7 definitions.
+ * This is the source of truth for schema generation.
+ */
+const CONTEXT_FIELD_SCHEMAS = {
+    identifier: { type: 'string', description: 'Issue identifier, e.g., "SUP-123"' },
+    mentionContext: { type: 'string', description: 'Optional user mention text providing additional context' },
+    startStatus: { type: 'string', description: 'Status to show when agent starts, e.g., "Started"' },
+    completeStatus: { type: 'string', description: 'Status to show when agent completes, e.g., "Finished"' },
+    parentContext: { type: 'string', description: 'Pre-built enriched prompt for parent issues with sub-issues' },
+    subIssueList: { type: 'string', description: 'Formatted list of sub-issues with statuses' },
+    cycleCount: { type: 'integer', description: 'Current escalation cycle count' },
+    strategy: { type: 'string', description: 'Current escalation strategy' },
+    failureSummary: { type: 'string', description: 'Accumulated failure summary across cycles' },
+    attemptNumber: { type: 'integer', description: 'Attempt number within current phase' },
+    previousFailureReasons: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'List of previous failure reasons',
+    },
+    totalCostUsd: { type: 'number', description: 'Total cost in USD across all attempts' },
+    blockerIdentifier: { type: 'string', description: 'Blocker issue identifier' },
+    team: { type: 'string', description: 'Team name' },
+    repository: { type: 'string', description: 'Git repository URL pattern' },
+    projectPath: { type: 'string', description: 'Root directory for this project within the repo' },
+    sharedPaths: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Shared directories that any project agent may modify',
+    },
+    useToolPlugins: { type: 'boolean', description: 'When true, agents use in-process tools instead of CLI' },
+    linearCli: { type: 'string', description: 'Command to invoke the Linear CLI (default: "pnpm af-linear")' },
+    packageManager: { type: 'string', description: 'Package manager used by the project (default: "pnpm")' },
+    buildCommand: { type: 'string', description: 'Build command override' },
+    testCommand: { type: 'string', description: 'Test command override' },
+    validateCommand: { type: 'string', description: 'Validation command override' },
+    phaseOutputs: {
+        type: 'object',
+        additionalProperties: {
+            type: 'object',
+            additionalProperties: true,
+        },
+        description: 'Collected outputs from upstream phases',
+    },
+    agentBugBacklog: { type: 'string', description: 'Linear project name for agent-improvement issues' },
+};
+/** Fields that are always required in a template config */
+const ALWAYS_REQUIRED = ['identifier'];
+// ---------------------------------------------------------------------------
+// Handlebars expression extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract Handlebars variable references from a template prompt.
+ * Matches {{ varName }}, {{ varName.property }}, and handles
+ * conditionals like {{#if varName}} and {{#unless varName}}.
+ *
+ * Returns the set of top-level variable names referenced.
+ */
+export function extractTemplateVariables(prompt) {
+    const vars = new Set();
+    // Match {{ expr }}, {{#if expr}}, {{#unless expr}}, {{> partial}}, etc.
+    const patterns = [
+        /\{\{\s*([a-zA-Z_][a-zA-Z0-9_.]*)\s*\}\}/g, // {{ varName }} or {{ var.prop }}
+        /\{\{#(?:if|unless)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#if varName}}
+        /\{\{#(?:each)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#each varName}}
+        /\{\{#(?:with)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#with varName}}
+        /\{\{\s*(?:eq|neq)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{ eq varName "value" }}
+        /\((?:eq|neq)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // (eq varName "value") — subexpression
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(prompt)) !== null) {
+            const varName = match[1];
+            // Extract the top-level variable name (before any dot)
+            const topLevel = varName.split('.')[0];
+            // Skip Handlebars built-ins and partials
+            if (topLevel !== 'this' && topLevel !== 'else') {
+                vars.add(topLevel);
+            }
+        }
+    }
+    return vars;
+}
+// ---------------------------------------------------------------------------
+// Schema generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate a JSON Schema 7 definition for a WorkflowTemplate's parameters.
+ *
+ * By default, only includes fields that are referenced in the template's
+ * prompt. Set `includeAllFields: true` to include all known TemplateContext fields.
+ */
+export function generateTemplateSchema(template, options) {
+    const includeAll = options?.includeAllFields ?? false;
+    const properties = {};
+    const required = [];
+    if (includeAll) {
+        // Include all known fields
+        for (const [field, schemaDef] of Object.entries(CONTEXT_FIELD_SCHEMAS)) {
+            properties[field] = schemaDef;
+        }
+    }
+    else {
+        // Only include fields referenced in the template prompt
+        const referencedVars = extractTemplateVariables(template.prompt);
+        for (const varName of referencedVars) {
+            if (varName in CONTEXT_FIELD_SCHEMAS) {
+                properties[varName] = CONTEXT_FIELD_SCHEMAS[varName];
+            }
+        }
+    }
+    // Always include 'identifier' as required
+    for (const field of ALWAYS_REQUIRED) {
+        if (field in properties && !required.includes(field)) {
+            required.push(field);
+        }
+    }
+    return {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        type: 'object',
+        title: `${template.metadata.name} config`,
+        description: template.metadata.description ?? `Configuration schema for ${template.metadata.name} template`,
+        properties,
+        required: required.length > 0 ? required : undefined,
+        additionalProperties: true,
+    };
+}

package/dist/src/templates/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/src/templates/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../src/templates/schema.test.ts"],"names":[],"mappings":""}