dsh-a2a-server 0.1.0

package/lib/index.js

@@ -0,0 +1,505 @@
+/**
+ * Inbound A2A protocol server for DeepSeek Harness.
+ *
+ * Publishes an Agent Card at a well-known URI and serves the A2A v0.3.0
+ * JSON-RPC binding, so any compliant peer that knows this deployment's URL can
+ * discover it and submit tasks to a harness agent. There is no outbound client:
+ * this plugin never connects to another agent.
+ *
+ * It is a TRANSPORT ADAPTER, not a capability seam — the same self-limitation
+ * `dsh-acp` states. It exposes no editor navigation, transcript replay,
+ * commands, modes, or tool presentation.
+ *
+ * @module dsh-a2a-server
+ */
+import { randomUUID } from 'node:crypto';
+import { mkdir, access } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { A2AContextId, A2ATaskId, buildAgentCard, nowIso, } from "./protocol/index.js";
+import { assertConfigCoherent, Config } from "./config.js";
+import { ContextRegistry } from "./contexts.js";
+import { identifyPeer, RateLimiter, TurnTracker } from "./security.js";
+import { artifactsFromTexts, createSlot, stateFromEnding } from "./tasks.js";
+import { createRouter } from "./router.js";
+import { a2aTaskProjection } from "./projection.js";
+export { Config };
+export const name = 'a2a-server';
+/**
+ * The server creates and owns agents, needs an HTTP carrier for its routes, and
+ * cannot authenticate a single request without the credential seam. Everything
+ * else it uses is probed with `ctx.get()` so a composition missing an optional
+ * capability still boots with A2A serving.
+ */
+export const inject = ['agents', 'webServer', 'credentials'];
+/**
+ * Mount the inbound A2A server.
+ * @param ctx - the Cordis context carrying the agent factory, HTTP carrier, and credentials.
+ * @param config - the validated plugin configuration.
+ */
+export function apply(ctx, config) {
+    assertConfigCoherent(config);
+    // Handlers run on node's IO callbacks, outside this fiber's injection scope.
+    // Snapshot the injected services here; validate individual object liveness
+    // lazily at each use, because an agent-loop-only reload disposes agents while
+    // our records survive.
+    const agents = ctx.agents;
+    const webServer = ctx.webServer;
+    const credentials = ctx.credentials;
+    const logger = ctx.logger;
+    const contexts = new ContextRegistry(config.maxResidentContexts, config.contextIdleTtlMs);
+    const rateLimiter = new RateLimiter(config.rateLimitPerMinute);
+    const turns = new TurnTracker();
+    let closed = false;
+    /** Reject a request that arrives while teardown is in progress. */
+    const assertOpen = () => {
+        if (closed)
+            throw new Error('the A2A server has been disposed');
+    };
+    /**
+     * Return the Activation owning this agent, rejecting same-id impostors.
+     *
+     * Identity is compared by object reference, not session id: a reload can
+     * rebuild an agent under the same id, and routing events to the replacement
+     * would silently cross wires.
+     */
+    const ownedActivation = (agent) => {
+        const activation = contexts.lookup(A2AContextId(agent.session.id), '');
+        if (typeof activation === 'string') {
+            // Ownership check is peer-scoped; for event routing we only need identity.
+            const direct = contexts.values().find(a => a.agent === agent);
+            return direct;
+        }
+        return activation.agent === agent ? activation : undefined;
+    };
+    // ── Resolve declared peer credentials ──────────────────────────────────
+    /**
+     * Resolve every declared peer's secret.
+     *
+     * The seam's rule is to resolve per operation and never cache across them —
+     * that read is what makes a rotated credential reach the very next request.
+     */
+    const resolvePeerSecrets = async () => {
+        const resolved = new Map();
+        for (const [peer, entry] of Object.entries(config.peers)) {
+            const hit = await credentials.resolve(entry.tokenEnv);
+            if (hit !== undefined && hit.value.length > 0)
+                resolved.set(peer, hit.value);
+        }
+        return resolved;
+    };
+    // Activation-time completeness check. `describe()` never holds a value; it
+    // only answers whether a reference is configured. A peer declared here but
+    // unconfigured would otherwise receive 401 forever with no diagnostic.
+    ctx.effect(() => {
+        void (async () => {
+            const missing = [];
+            for (const [peer, entry] of Object.entries(config.peers)) {
+                try {
+                    const info = await credentials.describe(entry.tokenEnv);
+                    if (info === undefined || !info.configured)
+                        missing.push(`${peer} (${entry.tokenEnv})`);
+                }
+                catch {
+                    missing.push(`${peer} (${entry.tokenEnv})`);
+                }
+            }
+            if (missing.length > 0) {
+                logger.error(`a2a: declared peers have no configured credential and can never authenticate: ${missing.join(', ')}`);
+            }
+            if (Object.keys(config.peers).length === 0) {
+                logger.warn('a2a: no peers declared; every request will be rejected as unauthorized');
+            }
+        })();
+        return () => { };
+    }, 'a2a.credentialCheck');
+    // ── Workspace resolution ───────────────────────────────────────────────
+    const workspaceFor = (peer) => {
+        const override = config.isolation.peerWorkspaces[peer];
+        if (override !== undefined)
+            return override;
+        return config.isolation.workspaceMode === 'shared'
+            ? config.isolation.workspaceRoot
+            : join(config.isolation.workspaceRoot, peer);
+    };
+    /**
+     * Create the workspace directory and prove it is enterable.
+     *
+     * A failure here refuses the request rather than falling back to a shared
+     * directory: silently downgrading isolation is the one outcome worse than an
+     * error, since nothing downstream would ever report it.
+     */
+    const ensureWorkspace = async (cwd) => {
+        if (!isAbsolute(cwd))
+            throw new Error(`workspace must be an absolute path: ${cwd}`);
+        await mkdir(cwd, { recursive: true });
+        await access(cwd, constants.X_OK);
+    };
+    // ── Public URL ─────────────────────────────────────────────────────────
+    /**
+     * The URL peers should post to.
+     *
+     * Never the webserver's bind address: that is typically 127.0.0.1, and
+     * publishing it on a card served through a reverse proxy is always wrong.
+     */
+    const publicUrl = (hostHeader) => {
+        if (config.publicUrl !== undefined)
+            return config.publicUrl;
+        const host = hostHeader ?? `127.0.0.1:${webServer.port}`;
+        return `http://${host}${config.basePath}`;
+    };
+    const cardFor = (hostHeader) => buildAgentCard({
+        name: config.card.name,
+        description: config.card.description,
+        version: '0.1.0',
+        url: publicUrl(hostHeader),
+        protocolVersion: config.protocolVersion,
+        skills: config.card.skills,
+        streaming: true,
+        pushNotifications: config.push.enabled,
+        authRequired: true,
+        // An organization-less provider block is the schema's shape for "omitted",
+        // and A2A readers expect the member to be absent rather than blank.
+        ...config.card.provider === undefined || config.card.provider.organization.length === 0
+            ? {}
+            : { provider: config.card.provider },
+    });
+    // ── Durable task edges ─────────────────────────────────────────────────
+    /**
+     * Append one `a2a/task` lifecycle edge to the context's own session log.
+     *
+     * This is what makes `tasks/get` answerable after a restart: the state lives
+     * in the append-only log, not in this process's memory.
+     */
+    const appendTaskEdge = (activation, taskId, state, extra = {}) => {
+        try {
+            activation.agent.session.append('a2a/task', {
+                taskId,
+                peer: activation.peer,
+                state,
+                ...extra.turn === undefined ? {} : { turn: extra.turn },
+                ...extra.stopReason === undefined ? {} : { stopReason: extra.stopReason },
+                ...extra.output === undefined ? {} : { output: extra.output },
+            });
+        }
+        catch (error) {
+            // A log append failure must not take down the request: the peer still
+            // gets a correct answer for THIS exchange; only durability is lost.
+            logger.warn(`a2a: could not append a2a/task edge: ${String(error)}`);
+        }
+    };
+    // ── Event wiring: the three-stage correlation ──────────────────────────
+    ctx.on('agent/inbox/claimed', ({ agent, message, turn }) => {
+        const activation = ownedActivation(agent);
+        if (activation === undefined)
+            return;
+        for (const slot of activation.slots.values()) {
+            if (slot.messageId === message.id && slot.turn === undefined) {
+                slot.turn = turn;
+                appendTaskEdge(activation, slot.taskId, 'working', { turn });
+                return;
+            }
+        }
+    });
+    ctx.on('session/event', (session, event) => {
+        const activation = contexts.values().find(a => a.agent.session === session);
+        if (activation === undefined)
+            return;
+        if (event.type === 'assistant/message') {
+            // Committed messages only. Raw chunks and retry attempts are presentation
+            // and trace data; letting them onto the wire would leak text the agent
+            // later discarded.
+            for (const block of event.data.message.content) {
+                if (block.type === 'text' && block.text.length > 0) {
+                    for (const slot of activation.slots.values())
+                        slot.texts.push(block.text);
+                }
+            }
+            return;
+        }
+        if (event.type === 'turn/end') {
+            const reason = String(event.data.reason.kind ?? 'unknown');
+            for (const slot of activation.slots.values()) {
+                if (slot.turn !== event.data.turn)
+                    continue;
+                if (reason === 'error') {
+                    // A model error on the correlated turn fails the task immediately
+                    // rather than waiting out whole-agent quiescence.
+                    settleSlot(activation, slot, 'failed', reason);
+                }
+                else {
+                    slot.endReason = reason;
+                }
+            }
+        }
+    });
+    ctx.on('agent/error', ({ agent, turn }) => {
+        const activation = ownedActivation(agent);
+        if (activation === undefined)
+            return;
+        for (const slot of activation.slots.values()) {
+            if (slot.turn === turn)
+                settleSlot(activation, slot, 'failed', 'error');
+        }
+    });
+    /**
+     * Settle one task slot and record the terminal edge.
+     * @param activation - the owning context.
+     * @param slot - the slot to settle.
+     * @param state - the terminal state.
+     * @param stopReason - the harness turn ending, for `Task.metadata`.
+     */
+    function settleSlot(activation, slot, state, stopReason) {
+        if (slot.done)
+            return;
+        activation.slots.delete(slot.taskId);
+        const artifacts = artifactsFromTexts(slot.taskId, slot.texts);
+        // The terminal edge carries the output, so the projection can serve the
+        // ANSWER to a polling peer and not merely the fact that work finished.
+        const output = slot.texts.filter(text => text.length > 0).join('\n');
+        appendTaskEdge(activation, slot.taskId, state, {
+            ...stopReason === undefined ? {} : { stopReason },
+            ...output.length === 0 ? {} : { output },
+        });
+        slot.settle({
+            state,
+            artifacts,
+            ...stopReason === undefined ? {} : { stopReason },
+        });
+    }
+    // ── Context materialization ────────────────────────────────────────────
+    /**
+     * Create a fresh context and its owning agent.
+     *
+     * The policy events written onto the child's own log are what make an
+     * A2A-driven agent safe to run unattended: approvals are deterministically
+     * rejected rather than waiting on a prompt nobody is watching, and the policy
+     * stays reconstructable from that log alone.
+     */
+    const createActivation = async (peer) => {
+        const cwd = workspaceFor(peer);
+        await ensureWorkspace(cwd);
+        const sessionId = SessionId(randomUUID());
+        const handle = await agents.create({
+            sessionId,
+            meta: { cwd },
+            agentOptions: {
+                ...config.provider === undefined ? {} : { provider: config.provider },
+                ...config.model === undefined ? {} : { model: config.model },
+            },
+        });
+        if (closed) {
+            // Teardown can begin while create() is awaited. Such an agent is not in
+            // the registry and quiesce() would never release it — the classic orphan.
+            await handle.dispose();
+            throw new Error('server closed during context creation');
+        }
+        const activation = {
+            contextId: A2AContextId(sessionId),
+            agent: handle.agent,
+            handle,
+            peer,
+            cwd,
+            slots: new Map(),
+            lastTouchedAt: Date.now(),
+        };
+        // Pin the approval policy on the agent's OWN log so its effective policy
+        // stays reconstructable from that log alone — the same discipline
+        // `captureDelegatedPolicyOverrides` applies to a delegated child. Nobody
+        // watches an A2A-driven agent, so an ask must be deterministically rejected
+        // rather than waiting out a prompt no human will ever answer.
+        //
+        // The event key is written through an untyped view because the approval
+        // vocabulary belongs to a package a composition may not mount at all; when
+        // it is absent this append is simply a log row nothing folds.
+        try {
+            const session = handle.agent.session;
+            session.append('approval/policy', { policy: 'never', source: 'a2a' });
+        }
+        catch (error) {
+            logger.warn(`a2a: could not pin approval policy: ${String(error)}`);
+        }
+        contexts.add(activation);
+        return activation;
+    };
+    // ── Durable task read model ────────────────────────────────────────────
+    // Optional capability: a composition without the registry keeps working, it
+    // just cannot answer for a task after that task settles.
+    const projections = ctx.get('sessionProjections');
+    if (projections !== undefined) {
+        ctx.effect(() => projections.register(a2aTaskProjection), 'a2a.projection');
+    }
+    else {
+        logger.warn('a2a: no sessionProjections registry composed; tasks/get cannot answer '
+            + 'once a task settles, so a polling peer will never learn its result');
+    }
+    /**
+     * Read a settled task back from the projection.
+     *
+     * The fold is authoritative for anything not in the live slot table, so this
+     * is what makes the polling path work at all.
+     */
+    const readProjectedTask = (activation, taskId) => {
+        if (projections === undefined)
+            return undefined;
+        const snapshot = projections.snapshot(activation.agent.session);
+        const view = snapshot.values.a2aTask?.tasks[taskId];
+        // Ownership is re-checked against the RECORDED peer rather than the
+        // activation's, so a context that somehow served two identities could not
+        // leak one's task to the other.
+        if (view === undefined || view.peer !== activation.peer)
+            return undefined;
+        return {
+            kind: 'task',
+            id: taskId,
+            contextId: activation.contextId,
+            status: { state: view.state, timestamp: view.updatedAt },
+            artifacts: view.output === undefined || view.output.length === 0
+                ? []
+                : [{
+                        artifactId: `${taskId}-result`,
+                        name: 'result',
+                        parts: [{ kind: 'text', text: view.output }],
+                    }],
+            ...view.stopReason === undefined ? {} : { metadata: { dsh: { stopReason: view.stopReason } } },
+        };
+    };
+    // ── Router ─────────────────────────────────────────────────────────────
+    const deps = {
+        readProjectedTask,
+        config,
+        contexts,
+        turns,
+        rateLimiter,
+        logger,
+        assertOpen,
+        resolvePeerSecrets,
+        identify: identifyPeer,
+        cardFor,
+        createActivation,
+        submit: async (activation, text, peer) => {
+            const liveAgent = ctx.agents.get(activation.agent.id);
+            if (liveAgent !== activation.agent) {
+                throw new Error('the agent was disposed outside the A2A server');
+            }
+            const taskId = A2ATaskId(randomUUID());
+            const message = createUserMessage({
+                content: [{ type: 'text', text }],
+                source: { kind: 'a2a-peer', peer, taskId, form: 'relay' },
+            });
+            const slot = createSlot(taskId, message.id);
+            // Arm the slot before followup(): a listener-driven synchronous turn would
+            // otherwise slip past correlation and leave the task turnless forever.
+            activation.slots.set(taskId, slot);
+            appendTaskEdge(activation, taskId, 'submitted');
+            try {
+                activation.agent.followup(message);
+            }
+            catch (error) {
+                activation.slots.delete(taskId);
+                throw error;
+            }
+            void activation.agent.whenIdle().then(() => {
+                if (activation.slots.get(taskId) !== slot)
+                    return;
+                settleSlot(activation, slot, stateFromEnding(slot.endReason), slot.endReason);
+            });
+            return slot;
+        },
+        cancel: (activation, slot) => {
+            activation.agent.cancel({ kind: 'user' }, { keepInbox: true });
+            settleSlot(activation, slot, 'canceled', 'cancelled');
+            turns.reset(activation.contextId);
+        },
+        taskSnapshot: (activation, slot, state, artifacts, stopReason) => ({
+            kind: 'task',
+            id: slot.taskId,
+            contextId: activation.contextId,
+            status: { state, timestamp: nowIso() },
+            artifacts,
+            ...stopReason === undefined ? {} : { metadata: { dsh: { stopReason } } },
+        }),
+    };
+    const router = createRouter(deps);
+    // ── HTTP routes ────────────────────────────────────────────────────────
+    ctx.effect(function* () {
+        yield webServer.register({
+            kind: 'exact',
+            path: '/.well-known/agent-card.json',
+            handler: (req, res) => { router.serveCard(req, res); },
+        });
+        yield webServer.register({
+            kind: 'exact',
+            path: '/.well-known/agent.json',
+            handler: (req, res) => { router.serveCard(req, res); },
+        });
+        yield webServer.register({
+            kind: 'exact',
+            path: config.basePath,
+            handler: (req, res) => { void router.serveRpc(req, res); },
+        });
+    }, 'a2a.routes');
+    // ── Idle eviction ──────────────────────────────────────────────────────
+    ctx.effect(() => {
+        const timer = setInterval(() => {
+            for (const activation of contexts.evictable()) {
+                contexts.remove(activation.contextId);
+                void activation.handle.dispose().catch((error) => {
+                    logger.warn(`a2a: evicting ${activation.contextId} failed: ${String(error)}`);
+                });
+            }
+        }, Math.max(1000, Math.floor(config.contextIdleTtlMs / 4)));
+        timer.unref?.();
+        return () => { clearInterval(timer); };
+    }, 'a2a.reaper');
+    // ── Teardown ───────────────────────────────────────────────────────────
+    let quiescing;
+    const quiesce = () => {
+        if (quiescing !== undefined)
+            return quiescing;
+        closed = true;
+        const activations = contexts.drain();
+        // Send every stream its terminal frame BEFORE the carrier destroys sockets:
+        // a raw socket destroy is indistinguishable from a network fault, and the
+        // peer would retry a task that no longer exists.
+        router.closeStreams();
+        // Stop this server's own work before any await. A descendant drain can block
+        // on persistence, and top-level agents must not keep running model and tool
+        // calls for its whole duration.
+        for (const activation of activations) {
+            activation.agent.cancel({ kind: 'user' });
+            for (const slot of [...activation.slots.values()]) {
+                settleSlot(activation, slot, 'canceled', 'cancelled');
+            }
+        }
+        rateLimiter.clear();
+        turns.clear();
+        quiescing = (async () => {
+            // Continuable subagents outlive the turn that started them. Drain only the
+            // forests below OUR agents, child-first, before releasing them — another
+            // frontend sharing this Context keeps its own forest and admission.
+            const subagents = ctx.get('subagents');
+            if (subagents !== undefined) {
+                try {
+                    await subagents.drainContinuableDescendants(activations.map(a => a.agent));
+                }
+                catch (error) {
+                    logger.warn(`a2a: continuable subagent teardown failed: ${String(error)}`);
+                }
+            }
+            const results = await Promise.allSettled(activations.map(a => a.handle.dispose()));
+            const failures = results.flatMap(r => r.status === 'rejected' ? [r.reason] : []);
+            if (failures.length > 0) {
+                // The production consumer logs this through String(), which renders only
+                // the message — so every per-context diagnostic must live in it.
+                throw new AggregateError(failures, `A2A agent teardown failed for ${failures.length} context(s): ` +
+                    failures.map(f => f instanceof Error ? f.message : String(f)).join('; '));
+            }
+        })();
+        return quiescing;
+    };
+    ctx.effect(() => quiesce, 'a2a.server');
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/projection.d.ts

@@ -0,0 +1,131 @@
+/**
+ * The `a2aTask` projection unit: task state read back from the session log.
+ *
+ * Without this, task state lives only in the process-local slot table, and
+ * `settleSlot` removes a slot the moment it settles — so a peer that polls
+ * `tasks/get` is told the task never existed, moments after it completed. That
+ * breaks the polling path A2A treats as the baseline update mechanism
+ * (`message/stream` and push notifications are both optional capabilities;
+ * `tasks/get` is not).
+ *
+ * The unit is a pure left fold over the `a2a/task` edges the server already
+ * appends. It holds no subscriptions: the registry drives every committed event
+ * through `apply` once, and the persisted projection cache turns a cold read
+ * into a cache row plus a tail replay rather than a full log load.
+ *
+ * @module dsh-a2a/projection
+ */
+import { z } from 'zod';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { A2ATaskState } from './protocol/index.ts';
+/** One task's durable read model. */
+export interface A2ATaskView {
+    taskId: string;
+    /** The authenticated peer that submitted it. Ownership is checked against this. */
+    peer: string;
+    state: A2ATaskState;
+    /**
+     * The committed assistant text, when the terminal edge recorded any.
+     *
+     * This is what lets a polling peer receive the ANSWER rather than only the
+     * fact that the task finished — an empty artifact list on a `completed` task
+     * reads as "it worked and produced nothing".
+     */
+    output?: string | undefined;
+    /**
+     * The harness turn ending, when the terminal edge recorded one.
+     *
+     * Explicitly `| undefined` because the value round-trips through a zod schema
+     * whose inferred optional includes it, and this project compiles with
+     * `exactOptionalPropertyTypes`.
+     */
+    stopReason?: string | undefined;
+    /** Wall-clock of the last recorded edge, for `Task.status.timestamp`. */
+    updatedAt: string;
+}
+/** The whole projected value: every task this session has seen. */
+export interface A2ATaskProjection {
+    tasks: Record<string, A2ATaskView>;
+}
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        /** Per-session A2A task states, folded from `a2a/task` edges. */
+        a2aTask: A2ATaskProjection;
+    }
+}
+/** Validates the wire payload before it leaves the host. */
+export declare const A2A_TASK_VIEW_SCHEMA: z.ZodObject<{
+    tasks: z.ZodRecord<z.ZodString, z.ZodObject<{
+        taskId: z.ZodString;
+        peer: z.ZodString;
+        state: z.ZodEnum<{
+            submitted: "submitted";
+            working: "working";
+            "input-required": "input-required";
+            "auth-required": "auth-required";
+            completed: "completed";
+            canceled: "canceled";
+            failed: "failed";
+            rejected: "rejected";
+        }>;
+        output: z.ZodOptional<z.ZodString>;
+        stopReason: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The projection unit's internal state. Plain JSON, per the cache precondition. */
+export interface A2ATaskState_ {
+    tasks: Record<string, A2ATaskView>;
+}
+/**
+ * The projection definition, in the shape `ctx.sessionProjections.register()` wants.
+ *
+ * Declared as a plain object rather than built inside `apply()` so the fold can
+ * be unit-tested without a Cordis context or a session.
+ */
+export declare const a2aTaskProjection: {
+    key: "a2aTask";
+    schema: z.ZodObject<{
+        tasks: z.ZodRecord<z.ZodString, z.ZodObject<{
+            taskId: z.ZodString;
+            peer: z.ZodString;
+            state: z.ZodEnum<{
+                submitted: "submitted";
+                working: "working";
+                "input-required": "input-required";
+                "auth-required": "auth-required";
+                completed: "completed";
+                canceled: "canceled";
+                failed: "failed";
+                rejected: "rejected";
+            }>;
+            output: z.ZodOptional<z.ZodString>;
+            stopReason: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    stateVersion: number;
+    /**
+     * State for the empty log.
+     * @returns the initial state.
+     */
+    init(): A2ATaskState_;
+    /**
+     * Fold one committed event.
+     *
+     * Returns the SAME reference for every event that is not an `a2a/task` edge:
+     * the drive gates its change feed on `Object.is`, so a fresh object here would
+     * wake every downstream consumer on every unrelated event in the session.
+     * @param state - the state covering all prior events.
+     * @param event - the next committed session event.
+     * @returns the next state, or `state` unchanged.
+     */
+    apply(state: A2ATaskState_, event: SessionEvent): A2ATaskState_;
+    /**
+     * State → wire payload.
+     * @param state - the current state.
+     * @returns the whole current value.
+     */
+    view(state: A2ATaskState_): A2ATaskProjection;
+};
+//# sourceMappingURL=projection.d.ts.map

package/lib/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElE,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAED,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,iEAAiE;QACjE,OAAO,EAAE,iBAAiB,CAAA;KAC3B;CACF;AAOD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;iBAS/B,CAAA;AAEF,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAYD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;IAK5B;;;OAGG;YACK,aAAa;IAIrB;;;;;;;;;OASG;iBACU,aAAa,SAAS,YAAY,GAAG,aAAa;IA2B/D;;;;OAIG;gBACS,aAAa,GAAG,iBAAiB;CAG9C,CAAA"}