@agentshouse/mdruntime 0.1.0-c5fe3b2cddda7 → 0.1.0-c6197367d5fad

package/dist/context.d.ts

@@ -0,0 +1,2 @@
+export declare function contextFigure(tokens: number): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/context.js

@@ -0,0 +1,7 @@
+export function contextFigure(tokens) {
+    if (Math.round(tokens / 1_000) >= 1_000)
+        return `${(tokens / 1_000_000).toFixed(1).replace(/\.0$/, '')}M`;
+    if (tokens >= 1_000)
+        return `${Math.round(tokens / 1_000)}k`;
+    return String(tokens);
+}

package/dist/conversation-live.d.ts

@@ -0,0 +1,150 @@
+import type { SessionState } from '@agentshouse/session-content';
+import type { AcceptedMessage, ConversationAction, ConversationHistoryRequest, ConversationStream, ListedAgent, ListedConversation, ProcessCommand, SessionOption } from './adapter.js';
+import { type Cell } from './cell.js';
+import type { ChangeSet } from './change-set.js';
+import type { Asked, ConversationAgent, ConversationEntry, ConversationView, RunningTurn } from './conversation.js';
+import type { CallResult } from './outcome.js';
+import type { Recovery } from './recovery.js';
+import type { Attempt, Retries } from './retried.js';
+import type { ChatDraftRecord, RuntimeStore } from './store.js';
+export type ConversationDependencies = {
+    call(name: ConversationAction, input: unknown, attempt?: Attempt): Promise<CallResult>;
+    history(request: ConversationHistoryRequest): Promise<CallResult>;
+    durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
+    local(): Promise<RuntimeStore>;
+    again(): void;
+    settled(): void;
+    stream(): ConversationStream | undefined;
+    publish(set: ChangeSet): void;
+    online(): boolean;
+    full(): boolean;
+    closed(): boolean;
+    unanswered(): void;
+    heard(operation: string, lost: boolean): void;
+    readonly recovery: Recovery;
+    readonly retries: Retries;
+};
+export type Live = {
+    turn: RunningTurn | null;
+    questions: readonly unknown[];
+    process: {
+        running: boolean;
+    } | null;
+    commands: readonly ProcessCommand[];
+    options: readonly SessionOption[];
+    starting: string | null;
+    state: SessionState | null;
+    link: {
+        connected: boolean;
+    } | null;
+    deliveryWaiting: readonly string[];
+    deliveryUnknown: readonly string[];
+};
+export declare const QUIET: Live;
+export type Fact = Exclude<keyof Live, 'turn'>;
+export declare const FACTS: readonly Fact[];
+type Watcher = {
+    readonly notify: (view: ConversationView) => void;
+};
+export type Kept = {
+    readonly draft: ChatDraftRecord | null;
+    readonly ended: string | null;
+    readonly dismissed: string | null;
+    readonly pins: readonly string[];
+};
+type HeldWindow = Kept & {
+    readonly window: readonly AcceptedMessage[] | null;
+    readonly more: boolean;
+    readonly total: number | null;
+};
+export type SharedView = {
+    readonly conversation: string;
+    readonly asked: Asked;
+    readonly held: Cell<HeldWindow>;
+    ready(): readonly Watcher[];
+    join(watcher: Watcher): void;
+    admit(watcher: Watcher): boolean;
+    leave(watcher: Watcher): boolean;
+    empty(): boolean;
+};
+type Listing<T> = (value: T) => void;
+export type Audience<T> = {
+    waiting(): boolean;
+    told(): boolean;
+    join(watcher: Listing<T>): void;
+    leave(watcher: Listing<T>): void;
+    tell(value: T): void;
+    welcome(value: T): void;
+    clear(): void;
+};
+type HeldFacts = {
+    readonly listKnown: boolean;
+    readonly openingRead: boolean;
+    readonly openingListed: boolean;
+    readonly listOwed: boolean;
+    readonly listTelling: boolean;
+    readonly agentsShown: string | null;
+    readonly listedShown: string | null;
+    readonly replicated: ReadonlySet<string>;
+    readonly handedReplicated: string | undefined;
+};
+export type Dispatch = Cell<{
+    readonly answered: boolean;
+}>;
+export type Relisted = {
+    readonly conversations: ReadonlyMap<string, ListedConversation>;
+    readonly agents: ReadonlyMap<string, ListedAgent>;
+};
+export type LiveConversations = {
+    readonly deps: ConversationDependencies;
+    readonly held: Cell<HeldFacts>;
+    readonly closing: AbortSignal;
+    readonly listeners: Audience<readonly ConversationEntry[]>;
+    readonly agentListeners: Audience<readonly ConversationAgent[]>;
+    readonly listedListeners: Audience<readonly ListedAgent[]>;
+    views(): Iterable<SharedView>;
+    viewJoined(key: string, conversation: string, asked: Asked, notify: (view: ConversationView) => void): {
+        readonly view: SharedView;
+        readonly watcher: Watcher;
+    };
+    viewLeft(key: string, view: SharedView, watcher: Watcher): void;
+    liveOf(conversation: string): Live;
+    liveHeld(conversation: string): Live | undefined;
+    holdLive(conversation: string, next: Live | null): void;
+    factsOwed(conversation: string): void;
+    factsHeard(conversation: string, facts: readonly Fact[]): void;
+    factsTaken(): readonly (readonly [string, ReadonlySet<Fact>])[];
+    behind(conversation: string): boolean;
+    behindAll(): readonly string[];
+    fellBehind(conversation: string): void;
+    caughtUpTo(conversation: string): void;
+    gapOpened(conversation: string): void;
+    generation(conversation: string): number;
+    heardAt(conversation: string, change: string): void;
+    newestHeard(conversation: string): string | undefined;
+    catching(conversation: string): Promise<void> | undefined;
+    catchingUntil(conversation: string, ended: Promise<void>): void;
+    creating(conversation: string): void;
+    created(conversation: string): void;
+    isCreating(conversation: string): boolean;
+    relisting(): boolean;
+    relistBegun(): void;
+    relistHeard(entries: readonly ListedConversation[], agents: readonly ListedAgent[]): void;
+    relistDropped(conversation: string): void;
+    relistTaken(): Relisted | null;
+    sendingBegan(operation: string): Dispatch;
+    sendingEnded(operation: string, dispatch: Dispatch): void;
+    sending(operation: string): boolean;
+    rowSoon(tell: () => void): void;
+    inOrder(work: () => Promise<void>): void;
+    forget(conversation: string): void;
+    current(): boolean;
+    known(): boolean;
+    listed(): boolean;
+    reopened(): void;
+    lost(): void;
+    close(): void;
+};
+export declare function createLiveConversations(deps: ConversationDependencies): LiveConversations;
+export {};
+//# sourceMappingURL=conversation-live.d.ts.map

package/dist/conversation-live.d.ts.map

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

package/dist/conversation-live.js

@@ -0,0 +1,259 @@
+import { createCell } from './cell.js';
+export const QUIET = {
+    turn: null,
+    questions: [],
+    process: null,
+    commands: [],
+    options: [],
+    starting: null,
+    state: null,
+    link: null,
+    deliveryWaiting: [],
+    deliveryUnknown: [],
+};
+export const FACTS = [
+    'questions',
+    'process',
+    'commands',
+    'options',
+    'starting',
+    'state',
+    'link',
+    'deliveryWaiting',
+    'deliveryUnknown',
+];
+// A row is read at a glance and each telling clones the list to every observing tab, while a running line changes at each Kit flush.
+const ROW_INTERVAL_MS = 1_000;
+function createAudience() {
+    const told = new Set();
+    const waiting = new Set();
+    return {
+        waiting: () => waiting.size > 0,
+        told: () => told.size > 0,
+        join(watcher) {
+            waiting.add(watcher);
+        },
+        leave(watcher) {
+            waiting.delete(watcher);
+            told.delete(watcher);
+        },
+        tell(value) {
+            for (const watcher of told)
+                watcher(value);
+        },
+        welcome(value) {
+            for (const watcher of [...waiting]) {
+                waiting.delete(watcher);
+                told.add(watcher);
+                watcher(value);
+            }
+        },
+        clear() {
+            told.clear();
+            waiting.clear();
+        },
+    };
+}
+function sharedView(conversation, asked) {
+    const watchers = new Map();
+    return {
+        conversation,
+        asked,
+        held: createCell({
+            window: null,
+            draft: null,
+            ended: null,
+            dismissed: null,
+            pins: [],
+            more: false,
+            total: null,
+        }),
+        ready: () => [...watchers].filter(([, ready]) => ready).map(([watcher]) => watcher),
+        join(watcher) {
+            watchers.set(watcher, false);
+        },
+        admit(watcher) {
+            if (!watchers.has(watcher))
+                return false;
+            watchers.set(watcher, true);
+            return true;
+        },
+        leave: (watcher) => watchers.delete(watcher),
+        empty: () => watchers.size === 0,
+    };
+}
+export function createLiveConversations(deps) {
+    const sending = new Map();
+    const behind = new Set();
+    const catching = new Map();
+    const gaps = new Map();
+    const lives = new Map();
+    const unsent = new Map();
+    const views = new Map();
+    const heardNewest = new Map();
+    const creations = new Set();
+    const closing = new AbortController();
+    const listeners = createAudience();
+    const agentListeners = createAudience();
+    const listedListeners = createAudience();
+    const held = createCell({
+        listKnown: false,
+        openingRead: false,
+        openingListed: false,
+        listOwed: false,
+        listTelling: false,
+        agentsShown: null,
+        listedShown: null,
+        replicated: new Set(),
+        handedReplicated: undefined,
+    });
+    let relisting = null;
+    let rowTimer = null;
+    let ordered = Promise.resolve();
+    return {
+        deps,
+        held,
+        closing: closing.signal,
+        listeners,
+        agentListeners,
+        listedListeners,
+        views: () => views.values(),
+        viewJoined(key, conversation, asked, notify) {
+            const view = views.get(key) ?? sharedView(conversation, asked);
+            views.set(key, view);
+            const watcher = { notify };
+            view.join(watcher);
+            return { view, watcher };
+        },
+        viewLeft(key, view, watcher) {
+            if (!view.leave(watcher))
+                return;
+            if (view.empty())
+                views.delete(key);
+        },
+        liveOf: (conversation) => lives.get(conversation) ?? QUIET,
+        liveHeld: (conversation) => lives.get(conversation),
+        holdLive(conversation, next) {
+            if (next === null)
+                lives.delete(conversation);
+            else
+                lives.set(conversation, next);
+        },
+        factsOwed(conversation) {
+            unsent.set(conversation, new Set(FACTS));
+        },
+        factsHeard(conversation, facts) {
+            const owed = unsent.get(conversation);
+            for (const fact of facts)
+                owed?.delete(fact);
+        },
+        factsTaken() {
+            const owed = [...unsent];
+            unsent.clear();
+            return owed;
+        },
+        behind: (conversation) => behind.has(conversation),
+        behindAll: () => [...behind],
+        fellBehind(conversation) {
+            behind.add(conversation);
+        },
+        caughtUpTo(conversation) {
+            behind.delete(conversation);
+        },
+        gapOpened(conversation) {
+            gaps.set(conversation, (gaps.get(conversation) ?? 0) + 1);
+            behind.add(conversation);
+        },
+        generation: (conversation) => gaps.get(conversation) ?? 0,
+        heardAt(conversation, change) {
+            const heard = heardNewest.get(conversation);
+            if (heard === undefined || change > heard)
+                heardNewest.set(conversation, change);
+        },
+        newestHeard: (conversation) => heardNewest.get(conversation),
+        catching: (conversation) => catching.get(conversation),
+        catchingUntil(conversation, ended) {
+            catching.set(conversation, ended);
+            void ended.then(() => {
+                if (catching.get(conversation) === ended)
+                    catching.delete(conversation);
+            });
+        },
+        creating(conversation) {
+            creations.add(conversation);
+        },
+        created(conversation) {
+            creations.delete(conversation);
+        },
+        isCreating: (conversation) => creations.has(conversation),
+        relisting: () => relisting !== null,
+        relistBegun() {
+            relisting ??= { conversations: new Map(), agents: new Map() };
+        },
+        relistHeard(entries, agents) {
+            for (const entry of entries)
+                relisting?.conversations.set(entry.conversation, { ...entry });
+            for (const agent of agents)
+                relisting?.agents.set(agent.id, { ...agent });
+        },
+        relistDropped(conversation) {
+            relisting?.conversations.delete(conversation);
+        },
+        relistTaken() {
+            const whole = relisting;
+            relisting = null;
+            return whole;
+        },
+        sendingBegan(operation) {
+            const dispatch = createCell({ answered: false });
+            sending.set(operation, dispatch);
+            return dispatch;
+        },
+        sendingEnded(operation, dispatch) {
+            if (sending.get(operation) === dispatch)
+                sending.delete(operation);
+        },
+        sending: (operation) => sending.has(operation),
+        rowSoon(tell) {
+            if (rowTimer !== null)
+                return;
+            rowTimer = setTimeout(() => {
+                rowTimer = null;
+                tell();
+            }, ROW_INTERVAL_MS);
+        },
+        inOrder(work) {
+            ordered = ordered.then(work);
+        },
+        forget(conversation) {
+            behind.delete(conversation);
+            heardNewest.delete(conversation);
+            unsent.delete(conversation);
+        },
+        current: () => behind.size === 0,
+        known: () => held.now().listKnown,
+        listed: () => deps.stream() === undefined || held.now().openingListed,
+        reopened() {
+            relisting = null;
+            held.set({ openingRead: false, openingListed: false });
+            for (const [operation, dispatch] of sending)
+                if (!dispatch.now().answered)
+                    sending.delete(operation);
+        },
+        lost() {
+            catching.clear();
+        },
+        close() {
+            closing.abort();
+            if (rowTimer !== null)
+                clearTimeout(rowTimer);
+            rowTimer = null;
+            views.clear();
+            lives.clear();
+            unsent.clear();
+            listeners.clear();
+            agentListeners.clear();
+            listedListeners.clear();
+        },
+    };
+}

package/dist/conversation-row.d.ts

@@ -0,0 +1,40 @@
+import type { HeldRow } from './messages.js';
+import { type HouseSource, type RequestAnswer } from './source.js';
+export type ConversationLast = {
+    readonly text: string;
+    readonly by: 'owner' | 'agent' | 'house';
+    readonly at: string;
+};
+export type ConversationStart = Extract<HouseSource, {
+    readonly kind: 'request' | 'trigger';
+}>;
+export type ConversationAsk = {
+    readonly who: string;
+    readonly fromRoom: boolean;
+    readonly agent: string | null;
+    readonly room: {
+        readonly ref: string;
+        readonly handle: string;
+        readonly name: string;
+    };
+    readonly prompt: string;
+    readonly agentFunction: string | null;
+    readonly answer: RequestAnswer | null;
+    readonly instruction: string | null;
+    readonly at: string;
+    readonly request: string;
+    readonly message?: string;
+};
+export type ConversationHeld = {
+    readonly last: ConversationLast | null;
+    readonly answered: string | null;
+    readonly opened: string | null;
+    readonly failure: string | null;
+    readonly startedBy: ConversationStart | null;
+    readonly asks: ConversationAsk | null;
+};
+export declare function heldFacts(held: HeldRow | undefined, listed: {
+    readonly outcome: string | null;
+    readonly waiting: boolean;
+}): ConversationHeld;
+//# sourceMappingURL=conversation-row.d.ts.map

package/dist/conversation-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-row.d.ts","sourceRoot":"","sources":["../src/conversation-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC;AAE/F,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CACvC,CAAC;AA8DF,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrE,gBAAgB,CAUlB"}

package/dist/conversation-row.js

@@ -0,0 +1,66 @@
+import { sourceOf } from './source.js';
+const SPEAKERS = {
+    user: 'owner',
+    assistant: 'agent',
+    house: 'house',
+};
+function lastOf(said) {
+    const by = SPEAKERS[said?.role ?? ''];
+    return said?.at == null || by === undefined ? null : { text: said.text, by, at: said.at };
+}
+function startOf(opened) {
+    const source = opened === null ? null : sourceOf(opened.source, opened.sender);
+    return source?.kind === 'request' || source?.kind === 'trigger' ? source : null;
+}
+function asksOf(asking, started, waiting) {
+    if (asking?.at == null)
+        return null;
+    const { at, text: prompt, identity } = asking;
+    const source = sourceOf(asking.source, asking.sender);
+    if (source?.kind === 'request') {
+        const { requester, room, request, sent, agentFunction, answer, instruction } = source;
+        return waiting
+            ? {
+                who: requester.name,
+                fromRoom: requester.room,
+                agent: null,
+                room,
+                prompt: sent,
+                agentFunction: agentFunction?.name ?? null,
+                answer,
+                instruction,
+                at,
+                request,
+            }
+            : null;
+    }
+    if (source?.kind !== 'mail' || started?.kind !== 'request')
+        return null;
+    const { owner, agent, room, request } = source;
+    return started.request === request
+        ? {
+            who: owner,
+            fromRoom: false,
+            agent,
+            room: { ref: room, handle: started.room.handle, name: started.room.name },
+            prompt,
+            agentFunction: null,
+            answer: null,
+            instruction: null,
+            at,
+            request,
+            message: identity,
+        }
+        : null;
+}
+export function heldFacts(held, listed) {
+    const startedBy = startOf(held?.opened ?? null);
+    return {
+        last: lastOf(held?.said ?? null),
+        answered: held?.answered ?? null,
+        opened: held?.openedTurn ?? null,
+        failure: listed.outcome === 'failed' ? (held?.failure ?? null) : null,
+        startedBy,
+        asks: asksOf(held?.asking ?? null, startedBy, listed.waiting),
+    };
+}