@kindgi/api 0.1.3 → 0.1.4-rc.1

package/dist/routes/judgment-context.js

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { RUN_RETRIEVALS_NODE, SESSION_GATE_RECORD, readGateDecision, } from '@kindgi/agents';
+/** The most messages of conversation history a judged turn keeps. */
+export const MAX_JUDGED_HISTORY = 200;
+/** How many messages are read to find a turn's history. */
+const HISTORY_READ_LIMIT = 1000;
+function obj(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** The sequence of the first message the turn appended (its user message). */
+function firstAppendedSequence(output) {
+    const appended = obj(output)?.appended;
+    if (!Array.isArray(appended))
+        return undefined;
+    const sequences = appended
+        .map((m) => obj(m)?.sequence)
+        .filter((s) => typeof s === 'number');
+    return sequences.length > 0 ? Math.min(...sequences) : undefined;
+}
+async function readHistory(conversations, tenantId, conversationId, before) {
+    const read = await conversations.readMessages({
+        tenantId,
+        conversationId: conversationId,
+        limit: HISTORY_READ_LIMIT,
+    });
+    if (read.kind === 'err')
+        return {};
+    const earlier = read.value.filter((m) => m.sequence < before);
+    const kept = earlier.slice(-MAX_JUDGED_HISTORY);
+    return {
+        history: kept,
+        ...(kept.length < earlier.length && { historyTruncated: true }),
+    };
+}
+/** What the turn's journal says it retrieved, and how its session approval was decided. */
+async function readJournalParts(runBinding, tenantId, runId) {
+    const journal = await runBinding.readJournal(tenantId, runId);
+    if (journal.kind === 'err')
+        return {};
+    const entries = journal.value;
+    const step = entries.find((e) => e.kind === 'step.completed' &&
+        typeof e.nodeId === 'string' &&
+        (e.nodeId === RUN_RETRIEVALS_NODE || e.nodeId.endsWith(`/${RUN_RETRIEVALS_NODE}`)));
+    const retrieved = obj(obj(step?.payload)?.output)?.retrieved;
+    const sessionApproval = sessionApprovalOf(entries);
+    return {
+        ...(retrieved !== undefined && { retrieved }),
+        ...(sessionApproval !== undefined && { sessionApproval }),
+    };
+}
+/** The decision that resolved the turn's session approval gate, if it waited on one. */
+function sessionApprovalOf(entries) {
+    const gate = entries.find((e) => e.kind === 'value.recorded' && obj(e.payload)?.key === SESSION_GATE_RECORD);
+    const tokenId = obj(obj(gate?.payload)?.value)?.waitTokenId;
+    if (typeof tokenId !== 'string')
+        return undefined;
+    const resumed = entries.find((e) => e.kind === 'wait.resumed' && obj(e.payload)?.tokenId === tokenId);
+    if (resumed === undefined)
+        return undefined;
+    const decision = readGateDecision(obj(resumed.payload)?.value);
+    return {
+        approved: decision.approved,
+        ...(!decision.approved &&
+            decision.rationale !== undefined && { rationale: decision.rationale }),
+    };
+}
+/**
+ * What a judged agent turn read besides its input, so it can be replayed
+ * faithfully later: the conversation before the turn, what its
+ * retrievals returned, and the decision at its session approval gate. Best effort and read-only: a part that can't be
+ * read is left out (the judgment never fails over it). `undefined` for
+ * a flow run, or when nothing could be read.
+ */
+export async function captureTurnContext(input) {
+    const before = firstAppendedSequence(input.output);
+    const [history, journal] = await Promise.all([
+        input.conversations !== undefined && input.conversationId !== undefined && before !== undefined
+            ? readHistory(input.conversations, input.tenantId, input.conversationId, before).catch(() => ({}))
+            : Promise.resolve({}),
+        readJournalParts(input.runBinding, input.tenantId, input.runId).catch(() => ({})),
+    ]);
+    const context = { ...history, ...journal };
+    return Object.keys(context).length > 0 ? context : undefined;
+}
+//# sourceMappingURL=judgment-context.js.map

package/dist/routes/judgment-context.js.map

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

package/dist/routes/judgment-flow-context.d.ts

@@ -0,0 +1,32 @@
+import type { RunBinding } from '@kindgi/runtime';
+import type { TenantId } from '@kindgi/types';
+import type { FlowRegistryBinding } from '../flow-binding.js';
+import type { JudgedRunContext } from '../judgment-binding.js';
+/** The most tool calls a judged flow run keeps. */
+export declare const MAX_JUDGED_FLOW_CALLS = 500;
+/**
+ * The tool calls an agent turn made, with their results, from its
+ * output's `appended` messages: each agent message's `toolCalls`, paired
+ * with the `tool` message that answered it.
+ */
+export declare function turnToolCalls(output: unknown): readonly {
+    readonly toolId: string;
+    readonly arguments: unknown;
+    readonly result: unknown;
+}[];
+/**
+ * What a judged flow run did (`context.flow`): its tool calls with their
+ * results, and its agent steps' turns. `undefined` when nothing could be
+ * read.
+ */
+export declare function captureFlowContext(input: {
+    readonly tenantId: TenantId;
+    readonly run: {
+        readonly runId: string;
+        readonly flowId: string;
+        readonly flowVersion: string;
+    };
+    readonly runBinding: RunBinding;
+    readonly flows: FlowRegistryBinding | undefined;
+}): Promise<JudgedRunContext | undefined>;
+//# sourceMappingURL=judgment-flow-context.d.ts.map

package/dist/routes/judgment-flow-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judgment-flow-context.d.ts","sourceRoot":"","sources":["../../src/routes/judgment-flow-context.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAEhC,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AA4BzC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,GACd,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,CAuB/F;AAmID;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACjD,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAmBxC"}

package/dist/routes/judgment-flow-context.js

@@ -0,0 +1,195 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { isFanoutNode, isLoopNode } from '@kindgi/flow';
+/** The most tool calls a judged flow run keeps. */
+export const MAX_JUDGED_FLOW_CALLS = 500;
+/** How deep into sub-flows the capture goes. */
+const MAX_FLOW_DEPTH = 3;
+/** The most child runs read per run. */
+const MAX_CHILDREN = 100;
+function obj(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** The tool each tool node runs, by node id: in loop bodies and fanout branches too. */
+function toolNodes(flow) {
+    const tools = new Map();
+    const walk = (nodes) => {
+        for (const node of nodes) {
+            if (node.kind === 'tool')
+                tools.set(node.id, node.ref);
+            else if (isLoopNode(node))
+                walk(node.body.nodes);
+            else if (isFanoutNode(node)) {
+                for (const b of node.branches)
+                    tools.set(b.handler, b.handler);
+            }
+        }
+    };
+    if (flow !== null)
+        walk(flow.nodes);
+    return tools;
+}
+/**
+ * The tool calls an agent turn made, with their results, from its
+ * output's `appended` messages: each agent message's `toolCalls`, paired
+ * with the `tool` message that answered it.
+ */
+export function turnToolCalls(output) {
+    const appended = obj(output)?.appended;
+    if (!Array.isArray(appended))
+        return [];
+    const args = new Map();
+    for (const m of appended) {
+        const calls = obj(obj(m)?.content)?.toolCalls;
+        if (obj(m)?.role !== 'agent' || !Array.isArray(calls))
+            continue;
+        for (const call of calls) {
+            const id = obj(call)?.id;
+            if (typeof id === 'string')
+                args.set(id, obj(call)?.arguments);
+        }
+    }
+    return appended.flatMap((m) => {
+        const toolCall = obj(obj(m)?.toolCall);
+        const toolId = toolCall?.toolId;
+        const invocationId = toolCall?.invocationId;
+        if (obj(m)?.role !== 'tool' || typeof toolId !== 'string' || typeof invocationId !== 'string') {
+            return [];
+        }
+        return args.has(invocationId)
+            ? [{ toolId, arguments: args.get(invocationId), result: obj(m)?.content }]
+            : [];
+    });
+}
+/** Where a step sits: its loop iteration, when it's in a loop body. */
+function scopeOf(loopContext) {
+    return loopContext === undefined || loopContext === null
+        ? undefined
+        : JSON.stringify(loopContext);
+}
+class Collector {
+    calls = [];
+    steps = [];
+    truncated = false;
+    add(call) {
+        if (this.calls.length >= MAX_JUDGED_FLOW_CALLS) {
+            this.truncated = true;
+            return;
+        }
+        this.calls.push(call);
+    }
+}
+/** A flow run's tool nodes' calls: each `step.completed` of a tool node, with its `step.started` input. */
+async function nodeCalls(r, c, run) {
+    const [flow, journal] = await Promise.all([
+        r.flows?.getVersion({
+            tenantId: r.tenantId,
+            flowId: run.flowId,
+            version: run.flowVersion,
+        }) ?? Promise.resolve(null),
+        r.runBinding.readJournal(r.tenantId, run.runId),
+    ]);
+    const tools = toolNodes(flow);
+    if (journal.kind === 'err' || tools.size === 0)
+        return;
+    const inputs = new Map();
+    for (const e of journal.value) {
+        if (typeof e.nodeId !== 'string' || !tools.has(e.nodeId))
+            continue;
+        const payload = obj(e.payload) ?? {};
+        const scope = scopeOf(payload.loopContext);
+        const key = `${e.nodeId}\u0000${scope ?? ''}`;
+        if (e.kind === 'step.started')
+            inputs.set(key, payload.input);
+        if (e.kind === 'step.completed') {
+            c.add({
+                runId: run.runId,
+                nodeId: e.nodeId,
+                ...(scope !== undefined && { scope }),
+                toolId: tools.get(e.nodeId),
+                arguments: inputs.get(key),
+                result: payload.output,
+            });
+        }
+    }
+}
+/** An agent step's turn: its calls, and what it retrieved. */
+async function stepTurn(r, c, child) {
+    const agent = child.agent;
+    if (agent === undefined)
+        return;
+    const output = child.output ?? (await r.runBinding.getRun(r.tenantId, child.runId))?.output ?? undefined;
+    const nodeId = child.parentNodeId ?? undefined;
+    const scope = child.parentScope ?? undefined;
+    const retrieved = obj(output)?.retrieved;
+    c.steps.push({
+        runId: child.runId,
+        ...(nodeId !== undefined && { nodeId }),
+        ...(scope !== undefined && scope !== '' && { scope }),
+        agentId: agent.id,
+        agentVersion: agent.version,
+        ...(retrieved !== undefined && { retrieved }),
+    });
+    for (const call of turnToolCalls(output)) {
+        c.add({
+            runId: child.runId,
+            ...(nodeId !== undefined && { nodeId }),
+            ...(scope !== undefined && scope !== '' && { scope }),
+            ...call,
+        });
+    }
+}
+/** A run's child runs (agent steps' turns, sub-flows); none when they can't be read. */
+async function childrenOf(r, runId) {
+    try {
+        const page = await r.runBinding.listRuns({
+            tenantId: r.tenantId,
+            parent: { runId: runId },
+            limit: MAX_CHILDREN,
+        });
+        return page.data;
+    }
+    catch {
+        return [];
+    }
+}
+async function collectRun(r, c, run, depth) {
+    await nodeCalls(r, c, run).catch(() => undefined);
+    for (const child of await childrenOf(r, run.runId)) {
+        if (child.agent !== undefined) {
+            await stepTurn(r, c, child).catch(() => undefined);
+        }
+        else if (depth < MAX_FLOW_DEPTH) {
+            await collectRun(r, c, {
+                runId: child.runId,
+                flowId: child.flowId,
+                flowVersion: child.flowVersion,
+            }, depth + 1);
+        }
+    }
+}
+/**
+ * What a judged flow run did (`context.flow`): its tool calls with their
+ * results, and its agent steps' turns. `undefined` when nothing could be
+ * read.
+ */
+export async function captureFlowContext(input) {
+    const c = new Collector();
+    try {
+        await collectRun({ tenantId: input.tenantId, runBinding: input.runBinding, flows: input.flows }, c, input.run, 0);
+    }
+    catch {
+        // Best effort: keep what was read.
+    }
+    if (c.calls.length === 0 && c.steps.length === 0)
+        return undefined;
+    const flow = {
+        calls: c.calls,
+        steps: c.steps,
+        ...(c.truncated && { truncated: true }),
+    };
+    return { flow };
+}
+//# sourceMappingURL=judgment-flow-context.js.map

package/dist/routes/judgment-flow-context.js.map

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

package/dist/routes/judgments.d.ts

@@ -0,0 +1,41 @@
+import { Hono } from 'hono';
+import type { ConversationBinding } from '@kindgi/agents';
+import type { RunBinding } from '@kindgi/runtime';
+import type { FlowRegistryBinding } from '../flow-binding.js';
+import { type JudgmentRegistryBinding } from '../judgment-binding.js';
+import type { Authorizer } from '../middleware/authorize.js';
+import type { AppEnv } from '../types.js';
+/**
+ * Judgments: yes or no, with an optional reason, about one item of a
+ * run's output, recorded under a judge class.
+ *
+ * - `POST /v1/judgments`: judge an item of a finished run.
+ * - `GET /v1/judgments`: live judgments, filtered by run, agent version,
+ *   flow, verdict, class, participant or project scope.
+ * - `GET /v1/judgments/:id`: one judgment with the stored copies.
+ * - `POST /v1/judgments/:id/unregister`: remove a judgment (soft).
+ *
+ * Authorization: judging needs `write` on the run's project (a run
+ * inherits its permissions from its project). Reading and removing go by
+ * the judgment's project (`read` / `write`), since a judgment outlives
+ * its run.
+ */
+export declare function judgmentsRouter(binding: JudgmentRegistryBinding, runBinding: RunBinding, authorizer?: Authorizer, conversations?: ConversationBinding, flows?: FlowRegistryBinding): Hono<AppEnv>;
+/**
+ * Judge classes: the deployment's named classes of judges ("expert",
+ * "user", …), each with a weight, scoped to the tenant, a project, or an
+ * agent in a project.
+ *
+ * Managing a tenant-scoped class needs `admin` on the tenant; a project-
+ * or agent-scoped class needs `admin` on its project. Listing returns the
+ * classes the caller may read.
+ */
+export declare function judgeClassesRouter(binding: JudgmentRegistryBinding, authorizer?: Authorizer): Hono<AppEnv>;
+/** RFC 6901: the value at `pointer` in `doc`. "" is the whole document. */
+export declare function resolvePointer(doc: unknown, pointer: string): {
+    readonly found: true;
+    readonly value: unknown;
+} | {
+    readonly found: false;
+};
+//# sourceMappingURL=judgments.d.ts.map

package/dist/routes/judgments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judgments.d.ts","sourceRoot":"","sources":["../../src/routes/judgments.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAQL,KAAK,uBAAuB,EAK7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,UAAU,EACvB,aAAa,CAAC,EAAE,mBAAmB,EACnC,KAAK,CAAC,EAAE,mBAAmB,GAC1B,IAAI,CAAC,MAAM,CAAC,CA8Jd;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,UAAU,CAAC,EAAE,UAAU,GACtB,IAAI,CAAC,MAAM,CAAC,CAoJd;AAkTD,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAe/E"}