@xyne/workflow-sdk 3.2.33 → 3.2.35

package/dist/agents/host-agent-step.js

@@ -0,0 +1,352 @@
+/**
+ * HostAgentStep — runs an agent the *host* owns, rather than one the SDK
+ * drives.
+ *
+ * Where {@link AgentStep} asks an author to construct an agent (system prompt,
+ * tools, model, turn budget), this asks them to choose one and give it a task.
+ * Everything about how that agent behaves — its prompt, its tools, its MCP
+ * connections — is resolved by the host's own agent platform behind a
+ * {@link BaseAgentProvider}.
+ *
+ * What stays here is the workflow's contract with the step, and it is identical
+ * to the LLM step's: the declared output shape, JSON repair, citation
+ * splitting, and artifact persistence. Both steps emit the same
+ * {@link AgentResult}, so downstream `{{steps.x.output.response}}` refs bind
+ * the same way against either.
+ *
+ * Registered by the host with its own naming, so a deployment shows the step
+ * in the author's vocabulary:
+ *
+ *     new HostAgentStep(new ClawAgentProvider(deps), {
+ *       type: 'RUN_XYNE_AGENT',
+ *       name: 'Run Xyne Agent',
+ *       description: 'Run an agent from your workspace',
+ *     })
+ *
+ * Free of pi-mono imports — a host registering only this step does not pull the
+ * LLM runtime into its bundle.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../steps/base-step.js';
+import { markAttachmentFields } from '../common/attachment.js';
+import { AgentResultSchema, agentContractFields, attachmentsField, classifyResponse, isRecord, jsonRepairRetriesField, resolveAgentOutputJsonSchema, shapeAgentResponse, } from './contract.js';
+import { resolveAgentMode, supportsAsync, supportsSync } from './provider.js';
+// ─── Config Schema ───
+/**
+ * The fields this step adds on top of the provider's own.
+ *
+ * `task` is deliberately not called `userMessage`: there is no system prompt to
+ * contrast it with here, because the host owns that.
+ */
+const taskField = z.string()
+    .describe('What the agent should do. Supports refs, e.g. {{trigger.body.question}}');
+/**
+ * Only rendered when the provider implements both transports. Labelled by
+ * outcome rather than transport: the author is choosing whether the run holds a
+ * worker slot, not which protocol it speaks.
+ */
+const modeField = z.enum(['sync', 'async']).default('sync')
+    .describe('Wait for the result, or continue in the background and resume when the agent reports back');
+const hostAgentContractFields = {
+    attachments: attachmentsField('Input documents made available to the agent. Bind to a ref, e.g. {{trigger.attachments}}'),
+    outputType: agentContractFields.outputType,
+    outputSchema: agentContractFields.outputSchema,
+    cite: agentContractFields.cite,
+    jsonRepairRetries: jsonRepairRetriesField('When the response is empty (any outputType), or — for outputType "json" — not valid JSON, '
+        + 're-run the agent with the reason/parse error up to this many times before returning the '
+        + 'last response as-is.'),
+    timeoutMs: agentContractFields.timeoutMs,
+};
+const HostAgentBaseSchema = z.object({
+    task: taskField,
+    mode: modeField,
+    ...hostAgentContractFields,
+});
+// ─── Step Row Readers ───
+/**
+ * Recover the dispatch record the step wrote when it parked. Absent means this
+ * step never dispatched — a row from an older shape, or a resume aimed at the
+ * wrong gate — and the caller refuses to collect rather than guessing.
+ */
+function readDispatchRecord(rowData) {
+    const raw = rowData['agent'];
+    if (!isRecord(raw))
+        return undefined;
+    const { provider, attempt, externalRef } = raw;
+    if (typeof provider !== 'string' || typeof externalRef !== 'string')
+        return undefined;
+    return { provider, externalRef, attempt: typeof attempt === 'number' ? attempt : 0 };
+}
+/** The payload the host passed to `runtime.resume()`, as the executor stored it. */
+function readResumePayload(rowData) {
+    const raw = rowData['resumePayload'];
+    if (!isRecord(raw) || typeof raw['action'] !== 'string')
+        return undefined;
+    return raw;
+}
+// ─── Step ───
+export class HostAgentStep extends BaseActionStep {
+    provider;
+    type;
+    name;
+    description;
+    category;
+    configSchema;
+    outputSchema = AgentResultSchema;
+    constructor(provider, options = {}) {
+        super();
+        this.provider = provider;
+        this.type = options.type ?? 'RUN_HOST_AGENT';
+        this.name = options.name ?? 'Run Agent';
+        this.description = options.description ?? 'Run an agent from your workspace';
+        this.category = options.category ?? 'ai';
+        if (options.icon !== undefined)
+            this.icon = options.icon;
+        // Provider fields first, so the form reads: pick an agent, then say what it
+        // should do, then shape the output. `mode` only appears when the provider
+        // can actually do both — otherwise it would be a control with one setting.
+        const bothTransports = supportsSync(provider) && supportsAsync(provider);
+        this.configSchema = provider.configSchema.extend({
+            task: taskField,
+            ...(bothTransports ? { mode: modeField } : {}),
+            ...hostAgentContractFields,
+        });
+    }
+    decorateConfigSchema(jsonSchema) {
+        const props = jsonSchema['properties'];
+        if (props?.['outputSchema']) {
+            props['outputSchema'] = { ...props['outputSchema'], format: 'json-schema' };
+        }
+        markAttachmentFields(jsonSchema, ['attachments']);
+        // The provider decorates its own fields — the agent picker's `format` hint
+        // is declared there, since only the provider knows how its agents are named.
+        return this.provider.decorateConfigSchema?.(jsonSchema) ?? jsonSchema;
+    }
+    resolveOutputJsonSchema(config) {
+        return resolveAgentOutputJsonSchema(config);
+    }
+    async execute(rawConfig, ctx) {
+        const config = rawConfig;
+        return resolveAgentMode(this.provider, config.mode) === 'async'
+            ? this.dispatch(config, ctx, 0)
+            : this.runStreaming(config, ctx);
+    }
+    /**
+     * Resume after a dispatched run reported back.
+     *
+     * This is where the repair loop lives for background runs. It cannot be a
+     * loop the way the streaming path is — each attempt crosses a pause boundary,
+     * so the budget is carried on the step record and the loop is re-entry.
+     */
+    async onResume(rowData, rawConfig, ctx) {
+        const provider = this.provider;
+        if (!supportsAsync(provider)) {
+            throw new Error(`Agent provider "${provider.name}" has no collect(); it cannot resume a dispatched run.`);
+        }
+        const config = rawConfig;
+        const record = readDispatchRecord(rowData);
+        if (!record) {
+            throw new Error('Step resumed with no agent dispatch record — it was not parked by this step, '
+                + 'so there is no run to collect.');
+        }
+        // A provider swap between dispatch and callback would otherwise hand this
+        // provider a correlation reference minted by a different system.
+        if (record.provider !== provider.name) {
+            throw new Error(`Step was dispatched to agent provider "${record.provider}" but "${provider.name}" is registered now; `
+                + 'the parked run cannot be collected.');
+        }
+        const payload = readResumePayload(rowData);
+        if (!payload) {
+            throw new Error(`Step resumed with no payload — ${provider.name} reported back without a result.`);
+        }
+        const result = await provider.collect(payload, record, config, ctx);
+        const expectJson = config.outputType === 'json';
+        const verdict = classifyResponse(result.text, expectJson);
+        if (verdict.ok)
+            return this.finalize(result, config, ctx, result.attachments ?? []);
+        const attempt = record.attempt;
+        const defect = {
+            reason: verdict.reason,
+            ...(verdict.error ? { error: verdict.error } : {}),
+        };
+        if (attempt >= config.jsonRepairRetries) {
+            // Unlike the streaming path, a background run cannot hand back a partial
+            // result and let the author see it — nothing is watching. Fail loudly.
+            throw new Error(`Agent response unusable after ${String(attempt)} repair attempt(s) (${verdict.reason}`
+                + `${verdict.error ? `: ${verdict.error}` : ''})`);
+        }
+        ctx.log.warn(`Agent response unusable (${verdict.reason}); re-dispatching `
+            + `(${String(attempt + 1)}/${String(config.jsonRepairRetries)})`);
+        ctx.emit({
+            type: 'substep',
+            data: {
+                type: 'retry',
+                attempt: attempt + 1,
+                maxAttempts: config.jsonRepairRetries,
+                reason: verdict.reason,
+            },
+        });
+        return this.dispatch(config, ctx, attempt + 1, defect);
+    }
+    /**
+     * Hand the run to the provider and park the step. Never returns — `ctx.pause`
+     * throws, releasing the worker slot until the host calls back.
+     */
+    async dispatch(config, ctx, attempt, defect) {
+        const provider = this.provider;
+        if (!supportsAsync(provider)) {
+            throw new Error(`Agent provider "${provider.name}" does not implement dispatch()/collect(); `
+                + 'background runs are not available.');
+        }
+        const signal = ctx.runtime.metadata['signal']
+            ?? new AbortController().signal;
+        const { externalRef } = await provider.dispatch(config, this.buildInput(config, signal, attempt, defect), ctx);
+        const record = { provider: provider.name, attempt, externalRef };
+        ctx.pause(`waiting on ${provider.name} agent run`, { externalRef, statePatch: { agent: record } });
+    }
+    /** Run the agent inline, streaming progress, repairing in a loop. */
+    async runStreaming(config, ctx) {
+        const provider = this.provider;
+        if (!supportsSync(provider)) {
+            throw new Error(`Agent provider "${provider.name}" does not implement a streaming run(). `
+                + 'Set mode to "async" to dispatch it instead.');
+        }
+        const expectJson = config.outputType === 'json';
+        const collected = [];
+        // Link the execution's own abort signal to this step's wall-clock budget,
+        // so a provider holding a connection is told to let go either way.
+        const controller = new AbortController();
+        const executionSignal = ctx.runtime.metadata['signal'];
+        const onExecutionAbort = () => { controller.abort(); };
+        executionSignal?.addEventListener('abort', onExecutionAbort, { once: true });
+        const timer = setTimeout(() => { controller.abort(); }, config.timeoutMs);
+        if (typeof timer === 'object' && 'unref' in timer) {
+            timer.unref();
+        }
+        try {
+            let last;
+            let defect;
+            // `jsonRepairRetries` counts retries, so attempt 0 is the initial run.
+            for (let attempt = 0; attempt <= config.jsonRepairRetries; attempt++) {
+                last = await this.consume(provider.run(config, this.buildInput(config, controller.signal, attempt, defect), ctx), ctx, collected);
+                const verdict = classifyResponse(last.text, expectJson);
+                if (verdict.ok)
+                    break;
+                defect = { reason: verdict.reason, ...(verdict.error ? { error: verdict.error } : {}) };
+                if (attempt < config.jsonRepairRetries) {
+                    ctx.log.warn(`Agent response unusable (${verdict.reason}); re-prompting `
+                        + `(${String(attempt + 1)}/${String(config.jsonRepairRetries)})`);
+                    ctx.emit({
+                        type: 'substep',
+                        data: {
+                            type: 'retry',
+                            attempt: attempt + 1,
+                            maxAttempts: config.jsonRepairRetries,
+                            reason: verdict.reason,
+                        },
+                    });
+                }
+            }
+            if (!last) {
+                // Unreachable: the loop always runs at least once and `consume` either
+                // returns a result or throws. Guarded so a future edit can't silently
+                // return an empty agent result.
+                throw new Error('Agent run produced no result');
+            }
+            // The last response is returned as-is even when still unusable — someone
+            // is watching this run and can see the failure in the output.
+            return this.finalize(last, config, ctx, collected);
+        }
+        finally {
+            clearTimeout(timer);
+            executionSignal?.removeEventListener('abort', onExecutionAbort);
+        }
+    }
+    buildInput(config, signal, attempt, defect) {
+        const expectJson = config.outputType === 'json';
+        const outputSchema = isRecord(config.outputSchema) ? config.outputSchema : undefined;
+        return {
+            task: config.task,
+            // The resolver has replaced any ref with the concrete array by now, so a
+            // non-array here means "nothing bound".
+            attachments: Array.isArray(config.attachments) ? config.attachments : [],
+            expectJson,
+            cite: config.cite,
+            signal,
+            ...(expectJson && outputSchema ? { outputSchema } : {}),
+            ...(defect ? { repair: { attempt, ...defect } } : {}),
+        };
+    }
+    finalize(result, config, ctx, attachments) {
+        return {
+            response: shapeAgentResponse(result.text, { outputType: config.outputType, cite: config.cite }, ctx.log),
+            toolCalls: result.toolCalls,
+            turnCount: result.turnCount,
+            usage: result.usage,
+            attachments,
+        };
+    }
+    /**
+     * Drive one streamed run to completion: forward progress to the execution
+     * viewer, persist artifacts, and return the result the provider reported.
+     */
+    async consume(events, ctx, collected) {
+        let result;
+        for await (const event of events) {
+            switch (event.type) {
+                case 'text':
+                    if (event.text.length > 0) {
+                        ctx.emit({ type: 'substep', data: { type: 'message', content: event.text } });
+                    }
+                    break;
+                case 'thinking':
+                    ctx.emit({ type: 'thinking', data: { phase: 'start' } });
+                    break;
+                case 'tool_start':
+                    ctx.emit({
+                        type: 'tool_call',
+                        data: {
+                            tool: event.tool,
+                            args: event.args,
+                            phase: 'start',
+                            toolCallId: event.toolCallId,
+                        },
+                    });
+                    break;
+                case 'tool_end':
+                    ctx.emit({
+                        type: 'tool_call',
+                        data: {
+                            tool: event.tool,
+                            result: event.result,
+                            phase: 'end',
+                            toolCallId: event.toolCallId,
+                        },
+                    });
+                    break;
+                case 'artifact': {
+                    // Storage policy stays in the SDK: the provider yields bytes, the
+                    // step decides where they land and under whose scope.
+                    if (!ctx.storage) {
+                        ctx.log.warn(`Agent produced artifact "${event.name}" but no storage adapter is configured; dropping it`);
+                        break;
+                    }
+                    collected.push(await ctx.storage.store(ctx.runtime.attributes, {
+                        name: event.name,
+                        mimeType: event.mimeType,
+                        bytes: event.bytes,
+                    }));
+                    break;
+                }
+                case 'done':
+                    result = event.result;
+                    break;
+            }
+        }
+        if (!result) {
+            throw new Error(`Agent provider "${this.provider.name}" ended the run without reporting a result`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=host-agent-step.js.map

package/dist/agents/host-agent-step.js.map

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

package/dist/agents/host.d.ts

@@ -0,0 +1,9 @@
+export { BaseAgentProvider, supportsSync, supportsAsync, resolveAgentMode } from './provider.js';
+export type { AgentDescriptor, AgentDispatchRecord, AgentProvider, AgentRunEvent, AgentRunInput, AgentRunResult, AsyncAgentCapability, SyncAgentCapability, } from './provider.js';
+export { HostAgentStep } from './host-agent-step.js';
+export type { HostAgentBaseConfig, HostAgentStepOptions } from './host-agent-step.js';
+export { AgentResultSchema, agentContractFields, attachmentsField, jsonRepairRetriesField, classifyResponse, parseJsonResponse, resolveAgentOutputJsonSchema, shapeAgentResponse, } from './contract.js';
+export type { AgentResult, ResponseDefect, ToolCallRecord } from './contract.js';
+export type { CitationRef, CitationMap } from '../common/citation-ref.js';
+export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
+//# sourceMappingURL=host.d.ts.map

package/dist/agents/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/agents/host.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjG,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAOtF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGjF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/agents/host.js

@@ -0,0 +1,20 @@
+// @xyne/workflow-sdk/agents/host — host-owned agent steps.
+//
+// A separate entry point from ./agents on purpose: everything reachable from
+// here is free of pi-mono, so a host that runs its own agent platform (claw, an
+// `agents` table, anything else behind a provider) does not pull
+// @earendil-works/pi-agent-core, pi-ai and typebox into its bundle to get an
+// agent step.
+//
+// Import from ./agents instead when you want the SDK to drive the LLM itself.
+// ─── Provider Port ───
+export { BaseAgentProvider, supportsSync, supportsAsync, resolveAgentMode } from './provider.js';
+// ─── Step ───
+export { HostAgentStep } from './host-agent-step.js';
+// ─── Shared Agent Contract ───
+//
+// Exported so a provider can compose the same output shape and repair
+// semantics the built-in steps use.
+export { AgentResultSchema, agentContractFields, attachmentsField, jsonRepairRetriesField, classifyResponse, parseJsonResponse, resolveAgentOutputJsonSchema, shapeAgentResponse, } from './contract.js';
+export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
+//# sourceMappingURL=host.js.map

package/dist/agents/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/agents/host.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,iEAAiE;AACjE,6EAA6E;AAC7E,cAAc;AACd,EAAE;AACF,8EAA8E;AAE9E,wBAAwB;AAExB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYjG,eAAe;AAEf,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,gCAAgC;AAChC,EAAE;AACF,sEAAsE;AACtE,oCAAoC;AAEpC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/agents/index.d.ts

@@ -12,6 +12,12 @@ export { ToolLoggingInterceptor } from './interceptors/tool-logger.js';
 export { AgentStep, AgentStepConfigSchema, type AgentStepConfig, } from './agent-step.js';
 export type { CitationRef, CitationMap } from '../common/citation-ref.js';
 export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
+export { BaseAgentProvider, supportsSync, supportsAsync, resolveAgentMode } from './provider.js';
+export type { AgentDescriptor, AgentDispatchRecord, AgentProvider, AgentRunEvent, AgentRunInput, AgentRunResult, AsyncAgentCapability, SyncAgentCapability, } from './provider.js';
+export { HostAgentStep } from './host-agent-step.js';
+export type { HostAgentBaseConfig, HostAgentStepOptions } from './host-agent-step.js';
+export { AgentResultSchema, agentContractFields, attachmentsField, jsonRepairRetriesField, classifyResponse, parseJsonResponse, resolveAgentOutputJsonSchema, shapeAgentResponse, } from './contract.js';
+export type { ResponseDefect } from './contract.js';
 export { PiMonoRuntime, PiMonoConfigSchema, type PiMonoConfig, type PiMonoRuntimeOptions, } from './pi-mono-runtime.js';
 export { PiSessionRuntime, PiSessionConfigSchema, type PiSessionConfig, type PiSessionRuntimeOptions, } from './pi-session-runtime.js';
 export type { AuthCredential } from '@earendil-works/pi-coding-agent';

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAEV,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EAEN,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIvF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAEV,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EAEN,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIvF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ7E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjG,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAItF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/agents/index.js

@@ -15,6 +15,15 @@ export { ToolLoggingInterceptor } from './interceptors/tool-logger.js';
 // ─── Agent Step ───
 export { AgentStep, AgentStepConfigSchema, } from './agent-step.js';
 export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
+// ─── Host-Owned Agents ───
+//
+// For hosts that run their own agent platform rather than letting the SDK drive
+// the LLM. Also available from the pi-free entry point `@xyne/workflow-sdk/agents/host`
+// — import from there to keep pi-mono out of the bundle.
+export { BaseAgentProvider, supportsSync, supportsAsync, resolveAgentMode } from './provider.js';
+export { HostAgentStep } from './host-agent-step.js';
+// ─── Shared Agent Contract ───
+export { AgentResultSchema, agentContractFields, attachmentsField, jsonRepairRetriesField, classifyResponse, parseJsonResponse, resolveAgentOutputJsonSchema, shapeAgentResponse, } from './contract.js';
 // ─── Pi-Mono Runtime ───
 export { PiMonoRuntime, PiMonoConfigSchema, } from './pi-mono-runtime.js';
 // ─── Pi-Session Runtime (AgentSession-based) ───

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,0EAA0E;AAC1E,kCAAkC;AAClC,0BAA0B;AAgD1B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,uBAAuB;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AAErB,OAAO,EACL,SAAS,EACT,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE7E,0BAA0B;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,kDAAkD;AAElD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,0EAA0E;AAC1E,kCAAkC;AAClC,0BAA0B;AAgD1B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,uBAAuB;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AAErB,OAAO,EACL,SAAS,EACT,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE7E,4BAA4B;AAC5B,EAAE;AACF,gFAAgF;AAChF,wFAAwF;AACxF,yDAAyD;AAEzD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYjG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,gCAAgC;AAEhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,0BAA0B;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,kDAAkD;AAElD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC"}