@owlmeans/agent-common 0.1.18-rc.7 → 0.1.18

package/build/results.js

@@ -0,0 +1,218 @@
+import { DEFAULT_RESULT_COMPACT_CHARS, DEFAULT_RESULT_ENTRY_CHARS, DEFAULT_RESULT_SUMMARY_CHARS, RESULTS_EVERY_STEP, CumulativeFactKind, CumulativeResultSource } from './consts.js';
+import { truncateAt } from './helpers/truncate.js';
+import { NAMES_ONLY, NOT_VERIFIED, PARTIAL_EMPTY, PARTIAL_WITH_FACTS, SEEDED, SUMMARY_ALONE, SUMMARY_LEFT_OUT, SUMMARY_WITH_FACTS } from './consts.local.js';
+export const createCumulativeResultsHelper = () => {
+    const compare = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+    const oneLine = (text) => text.replace(/\s+/g, ' ').trim();
+    const factKey = (fact) => `${fact.kind}\u0000${fact.name}\u0000${fact.specifier ?? fact.path ?? ''}`;
+    /** File facts last — a location is the first thing a budget can spare, a shape the last. */
+    const kindRank = (kind) => kind === CumulativeFactKind.File ? 1 : 0;
+    const sortFacts = (facts) => [...facts].sort((a, b) => kindRank(a.kind) - kindRank(b.kind)
+        || compare(a.kind, b.kind)
+        || compare(a.name, b.name)
+        || compare(a.specifier ?? a.path ?? '', b.specifier ?? b.path ?? ''));
+    const renderResultFact = (fact) => {
+        let line = `- ${fact.kind} \`${oneLine(fact.name)}\``;
+        const shape = fact.signature != null && fact.signature.trim() !== ''
+            ? oneLine(fact.signature)
+            : fact.members != null && fact.members.length > 0
+                ? `{ ${fact.members.map(oneLine).join(', ')} }`
+                : '';
+        if (shape !== '') {
+            line += `: ${shape}`;
+        }
+        const attrs = Object.keys(fact.attrs ?? {}).sort(compare)
+            .map(key => `${key}: ${oneLine(fact.attrs[key])}`);
+        if (attrs.length > 0) {
+            line += ` (${attrs.join(', ')})`;
+        }
+        if (fact.ref != null && fact.ref !== '') {
+            line += ` → \`${oneLine(fact.ref)}\``;
+        }
+        if (fact.specifier != null && fact.specifier !== '') {
+            line += ` — import from \`${fact.specifier}\``;
+        }
+        if (fact.path != null && fact.path !== '' && fact.path !== fact.name) {
+            line += fact.specifier != null && fact.specifier !== ''
+                ? ` (file \`${fact.path}\`)`
+                : ` — file \`${fact.path}\``;
+        }
+        return line;
+    };
+    const moreFacts = (count) => `- … and ${count} more not listed here for space. They exist: check the files before creating anything similar.`;
+    const moreNames = (count) => `- … and ${count} more`;
+    const heading = (entry, compact) => {
+        const notes = [];
+        const hasFacts = entry.facts.length > 0;
+        if (entry.partial === true) {
+            notes.push(hasFacts ? PARTIAL_WITH_FACTS : PARTIAL_EMPTY);
+        }
+        if (entry.source === CumulativeResultSource.Seeded) {
+            notes.push(SEEDED);
+        }
+        if (!hasFacts && entry.summary != null) {
+            notes.push(NOT_VERIFIED);
+        }
+        if (compact && (hasFacts || entry.summary != null)) {
+            notes.push(hasFacts ? NAMES_ONLY : SUMMARY_LEFT_OUT);
+        }
+        return `### ${entry.label}${notes.length > 0 ? ` (${notes.join('; ')})` : ''}`;
+    };
+    /** Lines under `head`, as many as fit in `max`, with `more(n)` saying how many did not. */
+    const fit = (head, lines, tail, max, more) => {
+        const total = (parts) => parts.join('\n').length;
+        if (total([...head, ...lines, ...tail]) <= max) {
+            return [...head, ...lines, ...tail].join('\n');
+        }
+        // Room for the "more" line is reserved at its widest, so adding it can never break the cap.
+        const reserve = more(lines.length).length + 1;
+        const kept = [];
+        for (const line of lines) {
+            if (total([...head, ...kept, line, ...tail]) + reserve > max) {
+                break;
+            }
+            kept.push(line);
+        }
+        return [...head, ...kept, more(lines.length - kept.length), ...tail].join('\n');
+    };
+    const renderResultEntry = (entry, caps = {}) => {
+        const maxChars = caps.maxChars ?? DEFAULT_RESULT_ENTRY_CHARS;
+        const maxCompactChars = caps.maxCompactChars ?? DEFAULT_RESULT_COMPACT_CHARS;
+        const facts = sortFacts(entry.facts);
+        if (facts.length === 0 && entry.summary == null && entry.partial !== true) {
+            return { full: '', compact: '' };
+        }
+        const summary = entry.summary != null && entry.summary.trim() !== ''
+            ? [`${facts.length > 0 ? SUMMARY_WITH_FACTS : SUMMARY_ALONE} ${oneLine(entry.summary)}`]
+            : [];
+        const full = fit([heading(entry, false)], facts.map(renderResultFact), summary, maxChars, moreFacts);
+        const byKind = new Map();
+        for (const fact of facts) {
+            const names = byKind.get(fact.kind) ?? [];
+            if (!names.includes(fact.name)) {
+                names.push(fact.name);
+            }
+            byKind.set(fact.kind, names);
+        }
+        // One line per kind while the names fit; the rest are counted, never cut.
+        const compactHead = heading(entry, true);
+        const namesWithin = (reserve) => {
+            const lines = [];
+            let left = 0;
+            for (const [kind, names] of byKind) {
+                let line = `- ${kind}:`;
+                let taken = 0;
+                for (const name of names) {
+                    const next = `${line}${taken > 0 ? ',' : ''} \`${oneLine(name)}\``;
+                    if (left > 0 || [compactHead, ...lines, next].join('\n').length + reserve > maxCompactChars) {
+                        left += 1;
+                        continue;
+                    }
+                    line = next;
+                    taken += 1;
+                }
+                if (taken > 0) {
+                    lines.push(line);
+                }
+            }
+            return { lines, left };
+        };
+        let names = namesWithin(0);
+        if (names.left > 0) {
+            // Room for the "more" line is reserved at its widest, so adding it can never break the cap.
+            names = namesWithin(moreNames(facts.length).length + 1);
+        }
+        const compact = [
+            compactHead, ...names.lines, ...(names.left > 0 ? [moreNames(names.left)] : []),
+        ].join('\n');
+        return { full, compact };
+    };
+    const compareResultOrder = (a, b) => {
+        for (let i = 0; i < Math.min(a.length, b.length); ++i) {
+            if (a[i] !== b[i]) {
+                return a[i] - b[i];
+            }
+        }
+        return b.length - a.length;
+    };
+    const rootRunOf = (runId) => {
+        const at = runId.indexOf('/');
+        return at < 0 ? runId : runId.slice(0, at);
+    };
+    const resultLabel = (ledger, runId, step) => {
+        const path = runId === ledger
+            ? ''
+            : runId.startsWith(`${ledger}/`)
+                ? runId.slice(ledger.length + 1)
+                : runId.slice(rootRunOf(runId).length + 1);
+        return path !== '' ? `${path}/${step}` : step;
+    };
+    const flatten = (value) => {
+        if (value == null) {
+            return '';
+        }
+        if (typeof value === 'string') {
+            return oneLine(value);
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        if (Array.isArray(value)) {
+            return value.map(flatten).filter(part => part !== '').join(', ');
+        }
+        if (typeof value === 'object') {
+            return Object.keys(value).sort(compare)
+                .map(key => [key, flatten(value[key])])
+                .filter(([, text]) => text !== '')
+                .map(([key, text]) => `${key}: ${text}`)
+                .join('; ');
+        }
+        return '';
+    };
+    const renderResultSummary = (answer, maxChars = DEFAULT_RESULT_SUMMARY_CHARS) => {
+        const single = typeof answer === 'object' && answer != null && !Array.isArray(answer)
+            && Object.keys(answer).length === 1
+            ? answer[Object.keys(answer)[0]]
+            : answer;
+        return truncateAt(flatten(single), maxChars);
+    };
+    const union = (left, right) => left == null && right == null ? undefined : [...new Set([...(left ?? []), ...(right ?? [])])];
+    const mergeStep = (base, patch) => {
+        const extractors = union(base?.extractors, patch.extractors);
+        const omit = union(base?.omit, patch.omit);
+        const full = base?.full === RESULTS_EVERY_STEP || patch.full === RESULTS_EVERY_STEP
+            ? RESULTS_EVERY_STEP
+            : union(base?.full, patch.full);
+        return {
+            ...base,
+            ...patch,
+            ...(extractors != null ? { extractors } : {}),
+            ...(omit != null ? { omit } : {}),
+            ...(full != null ? { full } : {}),
+        };
+    };
+    const mergeResultsSpecs = (...specs) => {
+        const merged = {};
+        for (const spec of specs) {
+            if (spec == null) {
+                continue;
+            }
+            const { steps, ...scalars } = spec;
+            Object.assign(merged, scalars);
+            if (steps != null) {
+                const into = { ...merged.steps };
+                for (const name of Object.keys(steps)) {
+                    into[name] = mergeStep(into[name], steps[name]);
+                }
+                merged.steps = into;
+            }
+        }
+        return merged;
+    };
+    return {
+        factKey, sortFacts, renderResultFact, renderResultEntry, compareResultOrder, rootRunOf, resultLabel,
+        renderResultSummary, mergeResultsSpecs,
+    };
+};
+export const cumulativeResultsHelper = createCumulativeResultsHelper();
+//# sourceMappingURL=results.js.map

package/build/results.js.map

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

package/build/types.d.ts

@@ -1,6 +1,6 @@
 import type { ResourceRecord } from '@owlmeans/resource';
-import type { ExecutionState } from '@owlmeans/llm-common';
-import type { AgentRunStatus } from './consts.js';
+import { type AgentRunStatus, PipelineRunStatus } from './consts.js';
+import type { Inquiry } from '@owlmeans/llm-common';
 /**
  * What a conversation is, as an address.
  *
@@ -39,20 +39,6 @@ export interface ConversationEvent extends ResourceRecord {
 export interface ConversationEventInput extends Omit<ConversationEvent, 'id' | 'seq' | 'createdAt'> {
     createdAt?: string;
 }
-/**
- * The data plane of a run.
- *
- * `flow` is the serialized {@link import('@owlmeans/flow').FlowModel} state — the control plane
- * collapsed to a string — and `state` is the execution snapshot the LLM layer produces. Keeping
- * them in one record is what makes a resume a single read.
- */
-export interface AgentRunState extends ResourceRecord {
-    id: string;
-    conversationId: string;
-    flow: string;
-    state: ExecutionState;
-    updatedAt: string;
-}
 /**
  * A node of the subsystem memory graph.
  *
@@ -81,17 +67,153 @@ export interface MemoryEventInput extends Omit<MemoryEvent, 'id' | 'seq' | 'crea
     createdAt?: string;
 }
 /**
- * What a transport carries.
+ * What a transport carries: a POINTER, never a payload.
  *
- * The execution state travels by REFERENCE (`stateRef`), not by value: a project execution's state
- * holds the whole project specification, and a queue whose messages carry that is a queue that
- * falls over on the first large project. The flow string is small enough to inline, and it is what
- * a consumer needs to route the message before it reads anything.
+ * Everything a consumer needs to route the message is here, and everything else is read from the
+ * run row it names. That is not an optimization — a pipeline state is scalars and keys precisely so
+ * that the authority stays in one place, and a message that carried a copy would be a second one,
+ * stale from the moment it was enqueued.
  */
 export interface AgentRunMessage {
-    id: string;
+    runId: string;
     conversationId: string;
-    flow: string;
-    stateRef?: string;
+    /** The pipeline alias, when the message is about a pipeline run rather than a conversation. */
+    pipeline?: string;
+    /** Where the run stood when the message was sent. Advisory — the row is authoritative. */
+    step?: string;
+}
+/**
+ * What a pipeline carries between its steps.
+ *
+ * Scalars and KEYS — ids, revisions, markers, lists of codes. Never an artifact. Everything large a
+ * pipeline produces belongs in a store of its own and travels here as the key that finds it again:
+ * the state is serialized into the run row at every step boundary, and a state that carries a
+ * document is a row that carries it too, once per step.
+ */
+export type PipelineState = Record<string, unknown>;
+export interface PipelineStepSpec {
+    step: string;
+    /**
+     * The steps that must have completed before this one may run.
+     *
+     * Absent or empty means "from the start". Several steps naming the same predecessor fan OUT;
+     * one step naming several predecessors JOINS them. That is the whole edge vocabulary — there is
+     * no conditional edge, because a branch that is expressed as an edge is invisible to a resume,
+     * while a branch expressed as {@link PipelineStep.skipWhen} is the same mechanism that makes a
+     * resume correct.
+     */
+    after?: string[];
+    /** Human-readable, for progress reporting and tool descriptions. */
+    title?: string;
+    /** A failure is recorded on the run's `warnings` and the successors still run. */
+    optional?: boolean;
+    /**
+     * Re-running repeats a side effect that cannot be undone — a wipe, a purge, a claim against a
+     * rate-limited authority, a model call whose output is already on disk.
+     *
+     * A resume never re-enters one of these on its own; `resume(runId, { from })` refuses without
+     * `force`. It is also refused `attempts > 1`, since an automatic retry is exactly the thing the
+     * flag says must not happen.
+     */
+    nonIdempotent?: boolean;
+    /**
+     * Attempts for ONE entry of this step. Default {@link DEFAULT_STEP_ATTEMPTS} = 1.
+     *
+     * Deliberately not a ladder: retry budgets in this family MULTIPLY (an outer 8 around a model's
+     * own inner 8 is 64 real calls), so a step that wants retries asks for them once, here, and the
+     * helpers below it keep theirs.
+     */
+    attempts?: number;
+    /** Wall clock for one attempt, in milliseconds. */
+    timeout?: number;
+}
+export interface PipelineSpec {
+    alias: string;
+    /**
+     * Bumped whenever a step is added, removed or renamed.
+     *
+     * `completed` names steps by string, so a run resumed under a changed spec would skip work it
+     * never did — silently, because an unknown name simply matches nothing. A version mismatch is
+     * refused instead.
+     */
+    version: number;
+    steps: PipelineStepSpec[];
+}
+/**
+ * What a `Waiting` run is waiting for.
+ *
+ * Written by the runner when a step asks a question nobody could answer while it ran, and read by
+ * everything that reports a run — a resume delivers the answer under {@link Inquiry.id}, which is
+ * the only thing that routes it back.
+ */
+export interface PipelineRunInquiry {
+    /** The step that asked. A resume re-enters exactly this one. */
+    step: string;
+    askedAt: string;
+    inquiry: Inquiry;
+}
+/**
+ * The data plane of a pipeline run, and the ONE authority on where it stands.
+ *
+ * Not the LangGraph checkpoint: that is a replay optimization which may legitimately be absent (it
+ * is size-guarded and expires), and a design that trusts it has a silent hole exactly where a
+ * crashed run needs an answer. Everything that reads a run's position — a resume, a reconciler, an
+ * operator, a status endpoint — reads this row.
+ *
+ * Timestamps are ISO strings, never `Date`: these records cross process boundaries and storage
+ * backends. A consumer whose store prefers dates maps them at its own adapter boundary.
+ */
+export interface PipelineRun extends ResourceRecord {
+    /** The business key. Chosen by the caller so a run is addressable before it exists. */
+    runId: string;
+    pipeline: string;
+    version: number;
+    /** The subject the run belongs to — for an application with projects, the project id. */
+    scope: string;
+    /** The tenant. Carried so a store can refuse a read that crosses an organization. */
+    entityId?: string;
+    status: PipelineRunStatus;
+    /** Steps that have finished, in the order they finished. */
+    completed: string[];
+    /** Steps that had not run when the run stopped. Empty on a `Done` run. */
+    pending: string[];
+    /** JSON TEXT of {@link PipelineState}. Text, not a subdocument — a state key is a caller's word. */
+    state: string;
+    stateChars: number;
+    /** What an `optional` step reported when it failed. Never empties a run. */
+    warnings: string[];
+    failedAt?: string;
+    error?: string;
+    /** The last thing a step said about itself. Progress, not state. */
+    note?: string;
+    /**
+     * The question this run stopped on.
+     *
+     * Present only while `status === Waiting`, and cleared on every entry of the run — a row that
+     * kept advertising a question it has already been given would have every reader offer it again.
+     */
+    inquiry?: PipelineRunInquiry;
+    /** Whatever lock the run held, so a resume can re-take the same one. */
+    lockTask?: string;
+    /** How many times this run has been RESUMED. Reset only by a `Done` outcome. */
+    attempts: number;
+    startedAt: string;
+    /**
+     * Written at every step boundary — the only signal that separates a run still working from one
+     * whose process died. A reconciler reads staleness here, never the status.
+     */
+    heartbeatAt: string;
+    updatedAt: string;
+}
+/** What the runner reports as it moves. Never persisted as state. */
+export interface PipelineProgress {
+    pipeline: string;
+    runId: string;
+    step: string;
+    /** 1-based position in the topological order. */
+    index: number;
+    total: number;
+    skipped?: boolean;
+    note?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,mFAAmF;AACnF,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,KAAK,GAAG,WAAW,CAAC;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,KAAK,GAAG,WAAW,CAAC;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent-common",
-  "version": "0.1.18-rc.7",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,17 +22,17 @@
     }
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
-    "@types/bun": "^1.3.14",
-    "@types/node": "^26.1.0",
+    "@owlmeans/dep-config": "^0.1.18",
+    "@types/bun": "^1.4.2",
+    "@types/node": "^26.6.4",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/error": "^0.1.18-rc.6",
-    "@owlmeans/flow": "^0.1.18-rc.6",
-    "@owlmeans/llm-common": "^0.1.18-rc.6",
-    "@owlmeans/resource": "^0.1.18-rc.6"
+    "@owlmeans/error": "^0.1.18",
+    "@owlmeans/flow": "^0.1.18",
+    "@owlmeans/llm-common": "^0.1.18",
+    "@owlmeans/resource": "^0.1.18"
   },
   "publishConfig": {
     "access": "public"

package/src/consts.local.ts

@@ -0,0 +1,15 @@
+export const PARTIAL_WITH_FACTS = 'partial: the step failed part-way; only what it left in the files is listed'
+
+export const PARTIAL_EMPTY = 'partial: the step failed part-way and left nothing that could be read'
+
+export const SEEDED = 'known before this run'
+
+export const NOT_VERIFIED = 'not verified'
+
+export const NAMES_ONLY = 'names only'
+
+export const SUMMARY_LEFT_OUT = 'summary left out for space'
+
+export const SUMMARY_WITH_FACTS = 'Summary (not verified — written by a model, never checked against the files):'
+
+export const SUMMARY_ALONE = 'Summary written by a model, never checked against the files:'