@astram/frontend-core 0.10.0 → 0.12.0

package/dist/agent/agentReducer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * agentReducer — pure fold of agent stream events into task state (SPEC
+ * `docs/features/agent-read-capabilities/SPEC.md` §3 B, F; §5 frontend-core).
+ *
+ * `seq` is task-wide (§3 B): an event with `seq ≤ lastSeq` is a duplicate and changes nothing (a
+ * replay snapshot is merged by `seq`); a jump past `lastSeq + 1`, or a `replay.truncated` whose
+ * `firstRetainedSeq − 1` is beyond `lastSeq`, sets `truncated` (events were missed). An event of
+ * another task is ignored. Payloads are read defensively: a malformed part is skipped, never shown raw.
+ *
+ * The state shows the latest run: `task.started` clears steps, tools, answer, questions, error and
+ * usage. Terminal events: `done` (`completed` ⇒ `done`, `awaiting_clarification`) and `error`.
+ * Client inputs (`local.*`) mark the stream opened/closed, a lost connection (watchdog or a stream
+ * that ended with no terminal event) and a refusal before the first byte (§3 D).
+ */
+import type { AgentLocalEvent, AgentStreamEvent, AgentTaskState } from './types.js';
+/** The empty state of a task not yet opened. */
+export declare const INITIAL_AGENT_STATE: AgentTaskState;
+/**
+ * Fixed display text for an agent error code (never server text). An unknown code falls back to
+ * the HTTP status text when a status is given, else a generic line.
+ */
+export declare function agentErrorText(code: string | null, status?: number): string;
+/** Pure: the next state for one server event or client input. Never throws, never mutates. */
+export declare function agentReducer(state: AgentTaskState, event: AgentStreamEvent | AgentLocalEvent): AgentTaskState;
+/** `true` when the state ended its run (`done`, `awaiting_clarification` or `error`). */
+export declare function isAgentTerminal(state: AgentTaskState): boolean;
+//# sourceMappingURL=agentReducer.d.ts.map

package/dist/agent/agentReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentReducer.d.ts","sourceRoot":"","sources":["../../src/agent/agentReducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAIV,eAAe,EAKf,gBAAgB,EAEhB,cAAc,EAKf,MAAM,YAAY,CAAC;AAEpB,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,EAAE,cAahC,CAAC;AAiDH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAuND,8FAA8F;AAC9F,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,gBAAgB,GAAG,eAAe,GACxC,cAAc,CAKhB;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAI9D"}

package/dist/agent/agentReducer.js

@@ -0,0 +1,286 @@
+/** The empty state of a task not yet opened. */
+export const INITIAL_AGENT_STATE = Object.freeze({
+    taskId: null,
+    status: 'idle',
+    run: 0,
+    steps: Object.freeze([]),
+    tools: Object.freeze({}),
+    answer: null,
+    questions: null,
+    error: null,
+    usage: null,
+    lastSeq: 0,
+    live: false,
+    truncated: false,
+});
+/** Fixed text per error code (§3 D, SSE `error` codes, the client's `connection_lost`). */
+const CODE_TEXT = {
+    connection_lost: 'Connection lost — the task was stopped.',
+    invalid_request: 'The request was not accepted.',
+    session_required: 'The assistant needs a signed-in user session.',
+    agent_disabled: 'The assistant is not enabled for this company.',
+    task_not_found: 'That task was not found.',
+    task_busy: 'This task is still running. Try again when it has finished.',
+    task_closed: 'This task is closed. Start a new one.',
+    task_expired: 'This task has expired. Start a new one.',
+    payload_too_large: 'The message is too long.',
+    too_many_tasks: 'Too many tasks are running. Wait for one to finish and try again.',
+    agent_unavailable: 'The assistant is temporarily unavailable. Try again shortly.',
+    limit_reached: 'The task reached its limit and was stopped.',
+    timeout: 'The task took too long and was stopped.',
+    model_unavailable: 'The model is unavailable right now. Try again shortly.',
+    model_refused: 'The model declined this request.',
+    invalid_tool_call: 'The assistant made an invalid request and was stopped.',
+    answer_too_long: 'The answer was too long.',
+    provider_mismatch: 'The assistant is not set up correctly.',
+    internal: 'Something went wrong in the assistant.',
+    cancelled: 'The task was cancelled.',
+    protocol_error: 'The assistant stopped unexpectedly.',
+    runtime_unavailable: 'The assistant is unavailable right now. Try again shortly.',
+    session_ended: 'Your session ended, so the task was stopped.',
+    access_revoked: 'Your access changed, so the task was stopped.',
+    egress_denied: 'This data may not be sent to the model, so the task was stopped.',
+    unsupported_claim: 'The answer could not be matched to the data. Try again.',
+    record_failed: 'The task could not be recorded, so it was stopped.',
+    unavailable: 'The assistant is temporarily unavailable. Try again shortly.',
+};
+/** Fixed text per HTTP status when the code is unknown (R-7). */
+const STATUS_TEXT = {
+    0: 'Could not reach the server. Check your connection and try again.',
+    400: 'The request was not accepted.',
+    401: 'Please sign in again.',
+    403: 'You do not have access to the assistant.',
+    404: 'That task was not found.',
+    409: 'This task cannot take that request now.',
+    413: 'The message is too long.',
+    429: 'Too many tasks are running. Wait for one to finish and try again.',
+    503: 'The assistant is temporarily unavailable. Try again shortly.',
+};
+const GENERIC_TEXT = 'The assistant could not complete the task.';
+/**
+ * Fixed display text for an agent error code (never server text). An unknown code falls back to
+ * the HTTP status text when a status is given, else a generic line.
+ */
+export function agentErrorText(code, status) {
+    if (code !== null && Object.prototype.hasOwnProperty.call(CODE_TEXT, code)) {
+        return CODE_TEXT[code];
+    }
+    if (status !== undefined && Object.prototype.hasOwnProperty.call(STATUS_TEXT, status)) {
+        return STATUS_TEXT[status];
+    }
+    return GENERIC_TEXT;
+}
+function taskError(code, retryable, status) {
+    return { code, retryable, message: agentErrorText(code, status) };
+}
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const isStr = (v) => typeof v === 'string';
+const isCount = (v) => Number.isSafeInteger(v) && v >= 0;
+const isNum = (v) => v === null || (typeof v === 'number' && Number.isFinite(v)) || typeof v === 'string';
+const TOOL_STATUSES = ['ok', 'denied', 'invalid', 'failed', 'timeout'];
+function readPartial(v) {
+    if (!isObj(v) || !isCount(v.shown))
+        return null;
+    if (v.total !== null && !isCount(v.total))
+        return null;
+    return { shown: v.shown, total: v.total };
+}
+/** Evidence of a known kind with the expected fields, else null (never passed on raw). */
+function readEvidence(v) {
+    if (!isObj(v))
+        return null;
+    const opt = (k) => isStr(v[k]) ? { [k]: v[k] } : {};
+    switch (v.kind) {
+        case 'metric':
+            if (!isStr(v.label) || !isNum(v.value))
+                return null;
+            return { kind: 'metric', label: v.label, value: v.value, ...opt('unit'), ...opt('asOf') };
+        case 'table': {
+            if (!Array.isArray(v.columns) || !Array.isArray(v.rows))
+                return null;
+            const columns = v.columns.filter((c) => isObj(c) &&
+                isStr(c.key) &&
+                isStr(c.label) &&
+                (c.numeric === undefined || typeof c.numeric === 'boolean'));
+            if (columns.length !== v.columns.length)
+                return null;
+            const rows = v.rows.filter((r) => isObj(r) &&
+                Object.values(r).every((c) => c === null ||
+                    isStr(c) ||
+                    typeof c === 'boolean' ||
+                    (typeof c === 'number' && Number.isFinite(c))));
+            if (rows.length !== v.rows.length)
+                return null;
+            return { kind: 'table', columns, rows };
+        }
+        case 'series': {
+            if (!isStr(v.label) || !Array.isArray(v.points))
+                return null;
+            const points = v.points.filter((p) => isObj(p) && isStr(p.x) && isNum(p.y));
+            if (points.length !== v.points.length)
+                return null;
+            return { kind: 'series', label: v.label, ...opt('unit'), points };
+        }
+        default:
+            return null;
+    }
+}
+function readOption(v) {
+    return isObj(v) && isStr(v.value) && isStr(v.label) ? { value: v.value, label: v.label } : null;
+}
+function readQuestion(v) {
+    if (!isObj(v) || !isStr(v.id) || !isStr(v.text))
+        return null;
+    if (v.kind === 'free_text')
+        return { id: v.id, text: v.text, kind: 'free_text' };
+    if (v.kind !== 'single' && v.kind !== 'multi')
+        return null;
+    if (!Array.isArray(v.options))
+        return null;
+    const options = v.options.map(readOption);
+    if (options.length === 0 || options.some((o) => o === null))
+        return null;
+    return { id: v.id, text: v.text, kind: v.kind, options: options };
+}
+function readAnswer(p) {
+    if (!isStr(p.answer))
+        return null;
+    const claims = Array.isArray(p.claims)
+        ? p.claims
+            .filter((c) => isObj(c) && isStr(c.text) && Array.isArray(c.refs))
+            .map((c) => ({ text: c.text, refs: c.refs.filter(isStr) }))
+        : [];
+    const gaps = Array.isArray(p.gaps) ? p.gaps.filter(isStr) : [];
+    return { answer: p.answer, claims, gaps };
+}
+function readUsage(v) {
+    return isObj(v) && isCount(v.modelCalls) && isCount(v.toolCalls)
+        ? { modelCalls: v.modelCalls, toolCalls: v.toolCalls }
+        : null;
+}
+function applyLocal(state, event) {
+    switch (event.type) {
+        case 'local.opened':
+            return event.live
+                ? { ...state, status: 'streaming', live: true, error: null }
+                : { ...state, live: false };
+        case 'local.closed':
+            return state.live ? { ...state, live: false } : state;
+        case 'local.connection_lost':
+            return { ...state, status: 'error', live: false, error: taskError('connection_lost', false) };
+        case 'local.refused': {
+            const code = event.code ?? (event.status === 0 ? 'unreachable' : `http_${event.status}`);
+            return {
+                ...state,
+                status: 'error',
+                live: false,
+                error: taskError(code, event.retryable, event.status),
+            };
+        }
+        default:
+            return state;
+    }
+}
+function applyServer(state, event) {
+    if (state.taskId !== null && event.taskId !== state.taskId)
+        return state; // another task
+    if (!Number.isSafeInteger(event.seq) || event.seq <= state.lastSeq)
+        return state; // duplicate
+    const p = isObj(event.payload) ? event.payload : {};
+    if (event.type === 'replay.truncated') {
+        // Its seq is firstRetainedSeq − 1: everything after lastSeq up to it is gone.
+        return { ...state, taskId: event.taskId, lastSeq: event.seq, truncated: true };
+    }
+    const gap = state.lastSeq > 0 && event.seq !== state.lastSeq + 1;
+    const base = {
+        ...state,
+        taskId: event.taskId,
+        lastSeq: event.seq,
+        truncated: state.truncated || gap,
+    };
+    switch (event.type) {
+        case 'task.started':
+            return {
+                ...base,
+                status: 'streaming',
+                run: Number.isSafeInteger(p.run) && p.run > 0 ? p.run : state.run + 1,
+                steps: [],
+                tools: {},
+                answer: null,
+                questions: null,
+                error: null,
+                usage: null,
+            };
+        case 'step':
+            if (!isStr(p.key) || !isStr(p.label))
+                return base;
+            return { ...base, steps: [...state.steps, { key: p.key, label: p.label }] };
+        case 'tool.started': {
+            if (!isStr(p.callId) || !isStr(p.capability) || !isStr(p.title))
+                return base;
+            const tool = {
+                capability: p.capability,
+                title: p.title,
+                status: 'running',
+                code: null,
+                evidence: null,
+                partial: null,
+            };
+            return { ...base, tools: { ...state.tools, [p.callId]: tool } };
+        }
+        case 'tool.finished': {
+            if (!isStr(p.callId) || !isStr(p.status) || !TOOL_STATUSES.includes(p.status))
+                return base;
+            const prior = Object.prototype.hasOwnProperty.call(state.tools, p.callId)
+                ? state.tools[p.callId]
+                : undefined;
+            const tool = {
+                capability: prior?.capability ?? null,
+                title: prior?.title ?? null,
+                status: p.status,
+                code: isStr(p.code) ? p.code : null,
+                evidence: readEvidence(p.evidence),
+                partial: readPartial(p.partial),
+            };
+            return { ...base, tools: { ...state.tools, [p.callId]: tool } };
+        }
+        case 'clarification.required': {
+            if (!Array.isArray(p.questions))
+                return base;
+            const questions = p.questions.map(readQuestion).filter((q) => q !== null);
+            return { ...base, questions };
+        }
+        case 'answer': {
+            const answer = readAnswer(p);
+            return answer ? { ...base, answer } : base;
+        }
+        case 'done': {
+            const status = p.state === 'awaiting_clarification'
+                ? 'awaiting_clarification'
+                : p.state === 'completed'
+                    ? 'done'
+                    : null;
+            if (status === null)
+                return base;
+            return { ...base, status, error: null, usage: readUsage(p.usage), live: state.live };
+        }
+        case 'error': {
+            const code = isStr(p.code) && p.code !== '' ? p.code : 'internal';
+            return { ...base, status: 'error', error: taskError(code, p.retryable === true) };
+        }
+        default:
+            return base; // reserved or later types: seq advances, nothing shown
+    }
+}
+/** Pure: the next state for one server event or client input. Never throws, never mutates. */
+export function agentReducer(state, event) {
+    if (typeof event.type === 'string' && event.type.startsWith('local.')) {
+        return applyLocal(state, event);
+    }
+    return applyServer(state, event);
+}
+/** `true` when the state ended its run (`done`, `awaiting_clarification` or `error`). */
+export function isAgentTerminal(state) {
+    return (state.status === 'done' || state.status === 'awaiting_clarification' || state.status === 'error');
+}
+//# sourceMappingURL=agentReducer.js.map

package/dist/agent/agentReducer.js.map

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

package/dist/agent/agentService.d.ts

@@ -0,0 +1,136 @@
+/**
+ * createAgentService — the agent client (G-036 M1, SPEC
+ * `docs/features/agent-read-capabilities/SPEC.md` §3, §5 frontend-core). Platform-agnostic like
+ * the other R-7 services: the JSON calls go through the injected {@link HttpClient} (bearer token
+ * per call), the streams through the injected {@link AgentStreamTransport}, which authenticates
+ * its own requests (web: `fetch` with a streamed body; a refresh only before the first byte).
+ *
+ * Routes (`@Classified` on `identity:agent:chat`, session principals only):
+ *   POST /agent/tasks                     { message, modelProfile?, locale? }   → SSE (run 1)
+ *   POST /agent/tasks/:taskId/continue    { message } | { answers } | { retry } → SSE (next run)
+ *   POST /agent/tasks/:taskId/cancel      {}                                    → 202 { accepted }
+ *   GET  /agent/tasks/:taskId                                                   → task view (§3 C)
+ *   GET  /agent/tasks/:taskId/events      Last-Event-ID                         → SSE snapshot (§3 F)
+ *
+ * Streams: each is parsed ({@link parseSseFrames}) and folded ({@link agentReducer}); every new
+ * state is handed to `onState`. A stall watchdog ends a live stream that sends no event and no
+ * heartbeat for {@link AGENT_STREAM_STALL_MS}: the transport is closed and the state becomes
+ * `error` / `connection_lost` (the server cancels a task whose client disconnects, Q8). A live
+ * stream that ends with no terminal event ends the same way. There is no automatic reconnect and
+ * no resubmission: the only follow-up is the read-only `replay(taskId, lastSeq)`, which merges the
+ * snapshot by `seq` (duplicates dropped) and ends. A new turn is a user action.
+ *
+ * Never throws: every method resolves to `{ ok: true, … }` or `{ ok: false, status, code,
+ * retryable, error }` with fixed text (server text is never shown).
+ */
+import type { AbortSignalLike, HttpClient } from '../http/types.js';
+import { type AgentPartial, type AgentStreamEvent, type AgentStreamTransport, type AgentTaskState, type SseDrop } from './types.js';
+/** Body of `POST /agent/tasks`. `message` is 1–8000 code points (checked by the server). */
+export interface AgentOpenInput {
+    readonly message: string;
+    readonly modelProfile?: string;
+    readonly locale?: string;
+}
+/** One answer to a pending clarification question (M0 §10 A). */
+export interface AgentAnswerInput {
+    readonly id: string;
+    /** `single`: one option value. */
+    readonly value?: string;
+    /** `multi`: 1–10 option values. */
+    readonly values?: readonly string[];
+    /** `free_text`: 1–1000 code points. */
+    readonly text?: string;
+}
+/** Body of `POST …/continue`: exactly one variant (§3 A). */
+export type AgentContinueInput = {
+    readonly message: string;
+} | {
+    readonly answers: readonly AgentAnswerInput[];
+} | {
+    readonly retry: true;
+};
+export interface AgentStreamOptions {
+    /** The state to build on: the task's current state for continue and replay. Default: empty. */
+    readonly state?: AgentTaskState;
+    /** Every new state, in order. Must not throw (errors are swallowed). */
+    readonly onState?: (state: AgentTaskState) => void;
+    /** Every event the parser accepted, in order. Must not throw. */
+    readonly onEvent?: (event: AgentStreamEvent) => void;
+    /** Aborting it closes the stream (for a live stream the server then cancels the task). */
+    readonly signal?: AbortSignalLike;
+}
+/** A refusal or failure (fixed text in `error`). */
+export interface AgentFailure {
+    readonly ok: false;
+    /** HTTP status; 0 = the server could not be reached. */
+    readonly status: number;
+    /** The §3 D code when the server sent one, else null. */
+    readonly code: string | null;
+    readonly retryable: boolean;
+    readonly error: string;
+}
+export type AgentStreamResult = {
+    readonly ok: true;
+    readonly state: AgentTaskState;
+    /** Frames the parser refused (reason and `seq` only). */
+    readonly dropped: readonly SseDrop[];
+    /** False when the stream stalled, failed or was aborted before it ended by itself. */
+    readonly complete: boolean;
+} | (AgentFailure & {
+    readonly state: AgentTaskState;
+});
+/** One recorded call in the task view (§3 C). No arguments, results or model text. */
+export interface AgentTaskAction {
+    readonly callId: string;
+    readonly capability: string;
+    readonly title: string;
+    readonly status: string;
+    readonly code: string | null;
+    readonly startedAt: string | null;
+    readonly durationMs: number | null;
+    readonly partial: AgentPartial | null;
+}
+/** `GET /agent/tasks/:taskId` (§3 C). */
+export interface AgentTaskView {
+    readonly taskId: string;
+    readonly state: string;
+    readonly runs: number;
+    readonly createdAt: string | null;
+    readonly closedAt: string | null;
+    readonly endReason: string | null;
+    readonly usage: {
+        readonly modelCalls: number;
+        readonly toolCalls: number;
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+    };
+    readonly actions: readonly AgentTaskAction[];
+}
+export type CancelAgentTaskResult = {
+    readonly ok: true;
+} | AgentFailure;
+export type GetAgentTaskResult = {
+    readonly ok: true;
+    readonly task: AgentTaskView;
+} | AgentFailure;
+export interface AgentService {
+    /** Open a task (run 1) and stream it to the end. */
+    openTask(input: AgentOpenInput, opts?: AgentStreamOptions): Promise<AgentStreamResult>;
+    /** Start the next run of a task and stream it. Pass the task's state in `opts.state`. */
+    continueTask(taskId: string, input: AgentContinueInput, opts?: AgentStreamOptions): Promise<AgentStreamResult>;
+    /** Cancel a task (idempotent; `202` for any outcome the server accepts). */
+    cancelTask(accessToken: string, taskId: string): Promise<CancelAgentTaskResult>;
+    /** The task's metadata view (no message text). */
+    getTask(accessToken: string, taskId: string, signal?: AbortSignalLike): Promise<GetAgentTaskResult>;
+    /**
+     * Read-only snapshot of the retained events after `lastSeq` (0 ⇒ all), merged into
+     * `opts.state` by `seq`. Never resumes, cancels or changes the task.
+     */
+    replay(taskId: string, lastSeq: number, opts?: AgentStreamOptions): Promise<AgentStreamResult>;
+}
+export interface AgentServiceOptions {
+    /** Stall watchdog in ms (default {@link AGENT_STREAM_STALL_MS}). */
+    readonly stallMs?: number;
+}
+export declare function createAgentService(http: HttpClient, stream: AgentStreamTransport, options?: AgentServiceOptions): AgentService;
+//# sourceMappingURL=agentService.d.ts.map

package/dist/agent/agentService.d.ts.map

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