@lloyal-labs/ui 0.1.0-alpha.10

package/LICENSE

@@ -0,0 +1,107 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 Lloyal Labs
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publish, and distribute the
+Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A "Permitted Purpose" is any purpose other than a Competing Use. A
+"Competing Use" means making the Software available to others in a
+commercial product or service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a Licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives
+of the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND,
+INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO
+THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
+DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software
+under the Apache License, Version 2.0 that is effective on the second
+anniversary of the date we make the Software available. On or after that
+date, you may use the Software under the Apache License, Version 2.0, in
+which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/assets.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentMeta } from '@lloyal-labs/media';
+export type Asset = {
+    kind: 'image';
+} | {
+    kind: 'document';
+    meta: DocumentMeta; /** The ingest retained the original file. */
+    source: boolean;
+};
+export declare function resolveAsset(origin: string, digest: string): Promise<Asset>;
+/** The kinds of the given roots, filled in as the content plane answers. */
+export declare function useAssets(digests: readonly string[]): Record<string, Asset>;
+/** "1, 2, 3, 7" with runs of three or more folded: "1–3, 7". */
+export declare function pageList(pages: readonly number[]): string;
+/** What of a document reached the model, page by page: which pages had no text
+ *  to extract (scanned), which were extracted as text, and — when the thread
+ *  holds their renders — which pages the model looked at. */
+export declare function pageFacts(meta: DocumentMeta, viewedRenders?: ReadonlySet<string>): string[];
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC,CAAC,6CAA6C;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAI5G,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAcjF;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAoB3E;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CASzD;AAED;;6DAE6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,MAAM,EAAE,CAatG"}

package/dist/assets.js

@@ -0,0 +1,83 @@
+/**
+ * What a root IS, learned from its manifest through the content plane: a
+ * picture, or a document with its sidecar. One resolution per digest for the
+ * page's lifetime — content is immutable under its address, so an answer never
+ * goes stale. A root whose manifest cannot be read is shown as an image, so
+ * the failure is visible (a broken picture) rather than silent.
+ *
+ * @category UI
+ */
+import { useEffect, useState } from 'react';
+import { asDocumentMeta, configUrl, DOCUMENT_CONFIG_TYPE, manifestUrl } from '@lloyal-labs/media';
+import { useContentOrigin } from './provider.js';
+const resolved = new Map();
+export async function resolveAsset(origin, digest) {
+    try {
+        const manifest = (await (await fetch(manifestUrl(origin, digest))).json());
+        if (manifest.config?.mediaType !== DOCUMENT_CONFIG_TYPE)
+            return { kind: 'image' };
+        const meta = asDocumentMeta(await (await fetch(configUrl(origin, digest))).json());
+        if (!meta)
+            return { kind: 'image' };
+        const source = (manifest.layers ?? []).some((l) => l.annotations?.['ai.lloyal.role'] === 'source');
+        return { kind: 'document', meta, source };
+    }
+    catch {
+        return { kind: 'image' };
+    }
+}
+/** The kinds of the given roots, filled in as the content plane answers. */
+export function useAssets(digests) {
+    const origin = useContentOrigin();
+    const [assets, setAssets] = useState({});
+    const key = digests.join(' ');
+    useEffect(() => {
+        if (origin === null)
+            return;
+        let live = true;
+        for (const digest of key ? key.split(' ') : []) {
+            let p = resolved.get(digest);
+            if (!p) {
+                p = resolveAsset(origin, digest);
+                resolved.set(digest, p);
+            }
+            void p.then((asset) => {
+                if (live)
+                    setAssets((prev) => (prev[digest] ? prev : { ...prev, [digest]: asset }));
+            });
+        }
+        return () => { live = false; };
+    }, [origin, key]);
+    return assets;
+}
+/** "1, 2, 3, 7" with runs of three or more folded: "1–3, 7". */
+export function pageList(pages) {
+    const out = [];
+    for (let i = 0; i < pages.length;) {
+        let j = i;
+        while (j + 1 < pages.length && pages[j + 1] === pages[j] + 1)
+            j++;
+        out.push(j - i >= 2 ? `${pages[i]}–${pages[j]}` : pages.slice(i, j + 1).join(', '));
+        i = j + 1;
+    }
+    return out.join(', ');
+}
+/** What of a document reached the model, page by page: which pages had no text
+ *  to extract (scanned), which were extracted as text, and — when the thread
+ *  holds their renders — which pages the model looked at. */
+export function pageFacts(meta, viewedRenders = new Set()) {
+    const scanned = meta.pages.filter((p) => p.chars === 0).map((p) => p.page);
+    const viewed = meta.pages.filter((p) => p.render && viewedRenders.has(p.render.digest)).map((p) => p.page);
+    const n = meta.pageCount;
+    const lines = [
+        scanned.length === 0
+            ? `Extracted as text: all ${n} page${n === 1 ? '' : 's'}`
+            : scanned.length === n
+                ? `Scanned (image only): all ${n} page${n === 1 ? '' : 's'}`
+                : `Scanned: ${pageList(scanned)} · extracted as text: the rest`,
+    ];
+    if (viewed.length > 0)
+        lines.push(`Viewed as images: ${pageList(viewed)}`);
+    return lines;
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

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

package/dist/fold.d.ts

@@ -0,0 +1,211 @@
+/**
+ * The generic agent fold: one agent's life on a view, folded from the bus
+ * events every pool emits. Framework-free — the Ink view, the desktop shell's
+ * own fold and the browser page all fold the same records — and it knows no
+ * product: which spawns get a timeline, and what an agent's task is called,
+ * are the application's decisions, handed in at `agent:spawn`.
+ *
+ * What it owns: the per-agent record ({@link AgentRuntime}), the `<think>`
+ * boundary machine (a live think block advances until the marker, then closes
+ * and seeds the content buffer with the tail), the timeline items — think,
+ * tool call, tool result, report — with their summaries, retry state, and the
+ * terminal transitions (`return`/`recovered` → done, `failed`, and the
+ * stall-break `done` that precedes a forced recovery).
+ *
+ * @packageDocumentation
+ * @category UI
+ */
+/** One cited source, extracted CONSUMER-side from a tool result (the Ability
+ *  Protocol prescribes no result schema). Web tools populate url/title/snippet;
+ *  image and icon arrive when an ability emits them; a corpus ability fills
+ *  whatever subset applies. */
+export interface SourceMeta {
+    url?: string;
+    title?: string;
+    snippet?: string;
+    image?: string;
+    icon?: string;
+    /** Display host, derived from url when present. */
+    host?: string;
+}
+/** Per-agent chronological stream item — a renderer lays one component per
+ *  kind. `live: true` on a think item means its body is currently streaming. */
+export type TimelineItem = {
+    kind: 'think';
+    id: number;
+    title: string;
+    body: string;
+    live: boolean;
+    openedAt: number;
+    closedAt: number | null;
+} | {
+    kind: 'tool_call';
+    id: number;
+    tool: string;
+    argsSummary: string;
+} | {
+    kind: 'tool_result';
+    id: number;
+    tool: string;
+    /** The tool_call id this result pairs with, for a renderer that indents results under their call. */
+    callId: number | null;
+    byteLength: number;
+    preview: string | null;
+    hosts: string[];
+    resultCount: number | null;
+    /** Per-source citation metadata parsed from the tool's free-form result. */
+    sources?: SourceMeta[];
+} | {
+    kind: 'report';
+    id: number;
+    body: string;
+    tokenCount: number;
+};
+export interface AgentRuntime {
+    id: number;
+    /** "A0", "A1", … in spawn order within the roster. */
+    label: string;
+    phase: 'idle' | 'thinking' | 'content' | 'tool' | 'done' | 'failed';
+    tokenCount: number;
+    toolCallCount: number;
+    /** Wall-clock spawn time (ms). */
+    startedAt: number;
+    /** Wall-clock completion time (ms), set when the agent reaches `done` or `failed`. */
+    endedAt: number | null;
+    /** The application's index for this agent's task; null for an agent that works no task of the plan (a settling pass, a probe). */
+    taskIndex: number | null;
+    taskDescription: string | null;
+    /** A dependency hint for a chained task ("builds on Task 1"). */
+    dependencyHint: string | null;
+    /** Id of the currently-live think item in `timeline`, or null. */
+    currentThinkId: number | null;
+    /** Id of the most recent tool_call, paired with its tool_result when one lands. */
+    pendingToolCallId: number | null;
+    /** A parked tool call: the provider was rate-limited and the pool re-executes after the delay. */
+    retry: {
+        tool: string;
+        retryAt: number;
+        attempt: number;
+    } | null;
+    /** Live post-`</think>` token buffer: the model writing its tool-call JSON, or a forced recovery's prose. */
+    contentBuffer: string;
+    /** True while the agent is being force-recovered: `agent:done` fired without a report and the pool
+     *  streams a forced one; produce tokens go to `contentBuffer`, not a think block. */
+    recovering: boolean;
+    /** Set when the agent ended without a result: the terminal failure's reason. */
+    failReason: string | null;
+    /** Think blocks, tool rows, the report — or null for an agent tracked by its numbers only. */
+    timeline: TimelineItem[] | null;
+}
+/** What a roster holds beside its agents: the counters that keep timeline ids and labels stable. */
+export interface AgentRoster {
+    agents: Map<number, AgentRuntime>;
+    nextTimelineId: number;
+    nextLabelIdx: number;
+}
+export declare const emptyRoster: () => AgentRoster;
+/** The bus events the fold reads, structurally — the agents package's own
+ *  vocabulary, versioned beside it; every field the fold touches is guarded. */
+export type AgentEvent = {
+    type: 'agent:spawn';
+    agentId: number;
+    parentAgentId?: number;
+    key?: string;
+    after?: number[];
+} | {
+    type: 'agent:produce';
+    agentId: number;
+    text: string;
+    tokenCount: number;
+} | {
+    type: 'agent:tool_call';
+    agentId: number;
+    tool: string;
+    args: string;
+} | {
+    type: 'agent:tool_retry';
+    agentId: number;
+    tool: string;
+    retryAfterMs: number;
+    attempt: number;
+} | {
+    type: 'agent:tool_result';
+    agentId: number;
+    tool: string;
+    result: string;
+} | {
+    type: 'agent:return';
+    agentId: number;
+    result: string;
+} | {
+    type: 'agent:recovered';
+    agentId: number;
+    result: string;
+} | {
+    type: 'agent:failed';
+    agentId: number;
+    reason: string;
+} | {
+    type: 'agent:done';
+    agentId: number;
+};
+/** What the application decides at a spawn — two facts, not one: whether the agent keeps a timeline, and which
+ *  task of the plan it works (null: none — a settling pass keeps a timeline and works no task; a helper the view
+ *  never shows keeps neither). */
+export interface SpawnDecision {
+    timeline: boolean;
+    taskIndex: number | null;
+    taskDescription?: string | null;
+    dependencyHint?: string | null;
+}
+export interface FoldAgentsOptions {
+    /** The application's decision at `agent:spawn`. Default: every agent is tracked by its numbers only, with no timeline and no task. */
+    spawn?: (ev: Extract<AgentEvent, {
+        type: 'agent:spawn';
+    }>) => SpawnDecision;
+    /** The tool whose call ends the turn. Its call is not a timeline row: the report streamed live and
+     *  `agent:return` files it. */
+    terminal?: string;
+    /** The argument of the terminal tool whose text is the report, streamed as the model writes it; `null` when
+     *  nothing is to be shown until the report is filed at `agent:return`.
+     *  @default 'result' */
+    terminalField?: string | null;
+    /** The clock, for tests. */
+    now?: () => number;
+}
+/** The argument a terminal tool's report is read from unless the application names another. */
+export declare const DEFAULT_TERMINAL_FIELD = "result";
+/** Live report markdown from a raw Hermes tool-call buffer
+ *  (`<tool_call>\n<function=TOOL>\n<parameter=FIELD>\n<markdown>\n</parameter>…`). Null until the open marker
+ *  arrives, so a half-written call never flashes as prose. A forced recovery streams raw prose with no envelope —
+ *  callers branch on `recovering` first.
+ *
+ *  Name the terminal `tool` and only ITS call is read: an argument name says nothing about which tool it belongs
+ *  to, and an ordinary tool may well share one (`write_file(body)` beside `finish(body)`). Without a tool, any
+ *  call carrying the argument is read. */
+export declare function extractStreamingReport(buffer: string, terminal?: {
+    tool?: string;
+    field?: string | null;
+}): string | null;
+/** First meaningful line of a think-block body, cleaned up for a title. */
+export declare function extractTitle(body: string): string;
+export declare function hostOf(url: string): string;
+/** A one-line summary of a tool call's arguments: the query, pattern, url or filename it named. */
+export declare function formatArgSummary(_tool: string, rawArgs: string): string;
+export interface ResultSummary {
+    summary: string;
+    hosts: string[];
+    resultCount: number | null;
+    preview: string | null;
+    sources?: SourceMeta[];
+}
+/** A per-tool summary of a result, parsed from the stock abilities' result
+ *  shapes (web search and fetch, corpus search, grep and read); anything else
+ *  falls back to the URLs it carries, else its size. */
+export declare function summarizeResult(tool: string, raw: string): ResultSummary;
+/**
+ * Fold one agent event into the roster. Returns the same roster when the event
+ * changed nothing. An event for an unknown agent is dropped.
+ */
+export declare function foldAgents(r: AgentRoster, ev: AgentEvent, opts?: FoldAgentsOptions): AgentRoster;
+//# sourceMappingURL=fold.d.ts.map

package/dist/fold.d.ts.map

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