omp-conductor 0.17.0 → 0.18.0

package/src/omp.ts

@@ -197,6 +197,24 @@ export async function createLocalSession(opts: {
    * session has no route to a mutation to scope in the first place.
    */
   readOnly?: boolean;
+  /**
+   * The structured-settlement contract (#540): a JSON Schema the session's
+   * `yield` tool validates its `data` payload against. The worker yields its
+   * settlement as structured output instead of writing prose for the caller to
+   * regex. A subagent-oriented harness option, forwarded as-is.
+   */
+  outputSchema?: unknown;
+  /**
+   * Enforcement policy for {@link outputSchema}. The worker contract is
+   * `"permissive"`: a schema violation must still settle with whatever the
+   * worker produced, never discard the report.
+   */
+  outputSchemaMode?: "permissive" | "strict";
+  /**
+   * Force the hidden `yield` tool into this session's toolset (#540). Without
+   * it the model has no sanctioned way to submit structured output.
+   */
+  requireYieldTool?: boolean;
 }): Promise<AgentSessionLike> {
   let loaded: unknown;
   try {
@@ -290,6 +308,13 @@ export async function createLocalSession(opts: {
     // agentDir (~/.omp/agent/mcp.json) — without this, workers grep-only and
     // burn the turns cap on discovery (#29).
     enableMCP: true,
+    // The structured-settlement contract (#540): subagent-oriented options
+    // threaded to the harness so the worker can yield its report as a schema-
+    // validated object instead of prose. Absent for every other session kind —
+    // probes and orchestrator sessions never yield.
+    ...(opts.outputSchema === undefined ? {} : { outputSchema: opts.outputSchema }),
+    ...(opts.outputSchemaMode === undefined ? {} : { outputSchemaMode: opts.outputSchemaMode }),
+    ...(opts.requireYieldTool === undefined ? {} : { requireYieldTool: opts.requireYieldTool }),
     // Mechanical tool gates: confinement prevents structured worktree I/O from
     // escaping cwd; release policy blocks release/deploy calls when configured.
     ...(extensions.length === 0 ? {} : { extensions }),
@@ -515,6 +540,20 @@ export interface CreateSessionOptions {
    * gate — actually lives.
    */
   readOnly?: boolean;
+  /**
+   * The structured-settlement contract (#540): a JSON Schema the session's
+   * `yield` tool validates its `data` payload against. Forwarded to the child
+   * through the host spec, exactly like {@link ompSettingsFile}.
+   */
+  outputSchema?: unknown;
+  /**
+   * Enforcement policy for {@link outputSchema} — the worker contract is
+   * `"permissive"`, so a schema violation settles with whatever the worker
+   * produced instead of losing the report.
+   */
+  outputSchemaMode?: "permissive" | "strict";
+  /** Force the hidden `yield` tool into this session's toolset (#540). */
+  requireYieldTool?: boolean;
 }
 
 /**
@@ -601,6 +640,9 @@ export async function createSession(opts: CreateSessionOptions): Promise<AgentSe
     ...(opts.verbSocketPath === undefined ? {} : { verbSocketPath: opts.verbSocketPath }),
     ...(opts.readOnly === undefined ? {} : { readOnly: opts.readOnly }),
     ...(opts.ompSettingsFile === undefined ? {} : { ompSettingsFile: opts.ompSettingsFile }),
+    ...(opts.outputSchema === undefined ? {} : { outputSchema: opts.outputSchema }),
+    ...(opts.outputSchemaMode === undefined ? {} : { outputSchemaMode: opts.outputSchemaMode }),
+    ...(opts.requireYieldTool === undefined ? {} : { requireYieldTool: opts.requireYieldTool }),
   };
 
   const log = opts.onChildLog ?? ((line: string) => process.stderr.write(`${line}\n`));