actoviq-agent-sdk 0.4.6 → 0.4.7

package/dist/src/node/sqliteCheckpointAdapter.js

@@ -0,0 +1,163 @@
+/** Maps runtime-v2 JSON checkpoints onto the tenant-scoped SQLite contract. */
+export class SqliteRunCheckpointAdapter {
+    store;
+    tenantId;
+    checkpointId;
+    constructor(options) {
+        if (!options.tenantId.trim())
+            throw new TypeError('tenantId must not be empty.');
+        this.store = options.store;
+        this.tenantId = options.tenantId;
+        this.checkpointId = options.checkpointId ?? (runId => runId);
+    }
+    async save(state) {
+        const checkpointId = this.checkpointId(state.runId);
+        const current = await this.store.load({ tenantId: this.tenantId, checkpointId });
+        const jsonState = toStorageJson(state);
+        await this.store.save({
+            tenantId: this.tenantId,
+            checkpointId,
+            runId: state.runId,
+            sessionId: state.sessionId,
+            expectedRevision: current?.revision ?? null,
+            status: mapStatus(state),
+            state: jsonState,
+            interruption: mapInterruption(state),
+            pendingSideEffects: mapPendingSideEffects(state),
+            traceContext: {
+                traceId: state.trace.traceId,
+                spanId: state.trace.spanId,
+                ...(state.trace.parentSpanId === undefined
+                    ? {}
+                    : { parentSpanId: state.trace.parentSpanId }),
+            },
+        });
+    }
+    async load(runId) {
+        const checkpoint = await this.store.load({
+            tenantId: this.tenantId,
+            checkpointId: this.checkpointId(runId),
+        });
+        if (!checkpoint)
+            return undefined;
+        return fromCheckpoint(checkpoint);
+    }
+    /** Marks the checkpoint completed while retaining an auditable tombstone. */
+    async delete(runId) {
+        const checkpointId = this.checkpointId(runId);
+        const current = await this.store.load({ tenantId: this.tenantId, checkpointId });
+        if (!current || current.status === 'completed')
+            return;
+        await this.store.save({
+            tenantId: this.tenantId,
+            checkpointId,
+            runId: current.runId,
+            sessionId: current.sessionId,
+            expectedRevision: current.revision,
+            status: 'completed',
+            state: current.state,
+            pendingSideEffects: current.pendingSideEffects,
+            traceContext: current.traceContext,
+        });
+    }
+}
+function mapStatus(state) {
+    if (state.pendingTool?.status === 'awaiting_approval')
+        return 'awaiting_side_effect';
+    return state.status;
+}
+function mapInterruption(state) {
+    const pending = state.pendingTool;
+    if (state.status !== 'interrupted' || !pending?.interruptionId)
+        return undefined;
+    return {
+        reason: 'tool_approval',
+        resumable: true,
+        requestedAt: new Date().toISOString(),
+        details: {
+            interruptionId: pending.interruptionId,
+            callId: pending.call.id,
+            toolName: pending.call.name,
+        },
+    };
+}
+function mapPendingSideEffects(state) {
+    const pending = state.pendingTool;
+    if (!pending || pending.effect === 'read')
+        return [];
+    return [{
+            sideEffectId: pending.call.id,
+            kind: `tool:${pending.call.name}`,
+            status: pending.status === 'committed'
+                ? 'succeeded'
+                : pending.status === 'started'
+                    ? 'started'
+                    : 'pending',
+            ...(pending.idempotencyKey === undefined ? {} : { idempotencyKey: pending.idempotencyKey }),
+            input: toStorageJson(pending.call.input),
+            ...(pending.result?.type === 'tool_result'
+                ? { output: toStorageJson(pending.result.output) }
+                : {}),
+        }];
+}
+export function toStorageJson(value) {
+    return toStorageJsonInternal(value, new Set());
+}
+function fromCheckpoint(checkpoint) {
+    if (!isSerializedRunState(checkpoint.state)) {
+        throw new TypeError(`Checkpoint "${checkpoint.checkpointId}" does not contain runtime-v2 state.`);
+    }
+    return structuredClone(checkpoint.state);
+}
+function isSerializedRunState(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const record = value;
+    return record.schemaVersion === 1
+        && typeof record.runId === 'string'
+        && typeof record.agentId === 'string'
+        && typeof record.agentConfigDigest === 'string'
+        && typeof record.status === 'string'
+        && typeof record.trace === 'object'
+        && Array.isArray(record.transcript)
+        && Array.isArray(record.generatedItems);
+}
+function toStorageJsonInternal(value, ancestors) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new TypeError('Checkpoint contains a non-finite number.');
+        return value;
+    }
+    if (typeof value !== 'object') {
+        throw new TypeError(`Checkpoint contains non-JSON value ${typeof value}.`);
+    }
+    if (ancestors.has(value))
+        throw new TypeError('Checkpoint contains a cyclic value.');
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((entry, index) => {
+                if (entry === undefined)
+                    throw new TypeError(`Checkpoint array contains undefined at ${index}.`);
+                return toStorageJsonInternal(entry, ancestors);
+            });
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError('Checkpoint contains a non-plain object.');
+        }
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (entry === undefined)
+                continue;
+            result[key] = toStorageJsonInternal(entry, ancestors);
+        }
+        return result;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=sqliteCheckpointAdapter.js.map

package/dist/src/node/sqliteCheckpointAdapter.js.map

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

package/dist/src/node/sqliteDurableChildStore.d.ts

@@ -0,0 +1,21 @@
+import type { DurableChildRecord, DurableChildStore } from '../orchestration/background.js';
+import { type CheckpointStore } from '../storage-v2/index.js';
+export interface SqliteDurableChildStoreOptions {
+    readonly store: CheckpointStore;
+    readonly tenantId: string;
+    readonly prefix?: string;
+}
+/** SQLite-backed durable child records with storage-level CAS and enumeration. */
+export declare class SqliteDurableChildStore implements DurableChildStore {
+    private readonly store;
+    private readonly tenantId;
+    private readonly prefix;
+    constructor(options: SqliteDurableChildStoreOptions);
+    create(record: DurableChildRecord): Promise<void>;
+    get(childId: string): Promise<DurableChildRecord | undefined>;
+    compareAndSet(childId: string, expectedRevision: number, next: DurableChildRecord): Promise<boolean>;
+    list(parentRunId?: string): Promise<readonly DurableChildRecord[]>;
+    private checkpointId;
+    private saveRequest;
+}
+//# sourceMappingURL=sqliteDurableChildStore.d.ts.map

package/dist/src/node/sqliteDurableChildStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteDurableChildStore.d.ts","sourceRoot":"","sources":["../../../src/node/sqliteDurableChildStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,8BAA8B;IAO7C,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAQ7D,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC;IAab,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAUxE,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;CAoBpB"}

package/dist/src/node/sqliteDurableChildStore.js

@@ -0,0 +1,124 @@
+import { StorageConflictError, } from '../storage-v2/index.js';
+import { toStorageJson } from './sqliteCheckpointAdapter.js';
+/** SQLite-backed durable child records with storage-level CAS and enumeration. */
+export class SqliteDurableChildStore {
+    store;
+    tenantId;
+    prefix;
+    constructor(options) {
+        if (!options.tenantId.trim())
+            throw new TypeError('tenantId must not be empty.');
+        this.store = options.store;
+        this.tenantId = options.tenantId;
+        this.prefix = options.prefix ?? 'orchestration-child:';
+    }
+    async create(record) {
+        if (record.revision !== 0)
+            throw new Error('New durable child revision must be zero.');
+        const saved = await this.store.save(this.saveRequest(record, null));
+        if (saved.revision !== record.revision)
+            throw new Error('Durable child create revision mismatch.');
+    }
+    async get(childId) {
+        const checkpoint = await this.store.load({
+            tenantId: this.tenantId,
+            checkpointId: this.checkpointId(childId),
+        });
+        return checkpoint ? checkpointToRecord(checkpoint) : undefined;
+    }
+    async compareAndSet(childId, expectedRevision, next) {
+        if (next.childId !== childId || next.revision !== expectedRevision + 1) {
+            throw new Error('Durable child CAS must advance exactly one revision.');
+        }
+        try {
+            const saved = await this.store.save(this.saveRequest(next, expectedRevision));
+            return saved.revision === next.revision;
+        }
+        catch (error) {
+            if (error instanceof StorageConflictError)
+                return false;
+            throw error;
+        }
+    }
+    async list(parentRunId) {
+        const checkpoints = await this.store.list({ tenantId: this.tenantId, limit: 100_000 });
+        return checkpoints
+            .filter(checkpoint => checkpoint.checkpointId.startsWith(this.prefix))
+            .map(checkpointToRecord)
+            .filter(record => parentRunId === undefined || record.parent.runId === parentRunId)
+            .sort((left, right) => left.createdAt.localeCompare(right.createdAt)
+            || left.childId.localeCompare(right.childId));
+    }
+    checkpointId(childId) {
+        if (!childId.trim())
+            throw new TypeError('childId must not be empty.');
+        return `${this.prefix}${encodeURIComponent(childId)}`;
+    }
+    saveRequest(record, expectedRevision) {
+        return {
+            tenantId: this.tenantId,
+            checkpointId: this.checkpointId(record.childId),
+            runId: record.childId,
+            sessionId: record.parent.tenantSession.sessionId,
+            expectedRevision,
+            status: checkpointStatus(record.status),
+            state: toStorageJson(record),
+            pendingSideEffects: pendingEffects(record),
+            traceContext: {
+                traceId: record.parent.trace.traceId,
+                spanId: record.parent.trace.spanId,
+                ...(record.parent.trace.parentSpanId
+                    ? { parentSpanId: record.parent.trace.parentSpanId }
+                    : {}),
+            },
+            updatedAt: record.updatedAt,
+        };
+    }
+}
+function checkpointStatus(status) {
+    return status === 'queued' ? 'running' : status;
+}
+function pendingEffects(record) {
+    if (record.effect === 'read')
+        return [];
+    const status = record.status === 'queued'
+        ? 'pending'
+        : record.status === 'running'
+            ? 'started'
+            : record.status === 'completed'
+                ? 'succeeded'
+                : record.status === 'failed'
+                    ? 'failed'
+                    : 'unknown';
+    return [{
+            sideEffectId: record.childId,
+            kind: `background:${record.agentId}`,
+            status,
+            ...(record.idempotencyKey ? { idempotencyKey: record.idempotencyKey } : {}),
+            input: toStorageJson(record.input),
+            ...(record.result ? { output: toStorageJson(record.result.output) } : {}),
+            ...(record.error ? { error: toStorageJson(record.error) } : {}),
+        }];
+}
+function checkpointToRecord(checkpoint) {
+    if (!isDurableChildRecord(checkpoint.state)) {
+        throw new TypeError(`Checkpoint "${checkpoint.checkpointId}" is not a durable child record.`);
+    }
+    if (checkpoint.state.revision !== checkpoint.revision) {
+        throw new TypeError(`Durable child "${checkpoint.state.childId}" revision does not match storage.`);
+    }
+    return structuredClone(checkpoint.state);
+}
+function isDurableChildRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const record = value;
+    return record.schemaVersion === 1
+        && typeof record.childId === 'string'
+        && typeof record.revision === 'number'
+        && typeof record.parent === 'object'
+        && typeof record.agentId === 'string'
+        && Array.isArray(record.input)
+        && typeof record.status === 'string';
+}
+//# sourceMappingURL=sqliteDurableChildStore.js.map

package/dist/src/node/sqliteDurableChildStore.js.map

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

package/dist/src/node/sqliteSessionAdapter.d.ts

@@ -0,0 +1,28 @@
+import type { InputItem } from '../core/index.js';
+import type { RuntimeSessionStore } from '../runtime-v2/state.js';
+import type { SessionStoreV2 } from '../storage-v2/index.js';
+export interface SqliteRuntimeSessionAdapterOptions {
+    readonly store: SessionStoreV2;
+}
+/** Canonical-item adapter for the append-only tenant-scoped session store. */
+export declare class SqliteRuntimeSessionAdapter implements RuntimeSessionStore {
+    private readonly options;
+    constructor(options: SqliteRuntimeSessionAdapterOptions);
+    close(): void;
+    load(request: {
+        readonly tenantId: string;
+        readonly sessionId: string;
+    }): Promise<{
+        readonly items: readonly InputItem[];
+        readonly revision: string;
+    }>;
+    append(request: {
+        readonly tenantId: string;
+        readonly sessionId: string;
+        readonly items: readonly InputItem[];
+        readonly expectedRevision: string;
+    }): Promise<{
+        readonly revision: string;
+    }>;
+}
+//# sourceMappingURL=sqliteSessionAdapter.d.ts.map

package/dist/src/node/sqliteSessionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSessionAdapter.d.ts","sourceRoot":"","sources":["../../../src/node/sqliteSessionAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,8EAA8E;AAC9E,qBAAa,2BAA4B,YAAW,mBAAmB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kCAAkC;IAExE,KAAK,IAAI,IAAI;IAIP,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB1E,MAAM,CAAC,OAAO,EAAE;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAiB3C"}

package/dist/src/node/sqliteSessionAdapter.js

@@ -0,0 +1,99 @@
+import { randomUUID } from 'node:crypto';
+import { convertLegacyJsonV1Message } from '../storage-v2/legacyJsonV1Items.js';
+import { toStorageJson } from './sqliteCheckpointAdapter.js';
+/** Canonical-item adapter for the append-only tenant-scoped session store. */
+export class SqliteRuntimeSessionAdapter {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    close() {
+        // The adapter does not own the shared DurableStorageV2 connection.
+    }
+    async load(request) {
+        let session = await this.options.store.get(request);
+        if (!session) {
+            try {
+                session = await this.options.store.create(request);
+            }
+            catch (error) {
+                // A concurrent creator may win between get/create. Re-read before surfacing it.
+                session = await this.options.store.get(request);
+                if (!session)
+                    throw error;
+            }
+        }
+        const loaded = await this.options.store.load({ ...request, afterSequence: 0 });
+        return {
+            items: loaded.items.flatMap(item => parseSessionItem(item.kind, item.payload, item.itemId)),
+            revision: String(loaded.session.revision),
+        };
+    }
+    async append(request) {
+        const expectedRevision = Number(request.expectedRevision);
+        if (!Number.isSafeInteger(expectedRevision) || expectedRevision < 0) {
+            throw new TypeError(`Invalid session revision "${request.expectedRevision}".`);
+        }
+        const saved = await this.options.store.append({
+            tenantId: request.tenantId,
+            sessionId: request.sessionId,
+            expectedRevision,
+            items: request.items.map(item => ({
+                itemId: item.id ?? randomUUID(),
+                kind: item.type,
+                payload: toStorageJson(item),
+            })),
+        });
+        return { revision: String(saved.revision) };
+    }
+}
+function parseSessionItem(kind, value, itemId) {
+    // JSON-v1 run records are audit metadata, not conversation messages. Accept
+    // both the final name and the name emitted by early storage-v2 previews.
+    if (kind === 'legacy_run' || kind === 'run')
+        return [];
+    if (kind === 'message' && !isCanonicalItem(value)) {
+        return convertLegacyJsonV1Message(value, `session item "${itemId}"`);
+    }
+    const item = parseCanonicalItem(value, itemId);
+    // Provider-specific blocks from an unknown legacy provider cannot safely be
+    // replayed to a different provider. They remain in the append journal for
+    // audit/export, but are intentionally omitted from the active transcript.
+    if (item.type === 'raw' && item.provider === 'legacy')
+        return [];
+    return [item];
+}
+function parseCanonicalItem(value, itemId) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError(`Session item "${itemId}" is not a canonical object.`);
+    }
+    const type = value.type;
+    if (typeof type !== 'string' || !CANONICAL_ITEM_TYPES.has(type)) {
+        throw new TypeError(`Session item "${itemId}" has unknown canonical type ${String(type)}.`);
+    }
+    return structuredClone(value);
+}
+function isCanonicalItem(value) {
+    return typeof value === 'object'
+        && value !== null
+        && !Array.isArray(value)
+        && typeof value.type === 'string'
+        && CANONICAL_ITEM_TYPES.has(value.type);
+}
+const CANONICAL_ITEM_TYPES = new Set([
+    'text',
+    'image',
+    'audio',
+    'document',
+    'artifact_ref',
+    'tool_call',
+    'tool_result',
+    'handoff_call',
+    'handoff_result',
+    'reasoning',
+    'raw',
+    'structured',
+    'refusal',
+    'error',
+]);
+//# sourceMappingURL=sqliteSessionAdapter.js.map

package/dist/src/node/sqliteSessionAdapter.js.map

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

package/dist/src/orchestration/agentTool.d.ts

@@ -0,0 +1,50 @@
+import { type AgentSpec, type JsonObject, type JsonValue, type ToolResultItem } from '../core/index.js';
+import type { RuntimeTool, ToolBehavior, ToolExecutionContext, ToolSchema } from '../runtime-v2/tools.js';
+import type { ChildFailurePolicy, ChildRunOutcome, ConversationState, OrchestrationInput, OrchestrationScope } from './contracts.js';
+import { ChildRunner } from './childRunner.js';
+export interface AgentToolOptions<TChildContext = unknown, TOutput = string> {
+    readonly name?: string;
+    readonly description?: string;
+    readonly mapInput?: (input: JsonValue) => OrchestrationInput;
+    readonly childContext?: (input: JsonValue) => TChildContext;
+    readonly failurePolicy?: ChildFailurePolicy;
+    readonly effect?: ToolBehavior['effect'];
+    readonly idempotencyKey?: (input: JsonValue) => string | undefined;
+    readonly metadata?: Readonly<JsonObject>;
+    readonly _output?: TOutput;
+}
+export interface AgentToolInvocation<TChildContext = unknown> {
+    readonly parent: OrchestrationScope;
+    readonly conversation: ConversationState;
+    readonly callId: string;
+    readonly input: JsonValue;
+    readonly context?: TChildContext;
+}
+export interface AgentToolInvocationResult<TOutput = string> {
+    readonly mode: 'agent-as-tool';
+    readonly ownerBefore: ConversationState['owner'];
+    readonly ownerAfter: ConversationState['owner'];
+    readonly conversation: ConversationState;
+    readonly toolResult: ToolResultItem;
+    readonly child: ChildRunOutcome<TOutput>;
+}
+export interface RuntimeToolAdapterOptions<TManagerContext> {
+    readonly scope: (managerContext: TManagerContext, execution: ToolExecutionContext<TManagerContext>) => OrchestrationScope;
+    readonly managerAgentId?: (managerContext: TManagerContext, execution: ToolExecutionContext<TManagerContext>) => string;
+    readonly inputSchema?: ToolSchema<JsonValue>;
+}
+/** Agent-as-tool is a child invocation; its internal transcript never takes ownership. */
+export declare class AgentTool<TChildContext = unknown, TOutput = string> {
+    readonly agent: AgentSpec<TChildContext, TOutput>;
+    private readonly runner;
+    private readonly options;
+    readonly name: string;
+    readonly description: string;
+    constructor(agent: AgentSpec<TChildContext, TOutput>, runner: ChildRunner, options?: AgentToolOptions<TChildContext, TOutput>);
+    invoke(invocation: AgentToolInvocation<TChildContext>): Promise<AgentToolInvocationResult<TOutput>>;
+    /** Adapter for runtime-v2 ToolRegistry; the manager runtime creates the final item. */
+    asRuntimeTool<TManagerContext>(adapter: RuntimeToolAdapterOptions<TManagerContext>): RuntimeTool<TManagerContext, JsonValue, JsonValue>;
+    private mapInput;
+}
+export declare function agentAsTool<TChildContext = unknown, TOutput = string>(agent: AgentSpec<TChildContext, TOutput>, runner: ChildRunner, options?: AgentToolOptions<TChildContext, TOutput>): AgentTool<TChildContext, TOutput>;
+//# sourceMappingURL=agentTool.d.ts.map

package/dist/src/orchestration/agentTool.d.ts.map

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