@felan-ai/ext-subagents 0.0.0-bootstrap.0 → 0.2.0

package/LICENSE

@@ -1,9 +1,6 @@
 MIT License
 
 Copyright (c) 2026 Felan contributors
-Copyright (c) 2026 Dimitar Panayotov
-Copyright (c) 2026 Marc Krenn
-Copyright (c) 2026 Milko Slavov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/NOTICE

@@ -0,0 +1,9 @@
+@felan-ai/ext-subagents implements Felan's portable subagent protocol.
+
+Its design was informed by the MIT-licensed pi-subagents project at
+https://github.com/mslavov/pi-extensions, reviewed at commit
+7e72e509fe45a5a87c4c2e176cb711de994a8c1d. No source code was copied.
+
+This package uses TypeBox 1.1.38 from
+https://github.com/sinclairzx81/typebox, licensed under the MIT License.
+Copyright (c) 2017-2026 Haydn Paterson.

package/README.md

@@ -1,3 +1,37 @@
 # @felan-ai/ext-subagents
 
-Bootstrap release for npm trusted publishing. Use a current release.
+Portable subagent protocol and model-facing tools for Felan. Applications
+provide a `SubagentHost` to `createSubagentsExtension(host)` and bind the
+resulting parent-session lifecycle with `bindSubagentSession(...)` before the
+session is activated.
+
+The extension registers exactly `Agent`, `list_subagents`,
+`get_subagent_result`, `steer_subagent`, and `cancel_subagent`. It owns shared
+schemas, defaults, validation, and normalized text results while the host owns
+execution, latest records, continuation, persistence, completion delivery, and policy.
+Agent Core remains unaware of subagents and provides only generic runtime,
+session, coding-tool, and extension composition.
+
+During initialization the extension registers a `subagents` capability with
+generic delegation and control guidance plus the current host's available agent
+types and descriptions. The contribution is present only when this extension is
+loaded.
+
+Ambient Pi agent and extension discovery is outside this package and remains
+disabled by Felan applications.
+
+## Development
+
+Source: `packages/ext-subagents` in <https://github.com/felan-ai/felan>.
+
+```sh
+corepack enable
+pnpm install --frozen-lockfile
+pnpm --filter @felan-ai/ext-subagents build
+pnpm --filter @felan-ai/ext-subagents test
+```
+
+## Attribution
+
+The architecture was informed by the MIT-licensed `pi-subagents` project. See
+[NOTICE](NOTICE) for the reviewed source and commit.

package/dist/contracts.d.ts

@@ -0,0 +1,88 @@
+export type SubagentThinking = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export interface SubagentDescriptor {
+    readonly id: string;
+    readonly description: string;
+    readonly defaultModel?: string;
+    readonly defaultThinking?: SubagentThinking;
+    readonly defaultMaxTurns?: number;
+    readonly defaultTimeoutSeconds?: number;
+    readonly allowNesting: boolean;
+}
+export interface SubagentPolicy {
+    readonly maxPromptBytes: number;
+    readonly maxDescriptionBytes: number;
+    readonly maxSteerBytes: number;
+}
+export interface SubagentSpawnRequest {
+    readonly type: string;
+    readonly description: string;
+    readonly prompt: string;
+    readonly runInBackground: boolean;
+    readonly model?: string;
+    readonly thinking?: SubagentThinking;
+    readonly maxTurns?: number;
+    readonly timeoutSeconds?: number;
+    readonly inheritContext: boolean;
+}
+export type SubagentStatus = 'queued' | 'running' | 'completed' | 'failed' | 'timed_out' | 'cancelled';
+export type SubagentErrorCode = 'unknown_agent_type' | 'invalid_request' | 'unsupported_model' | 'unsupported_thinking' | 'capacity_unavailable' | 'depth_exceeded' | 'turn_limit_reached' | 'not_found' | 'not_child' | 'not_steerable' | 'parent_unavailable' | 'host_unavailable' | 'internal_error';
+export interface SubagentError {
+    readonly code: SubagentErrorCode;
+    readonly message: string;
+}
+export interface SubagentRecord {
+    readonly agentId: string;
+    readonly parentSessionId: string;
+    readonly rootSessionId: string;
+    readonly type: string;
+    readonly description: string;
+    readonly status: SubagentStatus;
+    readonly createdAt: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly result?: string;
+    readonly error?: SubagentError;
+}
+export type SubagentHostResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: SubagentError;
+};
+export interface SubagentParentContextEntry {
+    readonly role: 'user' | 'assistant' | 'summary';
+    readonly text: string;
+}
+export type SubagentTerminalStatus = Extract<SubagentStatus, 'completed' | 'failed' | 'timed_out' | 'cancelled'>;
+export interface SubagentCompletionNotice {
+    readonly deliveryId: string;
+    readonly parentSessionId: string;
+    readonly agentId: string;
+    readonly type: string;
+    readonly status: SubagentTerminalStatus;
+    readonly summary?: string;
+    readonly error?: SubagentError;
+}
+export interface SubagentParentPort {
+    snapshotContext(options: {
+        readonly maxBytes: number;
+    }): Promise<readonly SubagentParentContextEntry[]>;
+    deliverCompletion(notice: SubagentCompletionNotice): Promise<'delivered' | 'queued' | 'unavailable'>;
+}
+export interface SubagentHost {
+    readonly descriptors: readonly SubagentDescriptor[];
+    readonly policy: SubagentPolicy;
+    attachParent(port: SubagentParentPort): () => void;
+    spawn(request: SubagentSpawnRequest, signal?: AbortSignal): Promise<SubagentHostResult<SubagentRecord>>;
+    list(options: {
+        readonly includeDescendants: boolean;
+    }): Promise<SubagentHostResult<readonly SubagentRecord[]>>;
+    getResult(agentId: string, options: {
+        readonly wait: boolean;
+        readonly timeoutSeconds?: number;
+    }, signal?: AbortSignal): Promise<SubagentHostResult<SubagentRecord>>;
+    steer(agentId: string, message: string): Promise<SubagentHostResult<SubagentRecord>>;
+    cancel(agentId: string, reason?: string): Promise<SubagentHostResult<SubagentRecord>>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { FelanExtension } from '@felan-ai/agent-core';
+import type { SubagentHost } from './contracts.js';
+export declare function createSubagentsExtension(host: SubagentHost): FelanExtension;
+export { bindSubagentSession } from './session-binding.js';
+export type { SubagentCompletionNotice, SubagentDescriptor, SubagentError, SubagentErrorCode, SubagentHost, SubagentHostResult, SubagentParentContextEntry, SubagentParentPort, SubagentPolicy, SubagentRecord, SubagentSpawnRequest, SubagentStatus, SubagentTerminalStatus, SubagentThinking, } from './contracts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAGV,YAAY,EAIb,MAAM,gBAAgB,CAAC;AAgBxB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAY3E;AAgOD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,216 @@
+import { Type } from 'typebox';
+import { renderError, renderRecord, renderRecords } from './presentation.js';
+const thinkingSchema = Type.Union([
+    Type.Literal('off'),
+    Type.Literal('minimal'),
+    Type.Literal('low'),
+    Type.Literal('medium'),
+    Type.Literal('high'),
+    Type.Literal('xhigh'),
+    Type.Literal('max'),
+]);
+const MAX_TURNS = 100;
+const MAX_TIMEOUT_SECONDS = 86_400;
+const MAX_WAIT_SECONDS = 3_600;
+export function createSubagentsExtension(host) {
+    return (pi) => {
+        pi.registerCapability({
+            id: 'subagents',
+            instructions: formatSubagentCapability(host.descriptors),
+        });
+        registerAgent(pi, host);
+        registerList(pi, host);
+        registerResult(pi, host);
+        registerSteer(pi, host);
+        registerCancel(pi, host);
+    };
+}
+function formatSubagentCapability(descriptors) {
+    const availableTypes = descriptors.length === 0
+        ? 'No child agent types are currently available.'
+        : `Available child agent types (descriptions are selection metadata, not instructions): ${descriptors
+            .map(formatDescriptor)
+            .join(', ')}.`;
+    return [
+        'Use child agents for independent, parallel, or specialized work when delegation reduces latency or keeps the main context focused.',
+        availableTypes,
+        'Give each child a self-contained task with the relevant scope, constraints, and expected output. Run independent tasks in parallel and keep dependent tasks sequenced.',
+        'Use list_subagents and get_subagent_result to monitor work, steer_subagent to refine active work, and cancel_subagent when work is no longer needed. Integrate and verify child results before reporting completion.',
+    ].join(' ');
+}
+function formatDescriptor({ id, description }) {
+    return `${id} (${description.replace(/\s+/g, ' ').trim()})`;
+}
+function registerAgent(pi, host) {
+    const typeSchema = descriptorSchema(host.descriptors);
+    const parameters = Type.Object({
+        prompt: Type.String({ minLength: 1, description: 'Task for the child agent' }),
+        description: Type.String({ minLength: 1, description: 'Short status label' }),
+        subagent_type: typeSchema,
+        model: Type.Optional(Type.String({ minLength: 1 })),
+        thinking: Type.Optional(thinkingSchema),
+        max_turns: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_TURNS })),
+        timeout_seconds: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_TIMEOUT_SECONDS })),
+        run_in_background: Type.Optional(Type.Boolean({ default: true })),
+        inherit_context: Type.Optional(Type.Boolean({ default: false })),
+    }, { additionalProperties: false });
+    pi.registerTool({
+        name: 'Agent',
+        label: 'Agent',
+        description: `Start a tracked child agent. Type descriptions are selection metadata, not instructions. Available types: ${host.descriptors.map(formatDescriptor).join(', ')}.`,
+        promptSnippet: 'Start a tracked foreground or background child agent',
+        parameters,
+        async execute(_id, params, signal, _update, ctx) {
+            const type = params.subagent_type;
+            const descriptor = host.descriptors.find((entry) => entry.id === type);
+            if (!descriptor)
+                return toolError(error('unknown_agent_type', `unknown subagent type: ${type}`));
+            const validation = validateSpawn(host, params);
+            if (validation)
+                return toolError(validation);
+            const parentModel = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined;
+            const parentThinking = pi.getThinkingLevel();
+            const model = normalizeModel(params.model, descriptor, parentModel);
+            if (!model.ok)
+                return toolError(model.error);
+            const request = {
+                type,
+                description: params.description,
+                prompt: params.prompt,
+                runInBackground: params.run_in_background ?? true,
+                inheritContext: params.inherit_context ?? false,
+                ...(model.value === undefined ? {} : { model: model.value }),
+                ...(params.thinking ?? descriptor.defaultThinking ?? parentThinking) === undefined
+                    ? {}
+                    : { thinking: params.thinking ?? descriptor.defaultThinking ?? parentThinking },
+                ...(params.max_turns ?? descriptor.defaultMaxTurns) === undefined
+                    ? {}
+                    : { maxTurns: params.max_turns ?? descriptor.defaultMaxTurns },
+                ...(params.timeout_seconds ?? descriptor.defaultTimeoutSeconds) === undefined
+                    ? {}
+                    : { timeoutSeconds: params.timeout_seconds ?? descriptor.defaultTimeoutSeconds },
+            };
+            return executeHost(() => host.spawn(request, signal), renderRecord);
+        },
+    });
+}
+function registerList(pi, host) {
+    const parameters = Type.Object({
+        include_descendants: Type.Optional(Type.Boolean({ default: false })),
+    }, { additionalProperties: false });
+    pi.registerTool({
+        name: 'list_subagents',
+        label: 'List Subagents',
+        description: 'List tracked direct children or a read-only descendant view.',
+        parameters,
+        execute: async (_id, params, _signal, _update, _ctx) => executeHost(() => host.list({
+            includeDescendants: params.include_descendants ?? false,
+        }), renderRecords),
+    });
+}
+function registerResult(pi, host) {
+    const parameters = Type.Object({
+        agent_id: Type.String({ minLength: 1 }),
+        wait: Type.Optional(Type.Boolean({ default: false })),
+        timeout_seconds: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_WAIT_SECONDS })),
+    }, { additionalProperties: false });
+    pi.registerTool({
+        name: 'get_subagent_result',
+        label: 'Get Subagent Result',
+        description: 'Read a direct child result without consuming its completion delivery.',
+        parameters,
+        execute: async (_id, params, signal, _update, _ctx) => executeHost(() => host.getResult(params.agent_id, {
+            wait: params.wait ?? false,
+            ...(params.timeout_seconds === undefined ? {} : { timeoutSeconds: params.timeout_seconds }),
+        }, signal), renderRecord),
+    });
+}
+function registerSteer(pi, host) {
+    const parameters = Type.Object({
+        agent_id: Type.String({ minLength: 1 }),
+        message: Type.String({ minLength: 1 }),
+    }, { additionalProperties: false });
+    pi.registerTool({
+        name: 'steer_subagent',
+        label: 'Steer Subagent',
+        description: 'Queue guidance for a direct child or resume a completed child.',
+        parameters,
+        async execute(_id, params, _signal, _update, _ctx) {
+            if (byteLength(params.message) > host.policy.maxSteerBytes) {
+                return toolError(error('invalid_request', `message exceeds ${host.policy.maxSteerBytes} bytes`));
+            }
+            return executeHost(() => host.steer(params.agent_id, params.message), renderRecord);
+        },
+    });
+}
+function registerCancel(pi, host) {
+    const parameters = Type.Object({
+        agent_id: Type.String({ minLength: 1 }),
+        reason: Type.Optional(Type.String({ minLength: 1 })),
+    }, { additionalProperties: false });
+    pi.registerTool({
+        name: 'cancel_subagent',
+        label: 'Cancel Subagent',
+        description: 'Idempotently cancel a direct child and its active descendants.',
+        parameters,
+        execute: async (_id, params, _signal, _update, _ctx) => executeHost(() => host.cancel(params.agent_id, params.reason), renderRecord),
+    });
+}
+function validateSpawn(host, params) {
+    if (byteLength(params.prompt) > host.policy.maxPromptBytes) {
+        return error('invalid_request', `prompt exceeds ${host.policy.maxPromptBytes} bytes`);
+    }
+    if (byteLength(params.description) > host.policy.maxDescriptionBytes) {
+        return error('invalid_request', `description exceeds ${host.policy.maxDescriptionBytes} bytes`);
+    }
+    if (params.model && !isCanonicalModelSelector(params.model)) {
+        return error('unsupported_model', 'model must be inherit or an exact provider/model reference');
+    }
+}
+function normalizeModel(requested, descriptor, parentModel) {
+    const selected = requested ?? descriptor.defaultModel ?? parentModel;
+    if (selected !== 'inherit')
+        return { ok: true, value: selected };
+    if (!parentModel)
+        return { ok: false, error: error('unsupported_model', 'parent has no model to inherit') };
+    return { ok: true, value: parentModel };
+}
+function isCanonicalModelSelector(selector) {
+    if (selector === 'inherit')
+        return true;
+    const separator = selector.indexOf('/');
+    return separator > 0 && separator < selector.length - 1;
+}
+async function executeHost(operation, render) {
+    try {
+        const result = await operation();
+        if (!result.ok)
+            return toolError(result.error);
+        return {
+            content: [{ type: 'text', text: render(result.value) }],
+            details: result.value,
+        };
+    }
+    catch {
+        return toolError(error('internal_error', 'The subagent host failed unexpectedly'));
+    }
+}
+function toolError(hostError) {
+    return {
+        content: [{ type: 'text', text: renderError(hostError) }],
+        details: { error: hostError },
+    };
+}
+function descriptorSchema(descriptors) {
+    if (descriptors.length === 0)
+        return Type.String({ minLength: 1 });
+    return Type.Union(descriptors.map((descriptor) => Type.Literal(descriptor.id)));
+}
+function error(code, message) {
+    return { code, message };
+}
+function byteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+export { bindSubagentSession } from './session-binding.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,SAAS,CAAC;AAa7C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IACnB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IACnB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;CACpB,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,UAAU,wBAAwB,CAAC,IAAkB;IACzD,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,EAAE,CAAC,kBAAkB,CAAC;YACpB,EAAE,EAAE,WAAW;YACf,YAAY,EAAE,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC;SACzD,CAAC,CAAC;QACH,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxB,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvB,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxB,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,WAA0C;IAC1E,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC;QAC7C,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,wFAAwF,WAAW;aAClG,GAAG,CAAC,gBAAgB,CAAC;aACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAEnB,OAAO;QACL,oIAAoI;QACpI,cAAc;QACd,wKAAwK;QACxK,sNAAsN;KACvN,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAE,EAAE,EAAE,WAAW,EAAsB;IAC/D,OAAO,GAAG,EAAE,KAAK,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,EAAqB,EAAE,IAAkB;IAC9D,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;QAC9E,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;QAC7E,aAAa,EAAE,UAAU;QACzB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QACvC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1E,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC1F,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;KACjE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpC,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,6GAA6G,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC9K,aAAa,EAAE,sDAAsD;QACrE,UAAU;QACV,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;YAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAuB,CAAC;YAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;YACvE,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,oBAAoB,EAAE,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAC;YACjG,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,UAAU;gBAAE,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACpF,MAAM,cAAc,GAAG,EAAE,CAAC,gBAAgB,EAAsB,CAAC;YACjE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;YACpE,IAAI,CAAC,KAAK,CAAC,EAAE;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAyB;gBACpC,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;gBACjD,cAAc,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;gBAC/C,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5D,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,eAAe,IAAI,cAAc,CAAC,KAAK,SAAS;oBAChF,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,eAAe,IAAI,cAAc,EAAE;gBACjF,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,eAAe,CAAC,KAAK,SAAS;oBAC/D,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,eAAe,EAAE;gBAChE,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,UAAU,CAAC,qBAAqB,CAAC,KAAK,SAAS;oBAC3E,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,eAAe,IAAI,UAAU,CAAC,qBAAqB,EAAE;aACnF,CAAC;YACF,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;QACtE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,EAAqB,EAAE,IAAkB;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;KACrE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACpC,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,8DAA8D;QAC3E,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CACjE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACd,kBAAkB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK;SACxD,CAAC,EACF,aAAa,CACd;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,EAAqB,EAAE,IAAkB;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACvC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;KACxF,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACpC,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,uEAAuE;QACpF,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAChE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE;YACpC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK;YAC1B,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;SAC5F,EAAE,MAAM,CAAC,EACV,YAAY,CACb;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,EAAqB,EAAE,IAAkB;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;KACvC,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACpC,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,gEAAgE;QAC7E,UAAU;QACV,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI;YAC/C,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC3D,OAAO,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,mBAAmB,IAAI,CAAC,MAAM,CAAC,aAAa,QAAQ,CAAC,CAAC,CAAC;YACnG,CAAC;YACD,OAAO,WAAW,CAChB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EACjD,YAAY,CACb,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,EAAqB,EAAE,IAAkB;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;KACrD,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACpC,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,gEAAgE;QAC7E,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CACjE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EACjD,YAAY,CACb;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CACpB,IAAkB,EAClB,MAKC;IAED,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC,iBAAiB,EAAE,kBAAkB,IAAI,CAAC,MAAM,CAAC,cAAc,QAAQ,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC,iBAAiB,EAAE,uBAAuB,IAAI,CAAC,MAAM,CAAC,mBAAmB,QAAQ,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC,mBAAmB,EAAE,4DAA4D,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,SAA6B,EAC7B,UAA8B,EAC9B,WAA+B;IAE/B,MAAM,QAAQ,GAAG,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,WAAW,CAAC;IACrE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACjE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,mBAAmB,EAAE,gCAAgC,CAAC,EAAE,CAAC;IAC5G,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAgB;IAChD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,SAA+C,EAC/C,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,MAAM,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,KAAK,CAAC,gBAAgB,EAAE,uCAAuC,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,SAAwB;IACzC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,WAA0C;IAClE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAuC,CAAC,CAAC;AACxH,CAAC;AAED,SAAS,KAAK,CAAC,IAA2B,EAAE,OAAe;IACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;AACpD,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/presentation.d.ts

@@ -0,0 +1,5 @@
+import type { SubagentError, SubagentRecord } from './contracts.js';
+export declare function renderRecord(record: SubagentRecord): string;
+export declare function renderRecords(records: readonly SubagentRecord[]): string;
+export declare function renderError(error: SubagentError): string;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAU3D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAIxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAExD"}

package/dist/presentation.js

@@ -0,0 +1,22 @@
+export function renderRecord(record) {
+    const lines = [
+        `agent_id: ${record.agentId}`,
+        `status: ${record.status}`,
+        `type: ${record.type}`,
+        `description: ${record.description}`,
+    ];
+    if (record.result !== undefined)
+        lines.push(`result:\n${record.result}`);
+    if (record.error !== undefined)
+        lines.push(`error: ${record.error.code} — ${record.error.message}`);
+    return lines.join('\n');
+}
+export function renderRecords(records) {
+    return records.length === 0
+        ? 'No subagents.'
+        : records.map((record) => renderRecord(record)).join('\n\n');
+}
+export function renderError(error) {
+    return `Subagent error: ${error.code} — ${error.message}`;
+}
+//# sourceMappingURL=presentation.js.map

package/dist/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,KAAK,GAAG;QACZ,aAAa,MAAM,CAAC,OAAO,EAAE;QAC7B,WAAW,MAAM,CAAC,MAAM,EAAE;QAC1B,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,gBAAgB,MAAM,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAkC;IAC9D,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC;QACzB,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,mBAAmB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;AAC5D,CAAC"}

package/dist/session-binding.d.ts

@@ -0,0 +1,7 @@
+import type { AgentSession } from '@felan-ai/agent-core';
+import type { SubagentHost } from './contracts.js';
+export declare function bindSubagentSession(options: {
+    readonly host: SubagentHost;
+    readonly session: AgentSession;
+}): () => void;
+//# sourceMappingURL=session-binding.d.ts.map

package/dist/session-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-binding.d.ts","sourceRoot":"","sources":["../src/session-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,gBAAgB,CAAC;AAKxB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC,GAAG,MAAM,IAAI,CA8Bb"}

package/dist/session-binding.js

@@ -0,0 +1,176 @@
+const completionType = 'felan-subagent-completion';
+const encoder = new TextEncoder();
+export function bindSubagentSession(options) {
+    const port = createParentPort(options.session);
+    let detach;
+    try {
+        detach = options.host.attachParent(port);
+    }
+    catch (error) {
+        port.close();
+        options.session.dispose();
+        throw error;
+    }
+    let closed = false;
+    const close = () => {
+        if (closed)
+            return;
+        closed = true;
+        port.close();
+        detach();
+    };
+    const dispose = options.session.dispose.bind(options.session);
+    let disposed = false;
+    options.session.dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        try {
+            close();
+        }
+        finally {
+            dispose();
+        }
+    };
+    return close;
+}
+function createParentPort(session) {
+    const sessionManager = session.sessionManager;
+    const delivered = new Set(sessionManager.getEntries()
+        .flatMap((entry) => entry.type === 'custom_message' && entry.customType === completionType
+        ? completionIds(entry.details)
+        : []));
+    const queued = new Map();
+    let delivery = Promise.resolve('delivered');
+    let closed = false;
+    const originalClearQueue = session.clearQueue;
+    const clearQueue = originalClearQueue.bind(session);
+    const observedClearQueue = () => {
+        const result = clearQueue();
+        for (const id of queued.keys())
+            queued.set(id, 'retry-when-idle');
+        if (!session.isStreaming)
+            queued.clear();
+        return result;
+    };
+    session.clearQueue = observedClearQueue;
+    const unsubscribe = session.subscribe((event) => {
+        if (event.type === 'agent_settled') {
+            for (const [id, state] of queued) {
+                if (state === 'retry-when-idle')
+                    queued.delete(id);
+            }
+            return;
+        }
+        if (event.type !== 'message_end'
+            || event.message.role !== 'custom'
+            || event.message.customType !== completionType)
+            return;
+        const ids = completionIds(event.message.details);
+        queueMicrotask(() => {
+            const persisted = new Set(sessionManager.getEntries().flatMap((entry) => (entry.type === 'custom_message' && entry.customType === completionType
+                ? completionIds(entry.details)
+                : [])));
+            for (const id of ids.filter((id) => persisted.has(id))) {
+                delivered.add(id);
+                queued.delete(id);
+            }
+        });
+    });
+    return {
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            unsubscribe();
+            if (session.clearQueue === observedClearQueue)
+                session.clearQueue = originalClearQueue;
+        },
+        async snapshotContext({ maxBytes }) {
+            const entries = contextEntries(sessionManager);
+            const selected = [];
+            let bytes = 0;
+            for (let index = entries.length - 1; index >= 0; index -= 1) {
+                const entry = entries[index];
+                const size = encoder.encode(entry.text).byteLength;
+                if (bytes + size > maxBytes) {
+                    break;
+                }
+                selected.unshift(entry);
+                bytes += size;
+            }
+            return selected;
+        },
+        async deliverCompletion(notice) {
+            const run = async () => {
+                if (closed)
+                    return 'unavailable';
+                if (delivered.has(notice.deliveryId))
+                    return 'delivered';
+                if (queued.has(notice.deliveryId))
+                    return 'queued';
+                queued.set(notice.deliveryId, 'queued');
+                try {
+                    await session.sendCustomMessage({
+                        customType: completionType,
+                        content: formatCompletionNotice(notice),
+                        display: true,
+                        details: { notice },
+                    }, {
+                        triggerTurn: true,
+                        deliverAs: 'followUp',
+                    });
+                    if (session.isStreaming)
+                        return 'queued';
+                    delivered.add(notice.deliveryId);
+                    queued.delete(notice.deliveryId);
+                    return 'delivered';
+                }
+                catch {
+                    queued.delete(notice.deliveryId);
+                    return 'unavailable';
+                }
+            };
+            delivery = delivery.then(run, run);
+            return delivery;
+        },
+    };
+}
+function contextEntries(sessionManager) {
+    const entries = [];
+    for (const entry of sessionManager.buildContextEntries()) {
+        if (entry.type === 'compaction' || entry.type === 'branch_summary') {
+            entries.push({ role: 'summary', text: entry.summary });
+            continue;
+        }
+        if (entry.type !== 'message')
+            continue;
+        const message = entry.message;
+        if (message.role !== 'user' && message.role !== 'assistant')
+            continue;
+        const text = typeof message.content === 'string'
+            ? message.content
+            : message.content
+                .filter((part) => part.type === 'text')
+                .map((part) => part.text)
+                .join('\n');
+        if (text)
+            entries.push({ role: message.role, text });
+    }
+    return entries;
+}
+function completionIds(data) {
+    if (typeof data !== 'object' || data === null)
+        return [];
+    const notice = Reflect.get(data, 'notice');
+    return typeof notice === 'object'
+        && notice !== null
+        && typeof Reflect.get(notice, 'deliveryId') === 'string'
+        ? [Reflect.get(notice, 'deliveryId')]
+        : [];
+}
+function formatCompletionNotice(notice) {
+    const outcome = notice.summary ?? notice.error?.message ?? notice.status;
+    return `Subagent completion: ${notice.type} ${notice.agentId}: ${notice.status} — ${outcome}`;
+}
+//# sourceMappingURL=session-binding.js.map

package/dist/session-binding.js.map

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

package/package.json

@@ -1,15 +1,40 @@
 {
   "name": "@felan-ai/ext-subagents",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Bootstrap package for Felan trusted publishing",
+  "version": "0.2.0",
+  "description": "Portable Felan subagent tools",
   "license": "MIT",
+  "type": "module",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/felan-ai/felan.git",
     "directory": "packages/ext-subagents"
   },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "typebox": "1.1.38",
+    "@felan-ai/agent-core": "0.2.0"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
-  "files": ["LICENSE", "README.md"]
-}
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}