clinkx 0.3.0 → 1.0.0

package/dist/codex/activity-session-log.js

@@ -0,0 +1,206 @@
+import { logger } from "../logger.js";
+import { createSessionLogJournal, } from "../../clinkx-workflows/dist/dashboard/session-log-journal.js";
+const MAX_PRE_TURN_OBSERVATIONS = 64;
+/**
+ * Create one fail-open observer for one app-server activity session. Journal
+ * creation is deferred until the first real turn id is observed.
+ */
+export function createActivitySessionLogObserver(options) {
+    const pending = [];
+    let owner;
+    let journal;
+    let disabled = false;
+    let observationTimestampMs = 0;
+    const journalFactory = options.journalFactory ?? createSessionLogJournal;
+    const failOpen = (sessionId, observationKind, sequence) => {
+        disabled = true;
+        pending.length = 0;
+        logger.debug({
+            sessionId,
+            observationKind,
+            ...(sequence === undefined ? {} : { sequence }),
+        }, "activity session-log observation failed open");
+    };
+    const bindTurn = async (binding) => {
+        if (disabled || owner !== undefined)
+            return;
+        try {
+            if (binding.sessionId !== options.activityIdentity.activityId) {
+                throw new Error("activity session-log identity mismatch");
+            }
+            owner = {
+                family: "activity",
+                activityId: options.activityIdentity.activityId,
+                activityGeneration: options.activityIdentity.activityGeneration,
+                sessionId: binding.sessionId,
+                threadId: binding.threadId,
+                turnId: binding.turnId,
+            };
+            observationTimestampMs = pending[0]?.atMs ?? 0;
+            journal = await journalFactory({
+                rootDir: options.rootDir,
+                owner,
+                now: () => new Date(observationTimestampMs),
+            });
+            for (const buffered of pending.splice(0)) {
+                if (buffered.sessionId !== owner.sessionId ||
+                    buffered.threadId !== owner.threadId ||
+                    (buffered.turnId !== null && buffered.turnId !== owner.turnId)) {
+                    throw new Error("activity session-log identity mismatch");
+                }
+                await appendObservation(journal, owner, buffered, (atMs) => {
+                    observationTimestampMs = atMs;
+                });
+            }
+        }
+        catch {
+            failOpen(binding.sessionId, "turn_binding");
+        }
+    };
+    const observer = async (observation) => {
+        if (disabled)
+            return;
+        try {
+            if (observation.sessionId !== options.activityIdentity.activityId ||
+                (owner !== undefined && (observation.threadId !== owner.threadId ||
+                    (observation.turnId !== null && observation.turnId !== owner.turnId)))) {
+                throw new Error("activity session-log identity mismatch");
+            }
+            if (observation.turnId === null) {
+                if (pending.length >= MAX_PRE_TURN_OBSERVATIONS) {
+                    throw new Error("activity session-log pre-turn buffer exceeded");
+                }
+                pending.push(observation);
+                return;
+            }
+            if (owner === undefined) {
+                await bindTurn({
+                    sessionId: observation.sessionId,
+                    threadId: observation.threadId,
+                    turnId: observation.turnId,
+                });
+                if (disabled || owner === undefined || journal === undefined)
+                    return;
+            }
+            await appendObservation(journal, owner, observation, (atMs) => {
+                observationTimestampMs = atMs;
+            });
+        }
+        catch {
+            failOpen(observation.sessionId, observation.kind, observation.sequence);
+        }
+    };
+    observer.bindTurn = bindTurn;
+    return observer;
+}
+async function appendObservation(journal, owner, observation, setTimestamp) {
+    const normalized = normalizeObservation(observation);
+    setTimestamp(observation.atMs);
+    const input = {
+        owner,
+        ...normalized,
+    };
+    await journal.append(input);
+}
+function complete(event) {
+    return {
+        event,
+        truncation: "none",
+        completeness: "complete",
+        parseWarnings: [],
+    };
+}
+function normalizeObservation(observation) {
+    switch (observation.kind) {
+        case "user":
+            return complete({ kind: "user", content: observation.content });
+        case "assistant":
+            return complete({ kind: "assistant", content: observation.content });
+        case "tool_call":
+            return complete({
+                kind: "tool_call",
+                toolName: observation.toolName,
+                callId: observation.callId,
+                summary: observation.summary,
+            });
+        case "tool_result":
+            return complete({
+                kind: "tool_result",
+                toolName: observation.toolName,
+                callId: observation.callId,
+                outcome: observation.outcome,
+                summary: observation.summary,
+            });
+        case "approval_request":
+            return complete({
+                kind: "approval_request",
+                approvalId: String(observation.approvalId),
+                action: observation.action,
+                risk: observation.approvalType === "commandExecution" ? "medium" : "high",
+            });
+        case "approval_resolution":
+            return complete({
+                kind: "approval_resolution",
+                approvalId: String(observation.approvalId),
+                decision: observation.decision === "accept" ||
+                    observation.decision === "acceptForSession"
+                    ? "approved"
+                    : observation.decision === "decline"
+                        ? "denied"
+                        : "cancelled",
+            });
+        case "error":
+            return complete({
+                kind: "error",
+                code: observation.code,
+                message: observation.message,
+                retryable: observation.retryable,
+            });
+        case "lifecycle":
+            return complete({ kind: "lifecycle", state: observation.status });
+        case "usage": {
+            const omittedKnownReasoning = observation.incomplete &&
+                observation.inputTokens !== null &&
+                observation.outputTokens !== null &&
+                observation.cachedInputTokens !== null &&
+                observation.reasoningTokens !== null;
+            const reasoningTokens = omittedKnownReasoning
+                ? null
+                : observation.reasoningTokens;
+            const counters = [
+                observation.inputTokens,
+                observation.outputTokens,
+                observation.cachedInputTokens,
+                reasoningTokens,
+            ];
+            const known = counters.filter((counter) => counter !== null).length;
+            const completeness = known === 0
+                ? "unknown"
+                : observation.incomplete ||
+                    observation.inputTokens === null ||
+                    observation.outputTokens === null
+                    ? "partial"
+                    : "complete";
+            return {
+                event: {
+                    kind: "usage",
+                    completeness,
+                    inputTokens: observation.inputTokens,
+                    cachedInputTokens: observation.cachedInputTokens,
+                    outputTokens: observation.outputTokens,
+                    reasoningTokens,
+                },
+                truncation: "none",
+                completeness: completeness === "complete" ? "complete" : "partial",
+                parseWarnings: completeness === "complete"
+                    ? []
+                    : [omittedKnownReasoning
+                            ? "unsupported_field_omitted"
+                            : "provider_payload_omitted"],
+            };
+        }
+        case "reasoning":
+            return complete({ kind: "reasoning", summary: observation.summary });
+    }
+}
+//# sourceMappingURL=activity-session-log.js.map

package/dist/codex/activity-session-log.js.map

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

package/dist/codex/agent-tools.d.ts

@@ -0,0 +1,23 @@
+import { AdapterRegistry } from "../registry.js";
+import type { ActivityJournal } from "../activity-journal.js";
+import { type AppServerRegistry } from "./app-server-registry.js";
+type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export interface AgentToolOptions {
+    signal?: AbortSignal | undefined;
+    registry?: AppServerRegistry | undefined;
+    adapterRegistry?: AdapterRegistry | undefined;
+    activityJournal?: ActivityJournal | undefined;
+    /** Internal producer root; never exposed as a tool input. */
+    sessionLogRootDir?: string | undefined;
+}
+export declare const AGENT_TOOL_NAMES: Set<string>;
+export declare function getAgentToolDefinitions(appServerCliNames?: string[]): Array<Record<string, unknown>>;
+export declare function handleAgentToolCall(name: string, args: unknown, options?: AgentToolOptions): Promise<ToolResult>;
+export declare function resetAgentToolStateForTest(): void;
+export {};