@gixcopilot/headless 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ahmed khaled
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @gixcopilot/headless
+
+The framework-neutral chat layer shared by `@gixcopilot/react` and `@gixcopilot/angular`
+(extracted from the React SDK in Phase 12 so the Angular adapter reuses it instead of forking it).
+
+## Install
+
+```bash
+npm install @gixcopilot/headless
+```
+
+Requires Node.js >=22.12.0. ESM only.
+
+| Export | Purpose |
+| --- | --- |
+| `createChatStore(client, model?, threadId?, resolveContext?, resolveTools?, toolRuntime?)` | Immutable chat snapshot + `subscribe`/`getSnapshot` + stable actions (send, stop, retry, regenerate, clear, approve, reject, invokeTool). Consumed by React's `useSyncExternalStore` and Angular signals |
+| `createCopilotParts(options)` / `clearCopilotParts(parts)` | One copilot's context registry and engine, state store, frontend tool registry and runtime, generative-UI registry |
+| `createContextMessageResolver`, `createToolManifestResolver` | What each run sends: resolved context and the enabled frontend tool manifest (nothing when nothing is registered) |
+| `toGenerativeUIRequests` | Projects tool calls onto requests for *registered* components only |
+| `ChatSnapshot`, `CopilotMessage`, `ToolCallState`, `ApprovalState`, `AgentRunState`, `WorkflowRunState`, … | Shared state types (re-exported unchanged by `@gixcopilot/react`) |
+
+Application code normally uses a framework adapter; use this package directly to build an
+adapter for another framework. No DOM access, no framework imports.
+
+## Documentation
+
+- [react guide](https://github.com/AfoudaSWE/gix_ai_copilot_nx/blob/main/docs/guides/react.md)
+- [Getting started](https://github.com/AfoudaSWE/gix_ai_copilot_nx/blob/main/docs/guides/getting-started.md)
+- [Source](https://github.com/AfoudaSWE/gix_ai_copilot_nx/tree/main/packages/headless)
+
+## License
+
+MIT

package/dist/chat-store.d.ts

@@ -0,0 +1,42 @@
+import type { ClientModelReference, CopilotClient } from '@gixcopilot/client';
+import type { ToolManifestEntry } from '@gixcopilot/protocol';
+import type { ToolRuntime } from '@gixcopilot/tools';
+import type { ResolvedContext } from '@gixcopilot/context';
+import type { ChatSnapshot, CopilotAccess } from './types.js';
+/**
+ * Builds the frontend tool manifest to advertise on this run (Section 45-46), or `undefined`
+ * when nothing is registered - mirrors `ResolveContextMessage`'s "send exactly what Phase 4
+ * always sent when there's nothing to add" convention (Section 64).
+ */
+export type ResolveToolManifest = () => readonly ToolManifestEntry[] | undefined;
+/**
+ * A framework-independent chat store: an immutable snapshot plus subscribe/getSnapshot, the
+ * shape both React's `useSyncExternalStore` and an Angular signal bridge consume. Transport and
+ * runtime behavior stay in `@gixcopilot/client`; this only projects client runs into state.
+ */
+export interface ChatStore {
+    readonly access: CopilotAccess;
+    readonly getSnapshot: () => ChatSnapshot;
+    readonly getServerSnapshot: () => ChatSnapshot;
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly mount: () => void;
+    readonly dispose: () => void;
+}
+/**
+ * Resolves Phase 4 application context (if any) to prepend its content as
+ * a leading `system` message, or `undefined` when there is nothing to add - so a provider
+ * with no registered context sends exactly the same request Phase 3 always sent (Section
+ * 64). The provider bridges its context engine into this function (Section 33's
+ * "structured system message" placement decision - see
+ * docs/adr/0009-context-and-state-architecture.md).
+ *
+ * May return synchronously (`undefined`, when nothing is registered) instead of a `Promise`
+ * - `consume()` only `await`s when it actually gets one, so a provider with zero context
+ * items dispatches `client.run()` on the exact same tick Phase 3 always did, not one
+ * microtask later.
+ */
+export type ResolveContextMessage = () => Promise<ResolvedContext | undefined> | ResolvedContext | undefined;
+/** Creates the chat store for one copilot instance. Call `mount()` when it becomes active and
+ * `dispose()` when its owner is destroyed (cancels any active run). */
+export declare function createChatStore(client: CopilotClient, model?: ClientModelReference, threadId?: string, resolveContextMessage?: ResolveContextMessage, resolveToolManifest?: ResolveToolManifest, toolRuntime?: ToolRuntime): ChatStore;
+//# sourceMappingURL=chat-store.d.ts.map

package/dist/chat-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-store.d.ts","sourceRoot":"","sources":["../src/chat-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAa,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,KAAK,EAAgD,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAIV,YAAY,EACZ,aAAa,EAMd,MAAM,YAAY,CAAC;AAcpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;AAEjF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,YAAY,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,YAAY,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;AAY7G;uEACuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,CAAC,EAAE,oBAAoB,EAC5B,QAAQ,CAAC,EAAE,MAAM,EACjB,qBAAqB,CAAC,EAAE,qBAAqB,EAC7C,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,WAAW,CAAC,EAAE,WAAW,GACxB,SAAS,CA4lBX"}

package/dist/chat-store.js

@@ -0,0 +1,597 @@
+import { CopilotError, createMessageId, createThreadId } from '@gixcopilot/protocol';
+function summarizeContext(resolved) {
+    return {
+        items: resolved.items.map(({ id, name, scope, priority, sensitivity, estimatedTokens, truncated }) => ({ id, name, scope, priority, sensitivity, estimatedTokens, truncated })),
+        excluded: resolved.excluded.map(({ id, name, scope, reason }) => ({ id, name, scope, reason })),
+        estimatedTokens: resolved.estimatedTokens,
+        diagnostics: { ...resolved.diagnostics },
+    };
+}
+/** Creates the chat store for one copilot instance. Call `mount()` when it becomes active and
+ * `dispose()` when its owner is destroyed (cancels any active run). */
+export function createChatStore(client, model, threadId, resolveContextMessage, resolveToolManifest, toolRuntime) {
+    const initial = {
+        messages: [],
+        thread: null,
+        runId: null,
+        status: 'idle',
+        error: null,
+        usage: undefined,
+        finishReason: undefined,
+        toolCalls: [],
+        approvals: [],
+        agentRuns: [],
+        agentDelegations: [],
+        agentHandoffs: [],
+        workflowRuns: [],
+    };
+    let state = initial;
+    let active;
+    let enabled = true;
+    let replay;
+    const listeners = new Set();
+    function publish(next) {
+        state = next;
+        for (const listener of listeners)
+            listener();
+    }
+    function seal(status) {
+        return state.messages.map((message) => message.status === 'streaming' ? { ...message, status } : message);
+    }
+    function fail(error) {
+        publish({ ...state, messages: seal('error'), status: 'error', error });
+    }
+    function textOfContent(content) {
+        return content
+            .filter((part) => part.type === 'text')
+            .map((part) => part.text)
+            .join('');
+    }
+    function updateToolCall(id, patch) {
+        publish({
+            ...state,
+            toolCalls: state.toolCalls.map((toolCall) => toolCall.id === id ? { ...toolCall, ...patch } : toolCall),
+        });
+    }
+    function updateApproval(approvalId, patch) {
+        publish({
+            ...state,
+            approvals: state.approvals.map((approval) => approval.approvalId === approvalId ? { ...approval, ...patch } : approval),
+        });
+    }
+    function updateAgentRun(agentRunId, patch) {
+        publish({
+            ...state,
+            agentRuns: state.agentRuns.map((run) => (run.agentRunId === agentRunId ? { ...run, ...patch } : run)),
+        });
+    }
+    /** A workflow run is created lazily on its first observed event, then patched/merged - a
+     * client run may never involve a workflow at all (the common case), so nothing is
+     * pre-allocated (mirrors `agentRuns`/`toolCalls` only ever growing on a real event). */
+    function upsertWorkflowRun(workflowRunId, build) {
+        const existing = state.workflowRuns.find((run) => run.workflowRunId === workflowRunId);
+        const next = build(existing);
+        publish({
+            ...state,
+            workflowRuns: existing
+                ? state.workflowRuns.map((run) => (run.workflowRunId === workflowRunId ? next : run))
+                : [...state.workflowRuns, next],
+        });
+    }
+    function upsertWorkflowStep(workflowRunId, patch) {
+        upsertWorkflowRun(workflowRunId, (existing) => {
+            const base = existing ?? {
+                workflowRunId,
+                workflowId: '',
+                status: 'running',
+                steps: [],
+            };
+            const hasStep = base.steps.some((step) => step.stepId === patch.stepId && step.phase === patch.phase);
+            return {
+                ...base,
+                steps: hasStep
+                    ? base.steps.map((step) => (step.stepId === patch.stepId && step.phase === patch.phase ? patch : step))
+                    : [...base.steps, patch],
+            };
+        });
+    }
+    /**
+     * Executes a browser-registered frontend tool for a `tool.requested` event with
+     * `source: 'frontend'` (Section 45, 58), then reports the outcome back to the server
+     * (Section 50) so its suspended Model -> Tool -> Model loop can resume. Never throws -
+     * `toolRuntime.execute()` already normalizes every failure mode (unregistered tool,
+     * invalid arguments, a thrown error) into a `ToolResult`, which is what gets submitted
+     * either way.
+     */
+    async function executeFrontendTool(event, token) {
+        if (!toolRuntime)
+            return;
+        const controller = new AbortController();
+        token.frontendToolControllers.set(event.toolCallId, controller);
+        try {
+            const result = await toolRuntime.execute({
+                toolCallId: event.toolCallId,
+                name: event.name,
+                arguments: event.arguments,
+                context: { runId: event.runId, signal: controller.signal },
+            });
+            await client.submitToolResult(event.runId, event.toolCallId, result);
+        }
+        catch {
+            // The server's own frontendToolTimeoutMs (Section 51) is the safety net if this
+            // submission itself fails (e.g. the network dropped) - nothing further to do here.
+        }
+        finally {
+            token.frontendToolControllers.delete(event.toolCallId);
+        }
+    }
+    function receive(event, token) {
+        if (event.threadId !== state.thread?.id)
+            return;
+        if (!token.runId) {
+            if (event.type !== 'run.started' && event.type !== 'run.cancelled')
+                return;
+            token.runId = event.runId;
+        }
+        if (event.runId !== token.runId || event.sequence <= token.sequence)
+            return;
+        token.sequence = event.sequence;
+        switch (event.type) {
+            case 'run.started':
+                publish({ ...state, runId: event.runId });
+                break;
+            case 'message.started':
+                if (state.messages.some((message) => message.id === event.messageId))
+                    return;
+                publish({
+                    ...state,
+                    messages: [
+                        ...state.messages,
+                        {
+                            id: event.messageId,
+                            threadId: event.threadId,
+                            createdAt: event.timestamp,
+                            role: event.role,
+                            content: [],
+                            status: 'streaming',
+                        },
+                    ],
+                });
+                break;
+            case 'message.delta':
+                publish({
+                    ...state,
+                    status: 'streaming',
+                    error: null,
+                    messages: state.messages.map((message) => message.id === event.messageId && message.status === 'streaming'
+                        ? {
+                            ...message,
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: textOfContent(message.content) + event.delta,
+                                },
+                            ],
+                        }
+                        : message),
+                });
+                break;
+            case 'message.end':
+                publish({
+                    ...state,
+                    messages: state.messages.map((message) => message.id === event.messageId
+                        ? { ...message, content: event.content, status: 'complete' }
+                        : message),
+                });
+                break;
+            case 'run.completed':
+                active = undefined;
+                publish({
+                    ...state,
+                    messages: seal('complete'),
+                    status: 'completed',
+                    error: null,
+                    usage: event.usage,
+                    finishReason: event.finishReason,
+                });
+                break;
+            case 'run.cancelled':
+                active = undefined;
+                publish({
+                    ...state,
+                    messages: seal('stopped'),
+                    status: 'stopped',
+                    error: null,
+                    finishReason: 'cancelled',
+                    approvals: state.approvals.map((approval) => approval.status === 'pending' ? { ...approval, status: 'cancelled' } : approval),
+                    agentRuns: state.agentRuns.map((run) => (run.status === 'running' ? { ...run, status: 'cancelled' } : run)),
+                    workflowRuns: state.workflowRuns.map((run) => run.status === 'running' || run.status === 'paused' ? { ...run, status: 'cancelled' } : run),
+                });
+                break;
+            case 'run.failed':
+            case 'error':
+                active = undefined;
+                fail(event.error);
+                break;
+            case 'tool.requested':
+                if (state.toolCalls.some((toolCall) => toolCall.id === event.toolCallId))
+                    return;
+                publish({
+                    ...state,
+                    toolCalls: [
+                        ...state.toolCalls,
+                        {
+                            id: event.toolCallId,
+                            name: event.name,
+                            source: event.source,
+                            status: 'requested',
+                            arguments: event.arguments,
+                        },
+                    ],
+                });
+                if (event.source === 'frontend') {
+                    void executeFrontendTool(event, token);
+                }
+                break;
+            case 'tool.started':
+                updateToolCall(event.toolCallId, { status: 'running' });
+                break;
+            case 'tool.completed':
+                token.resolveAction?.({ status: 'success', toolCallId: event.toolCallId, data: event.result });
+                token.resolveAction = undefined;
+                updateToolCall(event.toolCallId, { status: 'succeeded', result: event.result });
+                break;
+            case 'tool.failed':
+                token.resolveAction?.({ status: 'error', toolCallId: event.toolCallId, error: event.error });
+                token.resolveAction = undefined;
+                updateToolCall(event.toolCallId, { status: 'failed', error: event.error });
+                break;
+            case 'approval.requested':
+                if (state.approvals.some((approval) => approval.approvalId === event.approvalId))
+                    return;
+                publish({
+                    ...state,
+                    status: 'waiting_for_approval',
+                    error: null,
+                    approvals: [
+                        ...state.approvals,
+                        {
+                            approvalId: event.approvalId,
+                            toolCallId: event.toolCallId,
+                            action: event.action,
+                            approvalLevel: event.approvalLevel,
+                            summary: event.summary,
+                            status: 'pending',
+                            risk: event.risk,
+                            reversibility: event.reversibility,
+                            expiresAt: event.expiresAt,
+                            preview: event.preview,
+                        },
+                    ],
+                });
+                break;
+            case 'approval.approved':
+                updateApproval(event.approvalId, { status: 'approved', decidedBy: event.decidedBy });
+                break;
+            case 'approval.rejected':
+                updateApproval(event.approvalId, { status: 'rejected', decidedBy: event.decidedBy });
+                break;
+            case 'approval.expired':
+                updateApproval(event.approvalId, { status: 'expired' });
+                break;
+            // Agent/workflow events, added in Phase 10 (Section 139-143) - structured facts only
+            // (Section 18, 140: no chain-of-thought), reusing the exact same event stream every
+            // other case in this switch already consumes; a client with no agent/workflow-aware
+            // backend simply never sees these event types at all.
+            case 'agent.run.started':
+                if (state.agentRuns.some((run) => run.agentRunId === event.agentRunId))
+                    return;
+                publish({
+                    ...state,
+                    agentRuns: [
+                        ...state.agentRuns,
+                        {
+                            agentRunId: event.agentRunId,
+                            agentId: event.agentId,
+                            rootRunId: event.rootRunId,
+                            parentRunId: event.parentRunId,
+                            status: 'running',
+                        },
+                    ],
+                });
+                break;
+            case 'agent.run.completed':
+                updateAgentRun(event.agentRunId, { status: 'completed' });
+                break;
+            case 'agent.run.failed':
+                updateAgentRun(event.agentRunId, { status: 'failed', error: event.error });
+                break;
+            case 'agent.run.cancelled':
+                updateAgentRun(event.agentRunId, { status: 'cancelled' });
+                break;
+            case 'agent.delegation.started':
+                if (state.agentDelegations.some((delegation) => delegation.delegationId === event.delegationId))
+                    return;
+                publish({
+                    ...state,
+                    agentDelegations: [
+                        ...state.agentDelegations,
+                        {
+                            delegationId: event.delegationId,
+                            fromAgentId: event.fromAgentId,
+                            toAgentId: event.toAgentId,
+                            depth: event.depth,
+                            status: 'started',
+                        },
+                    ],
+                });
+                break;
+            case 'agent.delegation.completed':
+                publish({
+                    ...state,
+                    agentDelegations: state.agentDelegations.map((delegation) => delegation.delegationId === event.delegationId
+                        ? { ...delegation, status: event.status, error: event.error }
+                        : delegation),
+                });
+                break;
+            case 'agent.handoff': {
+                const handoff = {
+                    fromAgentId: event.fromAgentId,
+                    toAgentId: event.toAgentId,
+                    reason: event.reason,
+                };
+                publish({ ...state, agentHandoffs: [...state.agentHandoffs, handoff] });
+                break;
+            }
+            case 'agent.routing.decided':
+                // Auditable (Section 47, 51, 182), but not yet surfaced through a dedicated headless
+                // hook - no UI requirement in this phase reads it. Recorded nowhere client-side for
+                // now; a future consumer can add a hook the same way this file's other cases do.
+                break;
+            case 'workflow.run.started':
+                upsertWorkflowRun(event.workflowRunId, () => ({
+                    workflowRunId: event.workflowRunId,
+                    workflowId: event.workflowId,
+                    status: 'running',
+                    steps: [],
+                }));
+                break;
+            case 'workflow.run.paused':
+                upsertWorkflowRun(event.workflowRunId, (existing) => ({
+                    ...(existing ?? { workflowRunId: event.workflowRunId, workflowId: event.workflowId, steps: [] }),
+                    status: 'paused',
+                    pauseReason: event.reason,
+                    pausedStepId: event.stepId,
+                }));
+                break;
+            case 'workflow.run.resumed':
+                upsertWorkflowRun(event.workflowRunId, (existing) => ({
+                    ...(existing ?? { workflowRunId: event.workflowRunId, workflowId: event.workflowId, steps: [] }),
+                    status: 'running',
+                    pauseReason: undefined,
+                    pausedStepId: undefined,
+                }));
+                break;
+            case 'workflow.run.completed':
+                upsertWorkflowRun(event.workflowRunId, (existing) => ({
+                    ...(existing ?? { workflowRunId: event.workflowRunId, workflowId: event.workflowId, steps: [] }),
+                    status: 'completed',
+                }));
+                break;
+            case 'workflow.run.failed':
+                upsertWorkflowRun(event.workflowRunId, (existing) => ({
+                    ...(existing ?? { workflowRunId: event.workflowRunId, workflowId: event.workflowId, steps: [] }),
+                    status: 'failed',
+                    error: event.error,
+                }));
+                break;
+            case 'workflow.run.cancelled':
+                upsertWorkflowRun(event.workflowRunId, (existing) => ({
+                    ...(existing ?? { workflowRunId: event.workflowRunId, workflowId: event.workflowId, steps: [] }),
+                    status: 'cancelled',
+                }));
+                break;
+            case 'workflow.step.started':
+                upsertWorkflowStep(event.workflowRunId, {
+                    stepId: event.stepId,
+                    stepType: event.stepType,
+                    status: 'running',
+                    attempt: event.attempt,
+                    phase: event.phase,
+                });
+                break;
+            case 'workflow.step.completed':
+                upsertWorkflowStep(event.workflowRunId, {
+                    stepId: event.stepId,
+                    stepType: state.workflowRuns
+                        .find((run) => run.workflowRunId === event.workflowRunId)
+                        ?.steps.find((step) => step.stepId === event.stepId && step.phase === event.phase)?.stepType ??
+                        'function',
+                    status: 'completed',
+                    attempt: event.attempt,
+                    phase: event.phase,
+                });
+                break;
+            case 'workflow.step.failed':
+                upsertWorkflowStep(event.workflowRunId, {
+                    stepId: event.stepId,
+                    stepType: state.workflowRuns
+                        .find((run) => run.workflowRunId === event.workflowRunId)
+                        ?.steps.find((step) => step.stepId === event.stepId && step.phase === event.phase)?.stepType ??
+                        'function',
+                    status: 'failed',
+                    attempt: event.attempt,
+                    phase: event.phase,
+                    error: event.error,
+                    willRetry: event.willRetry,
+                });
+                break;
+            case 'workflow.checkpoint.saved':
+                // The resumability audit trail (Section 100) - not yet surfaced through a dedicated
+                // headless hook, same posture as 'agent.routing.decided' above.
+                break;
+        }
+    }
+    async function consume(token, history) {
+        try {
+            if (active !== token || !enabled)
+                return;
+            const contextResult = resolveContextMessage?.();
+            const resolvedContext = contextResult instanceof Promise ? await contextResult : contextResult;
+            if (active !== token)
+                return; // Re-check: stop()/a new send may have run during the await.
+            if (resolvedContext)
+                publish({ ...state, contextDiagnostics: summarizeContext(resolvedContext) });
+            const contextContent = resolvedContext?.content;
+            const historyMessages = history.map(({ role, content }) => ({ role, content }));
+            const messages = contextContent
+                ? [{ role: 'system', content: [{ type: 'text', text: contextContent }] }, ...historyMessages]
+                : historyMessages;
+            token.handle = client.run({
+                threadId: state.thread?.id,
+                model,
+                messages,
+                tools: resolveToolManifest?.(),
+                action: token.action,
+            });
+            if (active !== token)
+                return;
+            for await (const event of token.handle.events) {
+                if (active !== token)
+                    break;
+                receive(event, token);
+                if (active !== token)
+                    break;
+            }
+            if (active === token) {
+                active = undefined;
+                fail(CopilotError.transport('The response ended before completion.').toPublicJSON());
+            }
+        }
+        catch (error) {
+            if (active === token) {
+                active = undefined;
+                fail((CopilotError.isCopilotError(error)
+                    ? error
+                    : CopilotError.transport('Unable to complete the request.', error)).toPublicJSON());
+            }
+        }
+        finally {
+            token.resolveAction?.({ status: 'error', toolCallId: 'cancelled', error: CopilotError.cancelled().toPublicJSON() });
+            token.resolveAction = undefined;
+            token.handle?.cancel();
+            abortFrontendToolCalls(token);
+        }
+    }
+    function abortFrontendToolCalls(token) {
+        for (const controller of token.frontendToolControllers.values()) {
+            controller.abort();
+        }
+        token.frontendToolControllers.clear();
+    }
+    function start(history, action, resolveAction) {
+        if (active || !enabled)
+            return false;
+        const token = { sequence: 0, frontendToolControllers: new Map(), action, resolveAction };
+        active = token;
+        replay = history;
+        publish({
+            ...state,
+            messages: history,
+            status: 'submitting',
+            error: null,
+            runId: null,
+            usage: undefined,
+            finishReason: undefined,
+            contextDiagnostics: undefined,
+            toolCalls: [],
+            approvals: [],
+            agentRuns: [],
+            agentDelegations: [],
+            agentHandoffs: [],
+            workflowRuns: [],
+        });
+        void consume(token, history);
+        return true;
+    }
+    const access = {
+        client,
+        invokeTool(name, args) {
+            return new Promise((resolve) => {
+                const accepted = start(state.messages.length ? state.messages : [{
+                        id: createMessageId(), threadId: state.thread?.id ?? createThreadId(), role: 'user',
+                        content: [{ type: 'text', text: `Requested action: ${name}` }],
+                        createdAt: new Date().toISOString(), status: 'complete',
+                    }], { name, arguments: args }, resolve);
+                if (!accepted)
+                    resolve({ status: 'error', toolCallId: 'busy', error: CopilotError.validation('A run is already active.').toPublicJSON() });
+            });
+        },
+        sendMessage(text) {
+            if (!text.trim() || active || !enabled)
+                return false;
+            const thread = state.thread ?? {
+                id: threadId ?? createThreadId(),
+                createdAt: new Date().toISOString(),
+            };
+            const message = {
+                id: createMessageId(),
+                threadId: thread.id,
+                role: 'user',
+                content: [{ type: 'text', text }],
+                createdAt: new Date().toISOString(),
+                status: 'complete',
+            };
+            state = { ...state, thread };
+            return start([...state.messages, message]);
+        },
+        stop() {
+            const token = active;
+            if (!token)
+                return;
+            active = undefined; // Invalidate BEFORE abort: late events cannot touch the next run.
+            token.handle?.cancel();
+            abortFrontendToolCalls(token);
+            publish({
+                ...state,
+                messages: seal('stopped'),
+                status: 'stopped',
+                error: null,
+                finishReason: 'cancelled',
+                approvals: state.approvals.map((approval) => approval.status === 'pending' ? { ...approval, status: 'cancelled' } : approval),
+                agentRuns: state.agentRuns.map((run) => (run.status === 'running' ? { ...run, status: 'cancelled' } : run)),
+                workflowRuns: state.workflowRuns.map((run) => run.status === 'running' || run.status === 'paused' ? { ...run, status: 'cancelled' } : run),
+            });
+        },
+        retry: () => state.status === 'error' && replay !== undefined && start(replay),
+        regenerate: () => (state.status === 'completed' || state.status === 'stopped') &&
+            replay !== undefined &&
+            start(replay),
+        clear() {
+            access.stop();
+            replay = undefined;
+            publish(initial);
+        },
+        approveAction: (approvalId, comment) => client.decideApproval(approvalId, 'approve', comment),
+        rejectAction: (approvalId, comment) => client.decideApproval(approvalId, 'reject', comment),
+    };
+    return {
+        access,
+        getSnapshot: () => state,
+        getServerSnapshot: () => initial,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        mount() {
+            enabled = true;
+        },
+        dispose() {
+            enabled = false;
+            access.stop();
+        },
+    };
+}
+//# sourceMappingURL=chat-store.js.map

package/dist/chat-store.js.map

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

package/dist/generative-ui.d.ts

@@ -0,0 +1,19 @@
+import type { AnyGenerativeComponentDefinition, GenerativeUiRenderResult } from '@gixcopilot/generative-ui';
+import type { ToolCallState } from './types.js';
+/** One model request to render a trusted, registered component (Phase 6), derived from the
+ * tool-call timeline. `props` exist only once the request succeeded and passed the
+ * component's schema validation in the tool runtime. */
+export interface GenerativeUIRequestState {
+    readonly id: string;
+    readonly component: string;
+    readonly status: 'requested' | 'running' | 'succeeded' | 'failed';
+    readonly props?: unknown;
+    readonly error?: ToolCallState['error'];
+}
+export declare function isGenerativeUiRenderResult(value: unknown): value is GenerativeUiRenderResult;
+/** Projects tool calls onto generative-UI requests for registered components only; a tool call
+ * naming an unregistered component is never turned into something renderable. */
+export declare function toGenerativeUIRequests(toolCalls: readonly ToolCallState[], registry: {
+    readonly list: () => readonly AnyGenerativeComponentDefinition[];
+}): readonly GenerativeUIRequestState[];
+//# sourceMappingURL=generative-ui.d.ts.map

package/dist/generative-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui.d.ts","sourceRoot":"","sources":["../src/generative-ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gCAAgC,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC5G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;wDAEwD;AACxD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAE5F;AAED;iFACiF;AACjF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,aAAa,EAAE,EACnC,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,gCAAgC,EAAE,CAAA;CAAE,GAC7E,SAAS,wBAAwB,EAAE,CAcrC"}

package/dist/generative-ui.js

@@ -0,0 +1,23 @@
+import { generativeUiComponentNameOfToolName } from '@gixcopilot/generative-ui';
+export function isGenerativeUiRenderResult(value) {
+    return typeof value === 'object' && value !== null && 'component' in value && 'props' in value;
+}
+/** Projects tool calls onto generative-UI requests for registered components only; a tool call
+ * naming an unregistered component is never turned into something renderable. */
+export function toGenerativeUIRequests(toolCalls, registry) {
+    const requests = [];
+    for (const toolCall of toolCalls) {
+        const component = generativeUiComponentNameOfToolName(toolCall.name, registry);
+        if (!component)
+            continue;
+        requests.push({
+            id: toolCall.id,
+            component,
+            status: toolCall.status,
+            props: toolCall.status === 'succeeded' && isGenerativeUiRenderResult(toolCall.result) ? toolCall.result.props : undefined,
+            error: toolCall.error,
+        });
+    }
+    return requests;
+}
+//# sourceMappingURL=generative-ui.js.map

package/dist/generative-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui.js","sourceRoot":"","sources":["../src/generative-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AAehF,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC;AACjG,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,sBAAsB,CACpC,SAAmC,EACnC,QAA8E;IAE9E,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,mCAAmC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS;YACT,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,WAAW,IAAI,0BAA0B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACzH,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createChatStore } from './chat-store.js';
+export type { ChatStore, ResolveContextMessage, ResolveToolManifest } from './chat-store.js';
+export { clearCopilotParts, createContextMessageResolver, createCopilotParts, createToolManifestResolver } from './parts.js';
+export type { CopilotParts } from './parts.js';
+export type { AgentDelegationState, AgentHandoffState, AgentRunState, ApprovalState, ChatActions, ChatSnapshot, ChatStatus, CopilotAccess, CopilotChatResult, CopilotContextOptions, CopilotMessage, ResolvedContextSummary, ToolCallState, WorkflowRunState, WorkflowStepState, } from './types.js';
+export { isGenerativeUiRenderResult, toGenerativeUIRequests } from './generative-ui.js';
+export type { GenerativeUIRequestState } from './generative-ui.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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7H,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createChatStore } from './chat-store.js';
+export { clearCopilotParts, createContextMessageResolver, createCopilotParts, createToolManifestResolver } from './parts.js';
+export { isGenerativeUiRenderResult, toGenerativeUIRequests } from './generative-ui.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,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAqB7H,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/parts.d.ts

@@ -0,0 +1,32 @@
+import type { ContextEngine, ContextRegistry, CopilotStateStore } from '@gixcopilot/context';
+import type { ToolRegistry, ToolRuntime } from '@gixcopilot/tools';
+import type { GenerativeComponentRegistry } from '@gixcopilot/generative-ui';
+import type { ResolveContextMessage, ResolveToolManifest } from './chat-store.js';
+import type { CopilotContextOptions } from './types.js';
+/**
+ * The framework-independent pieces one copilot instance owns: its application-context
+ * registry and engine (Phase 4), shared state store (Phase 4/6), frontend tool registry and
+ * the canonical tool runtime (Phase 5), and the trusted generative-UI component registry
+ * (Phase 6). Every framework adapter creates exactly one set per provider instance - never a
+ * module-level singleton - so sibling copilots never see each other's context, tools or state.
+ */
+export interface CopilotParts {
+    readonly registry: ContextRegistry;
+    readonly engine: ContextEngine;
+    readonly stateStore: CopilotStateStore;
+    readonly toolRegistry: ToolRegistry;
+    readonly toolRuntime: ToolRuntime;
+    readonly generativeComponentRegistry: GenerativeComponentRegistry;
+}
+export declare function createCopilotParts(options?: CopilotContextOptions): CopilotParts;
+/** Releases everything registered into `parts` (context items, frontend tools, components). */
+export declare function clearCopilotParts(parts: CopilotParts): void;
+/**
+ * Resolves registered application context for the next run, or `undefined` when nothing is
+ * registered - the fully synchronous fast path, so a copilot with no context dispatches on the
+ * same tick and sends exactly what Phase 3 always sent.
+ */
+export declare function createContextMessageResolver(parts: Pick<CopilotParts, 'registry' | 'engine'>): ResolveContextMessage;
+/** Builds the frontend tool manifest to advertise, or `undefined` when nothing is enabled. */
+export declare function createToolManifestResolver(parts: Pick<CopilotParts, 'toolRegistry'>): ResolveToolManifest;
+//# sourceMappingURL=parts.d.ts.map

package/dist/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../src/parts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;CACnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,qBAA0B,GAAG,YAAY,CAUpF;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG,qBAAqB,CAKpH;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG,mBAAmB,CAKzG"}

package/dist/parts.js

@@ -0,0 +1,40 @@
+import { createContextEngine, createContextRegistry, createCopilotStateStore } from '@gixcopilot/context';
+import { createDefaultToolResolver, createToolRegistry, createToolRuntime, isToolEnabled, toToolManifest } from '@gixcopilot/tools';
+import { createGenerativeComponentRegistry } from '@gixcopilot/generative-ui';
+export function createCopilotParts(options = {}) {
+    const toolRegistry = createToolRegistry();
+    return {
+        registry: createContextRegistry(),
+        engine: createContextEngine({ maxContextTokens: options.maxContextTokens, dataPolicy: options.dataPolicy }),
+        stateStore: createCopilotStateStore(),
+        toolRegistry,
+        toolRuntime: createToolRuntime({ resolver: createDefaultToolResolver(toolRegistry) }),
+        generativeComponentRegistry: createGenerativeComponentRegistry(),
+    };
+}
+/** Releases everything registered into `parts` (context items, frontend tools, components). */
+export function clearCopilotParts(parts) {
+    parts.registry.clear();
+    parts.toolRegistry.clear();
+    parts.generativeComponentRegistry.clear();
+}
+/**
+ * Resolves registered application context for the next run, or `undefined` when nothing is
+ * registered - the fully synchronous fast path, so a copilot with no context dispatches on the
+ * same tick and sends exactly what Phase 3 always sent.
+ */
+export function createContextMessageResolver(parts) {
+    return () => {
+        if (parts.registry.list({ enabledOnly: true }).length === 0)
+            return undefined;
+        return parts.engine.resolve(parts.registry);
+    };
+}
+/** Builds the frontend tool manifest to advertise, or `undefined` when nothing is enabled. */
+export function createToolManifestResolver(parts) {
+    return () => {
+        const enabled = parts.toolRegistry.list().filter(isToolEnabled);
+        return enabled.length === 0 ? undefined : toToolManifest(enabled);
+    };
+}
+//# sourceMappingURL=parts.js.map

package/dist/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../src/parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE1G,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpI,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAqB9E,MAAM,UAAU,kBAAkB,CAAC,UAAiC,EAAE;IACpE,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAC1C,OAAO;QACL,QAAQ,EAAE,qBAAqB,EAAE;QACjC,MAAM,EAAE,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3G,UAAU,EAAE,uBAAuB,EAAE;QACrC,YAAY;QACZ,WAAW,EAAE,iBAAiB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,YAAY,CAAC,EAAE,CAAC;QACrF,2BAA2B,EAAE,iCAAiC,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACvB,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC3B,KAAK,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAgD;IAC3F,OAAO,GAAG,EAAE;QACV,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9E,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,0BAA0B,CAAC,KAAyC;IAClF,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Framework-neutral chat types shared by every framework adapter (React, Angular). Moved
+ * here from `@gixcopilot/react` in Phase 12; `@gixcopilot/react` re-exports them unchanged.
+ */
+import type { CopilotClient } from '@gixcopilot/client';
+import type { Message, PublicCopilotError, RunId, Thread, ToolActionPreview, ToolActionRisk, ToolActionReversibility, ToolApprovalLevel, ToolCallId, ToolResult, ToolSource, Usage, FinishReason } from '@gixcopilot/protocol';
+import type { ContextDiagnostics, ContextExclusion, ResolvedContextItem } from '@gixcopilot/context';
+/** Serializable context metadata for the current run. Item content is never retained. */
+export interface ResolvedContextSummary {
+    readonly items: readonly Pick<ResolvedContextItem, 'id' | 'name' | 'scope' | 'priority' | 'sensitivity' | 'estimatedTokens' | 'truncated'>[];
+    readonly excluded: readonly Pick<ContextExclusion, 'id' | 'name' | 'scope' | 'reason'>[];
+    readonly estimatedTokens: number;
+    readonly diagnostics: ContextDiagnostics;
+}
+/** A protocol message with local presentation metadata; wire content is unchanged. */
+export interface CopilotMessage extends Message {
+    readonly status: 'complete' | 'streaming' | 'stopped' | 'error';
+}
+/** Exactly one generation state is observable at a time. */
+export type ChatStatus = 'idle' | 'submitting' | 'streaming' | 'waiting_for_approval' | 'completed' | 'stopped' | 'error';
+/**
+ * Headless tool activity state (Section 59-61, added in Phase 5) - a generic timeline of
+ * every tool call in the current run, regardless of origin, for a custom/headless UI (or the
+ * default `CopilotChat` activity rendering) to display without parsing raw protocol events
+ * itself. `arguments`/`result` are present for an advanced consumer that explicitly wants
+ * them; the *default* UI intentionally does not render them (Section 60).
+ */
+export interface ToolCallState {
+    readonly id: ToolCallId;
+    readonly name: string;
+    readonly source: ToolSource;
+    readonly status: 'requested' | 'running' | 'succeeded' | 'failed';
+    readonly arguments: Readonly<Record<string, unknown>>;
+    readonly result?: unknown;
+    readonly error?: PublicCopilotError;
+}
+/**
+ * Headless approval state (Phase 7, Section 76, 81-82) - a per-run timeline of every action
+ * that paused for human approval, mirroring `ToolCallState`'s own pattern so a custom/
+ * headless approval UI never needs to parse raw `approval.*` protocol events itself.
+ */
+export interface ApprovalState {
+    readonly approvalId: string;
+    readonly toolCallId: ToolCallId;
+    readonly action: string;
+    readonly approvalLevel: ToolApprovalLevel;
+    readonly summary: string;
+    readonly status: 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled';
+    readonly risk?: ToolActionRisk;
+    readonly reversibility?: ToolActionReversibility;
+    readonly expiresAt?: string;
+    readonly preview?: ToolActionPreview;
+    readonly decidedBy?: string;
+}
+/**
+ * Headless agent-run progress (Phase 10, Section 139-143) - one entry per agent run that
+ * occurred during the current client run, including every delegated/handed-off child run
+ * (each carries its own `agentRunId`; `rootRunId`/`parentRunId` let a consumer reconstruct
+ * the tree if it wants one). Mirrors `ToolCallState`'s "generic timeline, no
+ * chain-of-thought" posture (Section 18, 140) - only structured facts, never raw model
+ * reasoning.
+ */
+export interface AgentRunState {
+    readonly agentRunId: string;
+    readonly agentId: string;
+    readonly rootRunId?: RunId;
+    readonly parentRunId?: RunId;
+    readonly status: 'running' | 'completed' | 'failed' | 'cancelled';
+    readonly error?: PublicCopilotError;
+}
+/** One delegation (A -> B -> A, Section 56-58) observed during the current client run. */
+export interface AgentDelegationState {
+    readonly delegationId: string;
+    readonly fromAgentId: string;
+    readonly toAgentId: string;
+    readonly depth: number;
+    readonly status: 'started' | 'completed' | 'failed';
+    readonly error?: PublicCopilotError;
+}
+/** One handoff (A -> B, B becomes active, Section 61-65) observed during the current client
+ * run. */
+export interface AgentHandoffState {
+    readonly fromAgentId: string;
+    readonly toAgentId: string;
+    readonly reason: string;
+}
+/**
+ * Headless workflow-step progress (Phase 10, Section 139-143) - one entry per step attempt of
+ * the current workflow run. `attempt`/`phase` mirror the underlying
+ * `workflow.step.*` events (Section 117, 121, 202's retry/compensation reuse of this one
+ * event triad).
+ */
+export interface WorkflowStepState {
+    readonly stepId: string;
+    readonly stepType: 'function' | 'tool' | 'agent' | 'approval' | 'condition' | 'parallel';
+    readonly status: 'running' | 'completed' | 'failed';
+    readonly attempt: number;
+    readonly phase?: 'forward' | 'compensation';
+    readonly error?: PublicCopilotError;
+    readonly willRetry?: boolean;
+}
+/** Headless workflow-run progress (Phase 10, Section 139-143), mirroring `AgentRunState`. */
+export interface WorkflowRunState {
+    readonly workflowRunId: string;
+    readonly workflowId: string;
+    readonly status: 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+    readonly pauseReason?: 'approval' | 'checkpoint' | 'manual' | 'external-event';
+    readonly pausedStepId?: string;
+    readonly error?: PublicCopilotError;
+    readonly steps: readonly WorkflowStepState[];
+}
+interface ChatSnapshotBase {
+    readonly messages: readonly CopilotMessage[];
+    readonly thread: Thread | null;
+    readonly runId: string | null;
+    readonly usage: Usage | undefined;
+    readonly finishReason: FinishReason | undefined;
+    /** Resolved context metadata for this run, without any item text or values. */
+    readonly contextDiagnostics?: ResolvedContextSummary;
+    /** Cleared at the start of every new run (Section 59) - this is per-turn activity, not a
+     * persistent tool-call history across the whole conversation. */
+    readonly toolCalls: readonly ToolCallState[];
+    /** Cleared at the start of every new run, same as `toolCalls` above. */
+    readonly approvals: readonly ApprovalState[];
+    /** Cleared at the start of every new run, same as `toolCalls` above (Phase 10). */
+    readonly agentRuns: readonly AgentRunState[];
+    readonly agentDelegations: readonly AgentDelegationState[];
+    readonly agentHandoffs: readonly AgentHandoffState[];
+    readonly workflowRuns: readonly WorkflowRunState[];
+}
+/** Immutable chat snapshot. Errors exist only in the error state. */
+export type ChatSnapshot = ChatSnapshotBase & ({
+    readonly status: Exclude<ChatStatus, 'error'>;
+    readonly error: null;
+} | {
+    readonly status: 'error';
+    readonly error: PublicCopilotError;
+});
+/** Actions are stable for the lifetime of a provider configuration. */
+export interface ChatActions {
+    readonly invokeTool: (name: string, args: Readonly<Record<string, unknown>>) => Promise<ToolResult>;
+    /** Accept a nonblank user turn unless busy/disposed. True means accepted, not completed. */
+    readonly sendMessage: (text: string) => boolean;
+    /** Cancel the actual client run, preserving partial text. */
+    readonly stop: () => void;
+    /** Replay the failed turn with the same user message and replace its partial answer. */
+    readonly retry: () => boolean;
+    /** Replace the latest completed/stopped answer by replaying its user turn. */
+    readonly regenerate: () => boolean;
+    /** Cancel and reset local history/thread; does not delete server data. */
+    readonly clear: () => void;
+    /** Phase 7, Section 83 - approves a pending action. Resolves once the server accepts the
+     * decision; the resulting state update itself still arrives as an `approval.approved`
+     * event on the run, same as any other server-driven state change. */
+    readonly approveAction: (approvalId: string, comment?: string) => Promise<void>;
+    readonly rejectAction: (approvalId: string, comment?: string) => Promise<void>;
+}
+/** Full headless chat subscription plus stable actions. */
+export type CopilotChatResult = ChatSnapshot & ChatActions;
+/** Stable SDK access without subscribing to token updates. */
+export interface CopilotAccess extends ChatActions {
+    readonly client: CopilotClient;
+}
+/** Phase 4 application-context tuning (Section 25). Omit for the engine's own default. */
+export interface CopilotContextOptions {
+    readonly dataPolicy?: {
+        redact(data: unknown): unknown;
+    };
+    /** Total token budget resolved application context may consume. Default 8000. */
+    readonly maxContextTokens?: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,KAAK,EACL,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,EACL,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErG,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,CAAC,EAAE,CAAC;IAC7I,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC;IACzF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;CACjE;AAED,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1H;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED;UACU;AACV,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IACzF,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IACrD;qEACiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD;AAED,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,gBAAgB,GACzC,CACI;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CACnE,CAAC;AAEJ,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACpG,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B;;yEAEqE;IACrE,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,QAAQ,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,WAAW,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,0FAA0F;AAC1F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAC;IACzD,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@gixcopilot/headless",
+  "version": "0.1.0",
+  "description": "Framework-neutral chat store and copilot composition shared by the React and Angular adapters.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AfoudaSWE/gix_ai_copilot_nx.git",
+    "directory": "packages/headless"
+  },
+  "homepage": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/tree/main/packages/headless#readme",
+  "bugs": {
+    "url": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.spec.*",
+    "!dist/**/*.spec-helper.*",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@gixcopilot/client": "0.1.0",
+    "@gixcopilot/tools": "0.1.0",
+    "@gixcopilot/context": "0.1.0",
+    "@gixcopilot/generative-ui": "0.1.0",
+    "@gixcopilot/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "5.0.1",
+    "zod": "4.6.5"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}