@chengchenccc/oh-my-agent 0.1.1-rc.1

package/dist/core/runtime/prompts.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import basePrompt from "../../prompts/system/base.md" with { type: "text" };
+import memoryPrompt from "../../prompts/system/memory.md" with { type: "text" };
+import safetyPrompt from "../../prompts/system/safety.md" with { type: "text" };
+/** oma's own prompt layer (mirrors omp's src/prompts layout): base
+ *  identity + safety + memory discipline live here as md files; workspace
+ *  files (AGENTS.md / SOUL.md / USER.md + knowledge index) remain the
+ *  agent-specific layer and are appended when present. Explicit
+ *  run-input systemPrompt (Loop scopes) still wins wholesale — callers
+ *  bypass this builder. */
+export function buildSystemPrompt(input) {
+    const now = new Date();
+    const date = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+    const parts = [basePrompt.trim(), safetyPrompt.trim()];
+    const memoryBlock = input.memorySummary?.trim()
+        ? `${memoryPrompt.trim()}\n\n<memory_summary>\n${input.memorySummary.trim()}\n</memory_summary>`
+        : memoryPrompt.trim();
+    parts.push(memoryBlock);
+    if (input.workspacePrompt?.trim()) {
+        parts.push(`<workspace_context>\n${input.workspacePrompt.trim()}\n</workspace_context>`);
+    }
+    parts.push(`Current date: ${date}`, `Current working directory: ${input.cwd}`);
+    return parts.join("\n\n");
+}
+/** Workspace memory summary for prompt injection (absent when the agent
+ *  has never written memories). */
+export function readMemorySummary(cwd) {
+    try {
+        const text = readFileSync(join(cwd, ".oma", "memory", "memory_summary.md"), "utf-8");
+        return text.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/core/runtime/retry.d.ts

@@ -0,0 +1,20 @@
+import type { AIMessageChunk } from "@chengchenccc/message";
+export interface RetryOptions {
+    readonly maxAttempts: number;
+    readonly baseDelayMs: number;
+    /** Lifecycle callbacks so the loop can emit retry_start/retry_end. */
+    readonly onRetryStart?: (attempt: number) => void | Promise<void>;
+    readonly onRetryEnd?: (attempt: number) => void | Promise<void>;
+}
+/** Wrap a model stream with provider-only retry. Only normalized transient
+ *  errors from ProviderError are retried. Tool/business/overflow/auth errors
+ *  pass through immediately. The same input messages are reused (no duplicate
+ *  Meta/Prompt/history in the tree).
+ *
+ *  Streaming is real-time: chunks are forwarded immediately, not buffered.
+ *  Retry is only permitted when the attempt has produced ZERO output (a
+ *  transient connection error before the first token). Once the first chunk
+ *  is emitted the attempt is committed — a later failure makes the Run fail,
+ *  never produces a partial "AAB" contamination. */
+export declare function retryStream(streamFactory: (signal?: AbortSignal) => AsyncIterable<AIMessageChunk>, opts: RetryOptions, signal?: AbortSignal): AsyncIterable<AIMessageChunk>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/runtime/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/retry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;;;;;;;;oDASoD;AACpD,wBAAuB,WAAW,CAChC,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,aAAa,CAAC,cAAc,CAAC,EACtE,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,cAAc,CAAC,CAgD/B"}

package/dist/core/runtime/retry.js

@@ -0,0 +1,60 @@
+import { ProviderError } from "@chengchenccc/ai";
+/** Wrap a model stream with provider-only retry. Only normalized transient
+ *  errors from ProviderError are retried. Tool/business/overflow/auth errors
+ *  pass through immediately. The same input messages are reused (no duplicate
+ *  Meta/Prompt/history in the tree).
+ *
+ *  Streaming is real-time: chunks are forwarded immediately, not buffered.
+ *  Retry is only permitted when the attempt has produced ZERO output (a
+ *  transient connection error before the first token). Once the first chunk
+ *  is emitted the attempt is committed — a later failure makes the Run fail,
+ *  never produces a partial "AAB" contamination. */
+export async function* retryStream(streamFactory, opts, signal) {
+    let attempt = 0;
+    let lastError;
+    while (attempt < opts.maxAttempts) {
+        if (signal?.aborted)
+            throw new Error("Aborted");
+        attempt++;
+        let committed = false; // becomes true on the first forwarded chunk
+        try {
+            for await (const chunk of streamFactory(signal)) {
+                committed = true;
+                yield chunk;
+            }
+        }
+        catch (err) {
+            lastError = err;
+            await opts.onRetryEnd?.(attempt);
+            // Only retry if the attempt produced zero output AND the error is
+            // a retryable transient provider error. A committed attempt that
+            // fails mid-stream cannot be retried (partial output already emitted).
+            const canRetry = !committed && err instanceof ProviderError && err.retryable && attempt < opts.maxAttempts;
+            if (canRetry) {
+                // The retry callback fires only for an actual retry - attempt 1 is
+                // the normal path and must not surface as a retry status.
+                await opts.onRetryStart?.(attempt + 1);
+                // Server-requested delay (Retry-After header) takes precedence over
+                // backoff capped at 60s when the server doesn't suggest a delay.
+                const serverDelay = err.retryAfterMs;
+                const backoff = opts.baseDelayMs * 2 ** (attempt - 1);
+                const cappedBackoff = Math.min(backoff, 60_000);
+                const delay = serverDelay !== undefined ? Math.min(serverDelay, 60_000) : Math.random() * cappedBackoff;
+                const { promise, resolve } = Promise.withResolvers();
+                const timer = setTimeout(resolve, delay);
+                const onAbort = () => resolve();
+                if (signal?.aborted)
+                    resolve();
+                signal?.addEventListener("abort", onAbort, { once: true });
+                await promise;
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onAbort);
+                continue;
+            }
+            throw err;
+        }
+        await opts.onRetryEnd?.(attempt);
+        return;
+    }
+    throw lastError;
+}

package/dist/core/runtime/run-runtime.d.ts

@@ -0,0 +1,93 @@
+import { type AgentRunSnapshot, type ProjectedHistoryItem } from "@chengchenccc/agent-contract";
+import { type ModelRuntime } from "@chengchenccc/ai";
+import type { Message } from "@chengchenccc/message";
+import { type ContextBudget, type ContextSummarizer, type OmaSession, type Plugin, type PluginTool, type SessionStore } from "../agent-runtime.js";
+import type { PluginMcpConfig } from "../plugins/plugin-resolve.js";
+import { type WebFetchPort, type WebSearchPort } from "../tools/index.js";
+import { type ApprovalHandler } from "./approval.js";
+import { type ToolFilter } from "./tool-filter.js";
+/** Dependencies for ONE Run's runtime assembly. The runtime is per-Run: a
+
+/** Dependencies for ONE Run's runtime assembly. The runtime is per-Run: a
+ *  fresh in-memory SessionStore and a fresh OmaSession are created
+ *  for every execute() - no state is shared across Runs except the
+ *  process-level Provider/ModelRuntime. */
+export interface RunRuntimeDeps {
+    workspaceRoot: string;
+    /** Gates tool installation: read_only runs omit write/edit/bash. */
+    workspaceAccess: "read_only" | "read_write";
+    runId: string;
+    modelRuntime: ModelRuntime;
+    /** Canonical `<provider>/<model>` id of the Run's model. The context
+     *  budget and the summarizer bind to THIS model - never the catalog's
+     *  first entry (which may be a different window or a different provider). */
+    modelId: string;
+    /** Skill pack roots (absolute dirs scanned for SKILL.md). Frozen per Run. */
+    skillRoots: readonly string[];
+    webSearch?: WebSearchPort;
+    webFetch?: WebFetchPort;
+    /** Real-time session-file persistence (pi appendMessage): fires after
+     *  every conversational persist with the canonical messages written. */
+    onPersistMessages?: (messages: readonly Message[]) => void;
+    /** Loaded plugin code components (mode layer already applied the trust
+     *  policy); the runtime only mounts them. */
+    codePlugins?: readonly Plugin[];
+    /** Plugin .mcp.json configs (already trust-approved by the mode layer). */
+    pluginMcpServers?: readonly PluginMcpConfig[];
+    /** Frozen Run permissionMode (ADR 0020 decision 7). "deny" drops plugin
+     *  code components at assembly; native tools are unaffected (MVP scope). */
+    permissionMode?: "ask" | "auto" | "deny";
+    /** --tools filter (CLI): applied to the final tool table (native + MCP +
+     *  plugin) at assembly. Undefined = all tools. */
+    toolFilter?: ToolFilter;
+    /** Standalone modes (tui/print/json): the workspace's own .mcp.json is
+     *  repo-controlled, so mount it only when content-trusted (record in
+     *  <agentDir>/trusted-plugins.json; /mcp trust records it). Backend RPC
+     *  leaves this unset — the workspace bridge writes that file and the
+     *  product owns it. */
+    gateWorkspaceMcp?: boolean;
+    /** HITL approval pipeline (spec): resolves the ask-mode gate and
+     *  tools' options.request. Absent + ask = fail-closed error results. */
+    approvalHandler?: ApprovalHandler;
+}
+export interface RunRuntime {
+    readonly runId: string;
+    readonly store: SessionStore;
+    readonly session: OmaSession;
+    readonly summarize: ContextSummarizer;
+    readonly contextBudget: ContextBudget | undefined;
+    /** Set before startLoop so modelStream resolves the run's model. */
+    setActiveRun(run: AgentRunSnapshot<"oma"> | null): void;
+    /** Workflow mode: execute a vm-sandboxed script (agent() subagents) and
+     *  return its value. Used directly by create-runtime when the Run input
+     *  carries `workflow`, and by the workflow_run tool otherwise. */
+    executeWorkflow(input: {
+        script: string;
+        args?: unknown;
+    }): Promise<{
+        ok: boolean;
+        totalTokens: number;
+        value: unknown;
+    }>;
+    /** Subagent usage accumulated across workflow_agent_completed events
+     *  (T5/B6: the run's outcome merges it so fan-out spend reaches the
+     *  product ledger, not just the advisory gate). */
+    workflowUsage(): {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+    };
+    /** Close MCP clients etc. Call after the run settles. */
+    close(): Promise<void>;
+}
+/** Single provider assembly shared by the CLI catalog (--list-models) and
+ *  Run loops: register built-in providers from the process env. The fake
+ *  deterministic provider is available for tests. */
+export declare function registerBuiltinProviders(runtime: ModelRuntime, env?: Readonly<Record<string, string | undefined>>): void;
+/** Build the complete Runtime assembly for exactly ONE Run. The Run's
+ *  in-memory SessionStore is created here (never shared with other Runs);
+ *  the model is resolved per run from the AgentRunSnapshot. */
+export declare function assembleRunRuntime(deps: RunRuntimeDeps): Promise<RunRuntime>;
+export type { AgentRunSnapshot, PluginTool, ProjectedHistoryItem };
+//# sourceMappingURL=run-runtime.d.ts.map

package/dist/core/runtime/run-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-runtime.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/run-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAA8B,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAItB,KAAK,UAAU,EACf,KAAK,MAAM,EAEX,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,OAAO,EAcL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,KAAK,eAAe,EAA2C,MAAM,eAAe,CAAC;AAI9F,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAoErE;;;;;2CAK2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,eAAe,EAAE,WAAW,GAAG,YAAY,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B;;iFAE6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;4EACwE;IACxE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;IAC3D;iDAC6C;IAC7C,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C;gFAC4E;IAC5E,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC;sDACkD;IAClD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;2BAIuB;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;4EACwE;IACxE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,oEAAoE;IACpE,YAAY,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD;;sEAEkE;IAClE,eAAe,CAAC,KAAK,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE;;uDAEmD;IACnD,aAAa,IAAI;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,yDAAyD;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;qDAEqD;AACrD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,IAAI,CAON;AAED;;+DAE+D;AAC/D,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAkoBlF;AAED,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}