@ai0x0/codex-ts 0.1.0 → 0.2.1

package/dist/core/src/session/turn.d.ts

@@ -12,6 +12,7 @@
 import type { EventMsg } from "../../../protocol/src/protocol.js";
 import type { UserInput } from "../../../protocol/src/user_input.js";
 import { ToolRouter } from "../tools/router.js";
+import type { SkillMetadata } from "../skills.js";
 import type { PendingInputs } from "../tools/handlers/request_user_input.js";
 import type { LiveThread } from "../../../thread-store/src/live_thread.js";
 import type { ConversationItem } from "../../../thread-store/src/types.js";
@@ -21,13 +22,40 @@ export interface TurnConfig {
     baseUrl: string;
     model: string;
     instructions?: string | undefined;
+    /** Discovered skills, for `$skill-name` full-body injection (Layer 2). */
+    skills?: SkillMetadata[] | undefined;
+    /**
+     * Reads a skill's full SKILL.md on demand. Host-provided because a browser
+     * has no filesystem (mirrors how IoBackend is injected).
+     */
+    loadSkillContent?: ((skill: SkillMetadata) => Promise<string>) | undefined;
+    /**
+     * Input-token threshold that triggers inline auto-compaction.
+     * mirrors model_auto_compact_token_limit in codex-rs TurnContext config.
+     *
+     * In BodyAfterPrefix mode (the default) this is compared against tokens
+     * added since the last compaction, not total context size.
+     * Typical value: context_window × 0.9.
+     * Omit to disable auto-compaction.
+     */
+    autoCompactTokenLimit?: number | undefined;
+    /**
+     * Turn-scoped context messages prepended to `input` ahead of history,
+     * mirroring codex-rs's contextual user fragments: user_instructions
+     * (developer + AGENTS.md) and the skills catalog ride here as discrete
+     * messages rather than baked into the `instructions` field. Not persisted.
+     */
+    contextItems?: HistoryItem[] | undefined;
 }
 export interface TurnResult {
     lastAgentMessage: string;
     /** All events emitted during the turn (including streaming deltas) */
     events: EventMsg[];
 }
-export declare function runTurn(turnId: string, userItems: UserInput[], history: HistoryItem[], config: TurnConfig, router: ToolRouter, pendingInputs: PendingInputs, emitEvent: (msg: EventMsg) => void, liveThread?: LiveThread | undefined): Promise<{
+export declare function runTurn(turnId: string, userItems: UserInput[], history: HistoryItem[], config: TurnConfig, router: ToolRouter, pendingInputs: PendingInputs, emitEvent: (msg: EventMsg) => void, liveThread?: LiveThread | undefined, 
+/** mirrors: codex-rs propagates a tokio CancellationToken into the turn loop;
+ *  AbortSignal is the browser-native equivalent. */
+abortSignal?: AbortSignal | undefined): Promise<{
     lastAgentMessage: string;
 }>;
 export {};

package/dist/core/src/session/turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../core/src/session/turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,KAAK,WAAW,GAAG,gBAAgB,CAAC;AA4CpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAID,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAClC,OAAO,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CA0IvC"}
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../core/src/session/turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAO3E,KAAK,WAAW,GAAG,gBAAgB,CAAC;AAIpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3E;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;CAC1C;AAID,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS;AACnC;oDACoD;AACpD,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,GACpC,OAAO,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CA8NvC"}

package/dist/core/src/session/turn.js

@@ -10,60 +10,75 @@
  *   6. Loop until the model produces no more tool calls
  */
 import { toolSpecToRequestJson } from "../../../tools/src/tool_spec.js";
-// ─── SSE stream parser ────────────────────────────────────────────────────────
-async function* parseSseStream(body) {
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-        for (;;) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            buffer = lines.pop() ?? "";
-            let dataLine = "";
-            for (const line of lines) {
-                if (line.startsWith("data: ")) {
-                    dataLine = line.slice(6).trim();
-                }
-                else if (line === "" && dataLine) {
-                    if (dataLine !== "[DONE]") {
-                        try {
-                            yield JSON.parse(dataLine);
-                        }
-                        catch {
-                            /* malformed JSON — skip */
-                        }
-                    }
-                    dataLine = "";
-                }
-            }
-        }
-    }
-    finally {
-        reader.releaseLock();
-    }
-}
-export async function runTurn(turnId, userItems, history, config, router, pendingInputs, emitEvent, liveThread) {
+import { extractSkillMentions, renderSkillInjection } from "../skills.js";
+import { parseSseStream } from "./sse.js";
+import { runInlineAutoCompactTask } from "../compact.js";
+import { AutoCompactWindow } from "../state/auto_compact_window.js";
+export async function runTurn(turnId, userItems, history, config, router, pendingInputs, emitEvent, liveThread, 
+/** mirrors: codex-rs propagates a tokio CancellationToken into the turn loop;
+ *  AbortSignal is the browser-native equivalent. */
+abortSignal) {
     // Add user message to history (mutates the shared array)
     const userContent = userItems
         .map((item) => item.type === "text"
         ? { type: "input_text", text: item.text }
         : null)
         .filter((x) => x !== null);
-    const userMsg = { role: "user", content: userContent };
+    const userMsg = {
+        type: "message",
+        role: "user",
+        content: userContent,
+    };
     history.push(userMsg);
     await liveThread?.appendConversationItems([userMsg]);
+    // ── Layer 2: turn-scoped skill full-body injection (mirrors codex-rs) ──────
+    // A `$skill-name` mention in user input pulls that skill's full SKILL.md into
+    // THIS turn's request input only. Like codex-rs contextual fragments, these
+    // items are NOT pushed to history / persisted — resume stays clean and the
+    // body isn't duplicated every turn.
+    const skillInjectionItems = [];
+    const loadSkillContent = config.loadSkillContent;
+    if (config.skills && config.skills.length > 0 && loadSkillContent) {
+        const userText = userItems
+            .map((item) => (item.type === "text" ? item.text : ""))
+            .join("\n");
+        const mentioned = extractSkillMentions(userText, config.skills);
+        for (const skill of mentioned) {
+            const contents = await loadSkillContent(skill).catch(() => null);
+            if (contents !== null) {
+                skillInjectionItems.push({
+                    type: "message",
+                    role: "user",
+                    content: [
+                        { type: "input_text", text: renderSkillInjection(skill, contents) },
+                    ],
+                });
+            }
+        }
+    }
     const tools = router.toolSpecs().map(toolSpecToRequestJson);
     let lastAgentMessage = "";
     let itemIdCounter = 0;
+    // ── Auto-compaction window tracker (mirrors AutoCompactWindow in codex-rs) ──
+    // Uses BodyAfterPrefix mode: only tokens added after the last compaction count
+    // toward the limit. mirrors AutoCompactTokenLimitScope::BodyAfterPrefix.
+    const compactWindow = new AutoCompactWindow();
     for (;;) {
+        // Bail out before sampling again if the turn was interrupted.
+        if (abortSignal?.aborted) {
+            throw new DOMException("Turn interrupted", "AbortError");
+        }
         // ── Sample from the model ───────────────────────────────────────────────
         const body = {
             model: config.model,
-            input: history,
+            // codex-rs structure: turn-scoped context (user_instructions + skills
+            // catalog) and any $mention skill bodies ride at the front, ahead of the
+            // persisted conversation history. None of these are persisted.
+            input: [
+                ...(config.contextItems ?? []),
+                ...skillInjectionItems,
+                ...history,
+            ],
             tools,
             stream: true,
         };
@@ -76,6 +91,7 @@ export async function runTurn(turnId, userItems, history, config, router, pendin
                 Authorization: `Bearer ${config.apiKey}`,
             },
             body: JSON.stringify(body),
+            signal: abortSignal ?? null,
         });
         if (!res.ok || !res.body) {
             const text = res.body ? await res.text() : "(no body)";
@@ -86,6 +102,7 @@ export async function runTurn(turnId, userItems, history, config, router, pendin
         const partialArgs = new Map();
         let assistantText = "";
         let currentItemId = `item-${++itemIdCounter}`;
+        let inputTokensThisRound = 0;
         for await (const raw of parseSseStream(res.body)) {
             switch (raw["type"]) {
                 case "response.output_item.added": {
@@ -125,12 +142,26 @@ export async function runTurn(turnId, userItems, history, config, router, pendin
                     }
                     break;
                 }
+                case "response.done": {
+                    // mirrors ensure_server_observed_prefill_from_usage in auto_compact_window.rs
+                    const resp = raw["response"];
+                    const usage = resp?.["usage"];
+                    if (typeof usage?.["input_tokens"] === "number") {
+                        inputTokensThisRound = usage["input_tokens"];
+                        compactWindow.ensureServerObservedPrefill(inputTokensThisRound);
+                    }
+                    break;
+                }
             }
         }
         // ── Persist assistant message ────────────────────────────────────────────
         if (assistantText) {
             lastAgentMessage = assistantText;
-            const assistantItem = { role: "assistant", content: assistantText };
+            const assistantItem = {
+                type: "message",
+                role: "assistant",
+                content: assistantText,
+            };
             history.push(assistantItem);
             await liveThread?.appendConversationItems([assistantItem]);
             emitEvent({ type: "AgentMessage", event: { message: assistantText } });
@@ -150,6 +181,25 @@ export async function runTurn(turnId, userItems, history, config, router, pendin
         // ── Done when no tool calls ─────────────────────────────────────────────
         if (functionCalls.length === 0)
             break;
+        // ── Auto-compaction check (mirrors post-sampling compact in turn.rs) ─────
+        // Only triggered mid-turn (when there are more tool calls to dispatch),
+        // matching InitialContextInjection::BeforeLastUserMessage behaviour.
+        if (config.autoCompactTokenLimit !== undefined && inputTokensThisRound > 0) {
+            const scopeTokens = compactWindow.bodyAfterPrefix(inputTokensThisRound);
+            const limitReached = scopeTokens >= config.autoCompactTokenLimit;
+            if (limitReached) {
+                emitEvent({ type: "ContextCompacted", event: {} });
+                await runInlineAutoCompactTask(history, config);
+                compactWindow.startNext();
+                emitEvent({
+                    type: "Warning",
+                    event: {
+                        message: "Heads up: Long threads and multiple compactions can cause the model to be less accurate. " +
+                            "Start a new thread when possible to keep threads small and targeted.",
+                    },
+                });
+            }
+        }
         // ── Dispatch tool calls ─────────────────────────────────────────────────
         for (const call of functionCalls) {
             let args;

package/dist/core/src/session/turn.js.map

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

package/dist/core/src/skills.d.ts

@@ -0,0 +1,66 @@
+/**
+ * mirrors codex-rs/core-skills/src/render.rs + injection.rs + skill_instructions.rs
+ *
+ * Two-layer skill injection — the layer codex-ts originally dropped, so the
+ * model had to grope around with list_dir/read_file every turn:
+ *   - Layer 1 (catalog): renderSkillsCatalog() builds the always-on `## Skills`
+ *     index, budget-trimmed so it never blows the context window.
+ *   - Layer 2 (full body): extractSkillMentions() finds `$skill-name` mentions in
+ *     the user's input so the host can inject the full SKILL.md on demand, and
+ *     renderSkillInjection() wraps it in the codex-rs `<skill>` envelope.
+ *
+ * Discovery (scanning `.agents/skills` + parsing SKILL.md frontmatter) is the
+ * HOST's job — a browser has no filesystem — so the host passes already-found
+ * SkillMetadata[] plus a loadSkillContent() reader. This mirrors how codex-ts
+ * already injects IoBackend/ThreadStore from the environment. The codex-rs
+ * skill-roots/alias variant is omitted: a single `.agents/skills` root means
+ * plain absolute/relative paths, never aliases.
+ */
+export interface SkillMetadata {
+    /** Skill name from SKILL.md frontmatter (e.g. "song-analyzer"). */
+    name: string;
+    /** One-line description: what it does + when to use it. */
+    description: string;
+    /** Path to the SKILL.md, shown in the catalog and read on demand. */
+    path: string;
+}
+/**
+ * Context budget for the skills catalog. Tokens are approximated as bytes/4
+ * (codex-rs APPROX_BYTES_PER_TOKEN); characters count Unicode code points.
+ */
+export type SkillMetadataBudget = {
+    kind: "tokens";
+    limit: number;
+} | {
+    kind: "characters";
+    limit: number;
+};
+/**
+ * Default budget: 2% of the model's context window in tokens when known,
+ * otherwise a flat 8000-character cap. Mirrors render.rs default_skill_metadata_budget.
+ */
+export declare function defaultSkillMetadataBudget(contextWindow?: number): SkillMetadataBudget;
+/**
+ * Render the always-on skills catalog (Layer 1), trimmed to fit `budget`.
+ * Mirrors render.rs render_available_skills_body (absolute-paths variant)
+ * including the omission / truncation warning appended when the budget is tight.
+ * Returns "" when there are no skills so callers can skip injection entirely.
+ */
+export declare function renderSkillsCatalog(skills: SkillMetadata[], budget?: SkillMetadataBudget): string;
+/**
+ * Extract `$skill-name` mentions from text (Layer 2).
+ * Mirrors injection.rs extract_tool_mentions + select_skills_from_mentions:
+ * a plain `$name` only resolves when exactly one skill carries that name.
+ * Results preserve `skills` order and are de-duplicated.
+ *
+ * The codex-rs `[$name](path)` linked form and structured `UserInput::Skill`
+ * selection are intentionally not mirrored — ace-mv mentions skills by plain
+ * name only.
+ */
+export declare function extractSkillMentions(text: string, skills: SkillMetadata[]): SkillMetadata[];
+/**
+ * Wrap a skill's full SKILL.md body for injection as a turn-scoped user message.
+ * Mirrors skill_instructions.rs SkillInstructions::body + the `<skill>` markers.
+ */
+export declare function renderSkillInjection(skill: SkillMetadata, contents: string): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/src/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../core/src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAmC1C;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,CAAC,EAAE,MAAM,GACrB,mBAAmB,CASrB;AAsOD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,GAAE,mBAAkD,GACzD,MAAM,CAyBR;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EAAE,GACtB,aAAa,EAAE,CAuBjB;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER"}

package/dist/core/src/skills.js

@@ -0,0 +1,304 @@
+/**
+ * mirrors codex-rs/core-skills/src/render.rs + injection.rs + skill_instructions.rs
+ *
+ * Two-layer skill injection — the layer codex-ts originally dropped, so the
+ * model had to grope around with list_dir/read_file every turn:
+ *   - Layer 1 (catalog): renderSkillsCatalog() builds the always-on `## Skills`
+ *     index, budget-trimmed so it never blows the context window.
+ *   - Layer 2 (full body): extractSkillMentions() finds `$skill-name` mentions in
+ *     the user's input so the host can inject the full SKILL.md on demand, and
+ *     renderSkillInjection() wraps it in the codex-rs `<skill>` envelope.
+ *
+ * Discovery (scanning `.agents/skills` + parsing SKILL.md frontmatter) is the
+ * HOST's job — a browser has no filesystem — so the host passes already-found
+ * SkillMetadata[] plus a loadSkillContent() reader. This mirrors how codex-ts
+ * already injects IoBackend/ThreadStore from the environment. The codex-rs
+ * skill-roots/alias variant is omitted: a single `.agents/skills` root means
+ * plain absolute/relative paths, never aliases.
+ */
+const DEFAULT_SKILL_METADATA_CHAR_BUDGET = 8_000;
+const SKILL_METADATA_CONTEXT_WINDOW_PERCENT = 2;
+const APPROX_BYTES_PER_TOKEN = 4;
+const TEXT_ENCODER = new TextEncoder();
+function byteLength(text) {
+    return TEXT_ENCODER.encode(text).length;
+}
+function approxTokensFromBytes(bytes) {
+    return Math.floor((bytes + APPROX_BYTES_PER_TOKEN - 1) / APPROX_BYTES_PER_TOKEN);
+}
+function budgetCost(budget, text) {
+    return budget.kind === "tokens"
+        ? approxTokensFromBytes(byteLength(text))
+        : Array.from(text).length;
+}
+function budgetCostFromCounts(budget, chars, bytes) {
+    return budget.kind === "tokens" ? approxTokensFromBytes(bytes) : chars;
+}
+// Each rendered line is followed by a newline in the catalog body.
+function lineCost(budget, line) {
+    return budgetCost(budget, `${line}\n`);
+}
+/**
+ * Default budget: 2% of the model's context window in tokens when known,
+ * otherwise a flat 8000-character cap. Mirrors render.rs default_skill_metadata_budget.
+ */
+export function defaultSkillMetadataBudget(contextWindow) {
+    if (contextWindow && contextWindow > 0) {
+        const limit = Math.max(1, Math.floor((contextWindow * SKILL_METADATA_CONTEXT_WINDOW_PERCENT) / 100));
+        return { kind: "tokens", limit };
+    }
+    return { kind: "characters", limit: DEFAULT_SKILL_METADATA_CHAR_BUDGET };
+}
+// ─── Layer 1: line rendering (mirrors render.rs SkillLine) ────────────────────
+function normalizedPath(skill) {
+    return skill.path.replace(/\\/g, "/");
+}
+// render.rs SkillLine::render_full
+function renderSkillLineFull(skill) {
+    return renderSkillLineWithDescriptionChars(skill, Array.from(skill.description).length);
+}
+// render.rs SkillLine::render_with_description_chars
+function renderSkillLineWithDescriptionChars(skill, descriptionChars) {
+    const path = normalizedPath(skill);
+    if (descriptionChars === 0) {
+        return `- ${skill.name}: (file: ${path})`;
+    }
+    const description = Array.from(skill.description)
+        .slice(0, descriptionChars)
+        .join("");
+    return `- ${skill.name}: ${description} (file: ${path})`;
+}
+function descriptionBudgetLine(skill, budget) {
+    const minimumLine = renderSkillLineWithDescriptionChars(skill, /*descriptionChars*/ 0);
+    const minimumChars = Array.from(minimumLine).length + 1; // +1 for "\n"
+    const minimumBytes = byteLength(minimumLine) + 1;
+    const minimumCost = budgetCostFromCounts(budget, minimumChars, minimumBytes);
+    const descriptionCodePoints = Array.from(skill.description);
+    const extraCosts = [0];
+    let prefixChars = 0;
+    let prefixBytes = 0;
+    for (const ch of descriptionCodePoints) {
+        prefixChars += 1;
+        prefixBytes += byteLength(ch);
+        // A k-char description adds the chars plus one separating space.
+        const renderedChars = minimumChars + prefixChars + 1;
+        const renderedBytes = minimumBytes + prefixBytes + 1;
+        const cost = budgetCostFromCounts(budget, renderedChars, renderedBytes) - minimumCost;
+        extraCosts.push(Math.max(0, cost));
+    }
+    return { skill, descriptionCharCount: descriptionCodePoints.length, extraCosts };
+}
+// render.rs render_lines_with_description_budget — hand out description space one
+// char at a time across all skills so a short description's slack flows to longer
+// ones instead of being stranded in a fixed per-skill quota.
+function renderLinesWithDescriptionBudget(skills, budget, limit) {
+    const budgetLines = skills.map((skill) => descriptionBudgetLine(skill, budget));
+    const charAllocations = budgetLines.map(() => 0);
+    const currentExtraCosts = budgetLines.map(() => 0);
+    let remaining = limit;
+    for (;;) {
+        let changed = false;
+        budgetLines.forEach((line, index) => {
+            if (charAllocations[index] >= line.descriptionCharCount) {
+                return;
+            }
+            const nextChars = charAllocations[index] + 1;
+            const nextCost = line.extraCosts[nextChars];
+            const delta = nextCost - currentExtraCosts[index];
+            if (delta <= remaining) {
+                charAllocations[index] = nextChars;
+                currentExtraCosts[index] = nextCost;
+                remaining -= delta;
+                changed = true;
+            }
+        });
+        if (!changed) {
+            break;
+        }
+    }
+    return budgetLines.map((line, index) => renderSkillLineWithDescriptionChars(line.skill, charAllocations[index]));
+}
+// render.rs render_minimum_skill_lines_until_budget — when even the no-description
+// lines overflow, keep adding minimum lines until the budget is spent; the rest
+// are omitted.
+function renderMinimumUntilBudget(skills, budget) {
+    const lines = [];
+    let used = 0;
+    let omitted = 0;
+    for (const skill of skills) {
+        const minimumLine = renderSkillLineWithDescriptionChars(skill, /*descriptionChars*/ 0);
+        const cost = lineCost(budget, minimumLine);
+        if (used + cost <= budget.limit) {
+            used += cost;
+            lines.push(minimumLine);
+        }
+        else {
+            omitted += 1;
+        }
+    }
+    return { lines, omitted };
+}
+// render.rs render_skill_lines_from_lines — three tiers: full → trimmed
+// descriptions → minimum-until-budget.
+function renderSkillLines(skills, budget) {
+    const fullCost = skills.reduce((used, skill) => used + lineCost(budget, renderSkillLineFull(skill)), 0);
+    if (fullCost <= budget.limit) {
+        return { lines: skills.map(renderSkillLineFull), omitted: 0 };
+    }
+    const minimumCost = skills.reduce((used, skill) => used + lineCost(budget, renderSkillLineWithDescriptionChars(skill, /*descriptionChars*/ 0)), 0);
+    if (minimumCost <= budget.limit) {
+        return {
+            lines: renderLinesWithDescriptionBudget(skills, budget, budget.limit - minimumCost),
+            omitted: 0,
+        };
+    }
+    return renderMinimumUntilBudget(skills, budget);
+}
+// ─── Layer 1: catalog (mirrors render.rs render_available_skills_body) ────────
+// render.rs SKILLS_INTRO_WITH_ABSOLUTE_PATHS (verbatim)
+const SKILLS_INTRO = "A skill is a set of local instructions to follow that is stored in a `SKILL.md` file. Below is the list of skills that can be used. Each entry includes a name, description, and file path so you can open the source for full instructions when using a specific skill.";
+// render.rs SKILLS_HOW_TO_USE_WITH_ABSOLUTE_PATHS (verbatim)
+const SKILLS_HOW_TO_USE = `- Discovery: The list above is the skills available in this session (name + description + file path). Skill bodies live on disk at the listed paths.
+- Trigger rules: If the user names a skill (with \`$SkillName\` or plain text) OR the task clearly matches a skill's description shown above, you must use that skill for that turn. Multiple mentions mean use them all. Do not carry skills across turns unless re-mentioned.
+- Missing/blocked: If a named skill isn't in the list or the path can't be read, say so briefly and continue with the best fallback.
+- How to use a skill (progressive disclosure):
+  1) After deciding to use a skill, open its \`SKILL.md\`. Read only enough to follow the workflow.
+  2) When \`SKILL.md\` references relative paths (e.g., \`scripts/foo.py\`), resolve them relative to the skill directory listed above first, and only consider other paths if needed.
+  3) If \`SKILL.md\` points to extra folders such as \`references/\`, load only the specific files needed for the request; don't bulk-load everything.
+  4) If \`scripts/\` exist, prefer running or patching them instead of retyping large code blocks.
+  5) If \`assets/\` or templates exist, reuse them instead of recreating from scratch.
+- Coordination and sequencing:
+  - If multiple skills apply, choose the minimal set that covers the request and state the order you'll use them.
+  - Announce which skill(s) you're using and why (one short line). If you skip an obvious skill, say why.
+- Context hygiene:
+  - Keep context small: summarize long sections instead of pasting them; only load extra files when needed.
+  - Avoid deep reference-chasing: prefer opening only files directly linked from \`SKILL.md\` unless you're blocked.
+  - When variants exist (frameworks, providers, domains), pick only the relevant reference file(s) and note that choice.
+- Safety and fallback: If a skill can't be applied cleanly (missing files, unclear instructions), state the issue, pick the next-best approach, and continue.`;
+// render.rs warning constants (verbatim)
+const SKILL_DESCRIPTIONS_REMOVED_WARNING_PREFIX = "Exceeded skills context budget. All skill descriptions were removed and";
+const SKILL_DESCRIPTION_TRUNCATED_WARNING = "Skill descriptions were shortened to fit the skills context budget. " +
+    "Codex can still see every skill, but some descriptions are shorter. " +
+    "Disable unused skills or plugins to leave more room for the rest.";
+const SKILL_DESCRIPTION_TRUNCATED_WARNING_WITH_PERCENT = "Skill descriptions were shortened to fit the 2% skills context budget. " +
+    "Codex can still see every skill, but some descriptions are shorter. " +
+    "Disable unused skills or plugins to leave more room for the rest.";
+/**
+ * Build the omission / truncation warning appended to the catalog.
+ * mirrors render.rs build_available_skills_from_lines warning_message logic.
+ */
+function buildCatalogWarning(omitted, truncated, budget) {
+    if (omitted > 0) {
+        const skillWord = omitted === 1 ? "skill" : "skills";
+        const verb = omitted === 1 ? "was" : "were";
+        const prefix = budget.kind === "tokens"
+            ? SKILL_DESCRIPTIONS_REMOVED_WARNING_PREFIX.replace("skills context budget", "2% skills context budget")
+            : SKILL_DESCRIPTIONS_REMOVED_WARNING_PREFIX;
+        return `${prefix} ${omitted} additional ${skillWord} ${verb} not included in the model-visible skills list.`;
+    }
+    if (truncated) {
+        return budget.kind === "tokens"
+            ? SKILL_DESCRIPTION_TRUNCATED_WARNING_WITH_PERCENT
+            : SKILL_DESCRIPTION_TRUNCATED_WARNING;
+    }
+    return null;
+}
+/**
+ * Render the always-on skills catalog (Layer 1), trimmed to fit `budget`.
+ * Mirrors render.rs render_available_skills_body (absolute-paths variant)
+ * including the omission / truncation warning appended when the budget is tight.
+ * Returns "" when there are no skills so callers can skip injection entirely.
+ */
+export function renderSkillsCatalog(skills, budget = defaultSkillMetadataBudget()) {
+    if (skills.length === 0) {
+        return "";
+    }
+    const { lines, omitted } = renderSkillLines(skills, budget);
+    // Detect whether any description was truncated by comparing rendered lengths
+    // to full descriptions (cheap proxy — good enough for the warning threshold).
+    const anyTruncated = skills.some((skill, i) => {
+        const rendered = lines[i] ?? "";
+        return skill.description.length > 0 && !rendered.includes(skill.description);
+    });
+    const warning = buildCatalogWarning(omitted, anyTruncated, budget);
+    const out = [
+        "## Skills",
+        SKILLS_INTRO,
+        "### Available skills",
+        ...lines,
+        ...(warning ? [warning] : []),
+        "### How to use skills",
+        SKILLS_HOW_TO_USE,
+    ];
+    return `\n${out.join("\n")}\n`;
+}
+// ─── Layer 2: mention detection (mirrors injection.rs) ────────────────────────
+// injection.rs is_common_env_var — skip `$HOME` etc. so env vars in prose don't
+// masquerade as skill mentions.
+const COMMON_ENV_VARS = new Set([
+    "HOME",
+    "PATH",
+    "PWD",
+    "USER",
+    "SHELL",
+    "LANG",
+    "TERM",
+    "TMPDIR",
+    "EDITOR",
+    "HOSTNAME",
+    "LOGNAME",
+    "OLDPWD",
+]);
+/**
+ * Extract `$skill-name` mentions from text (Layer 2).
+ * Mirrors injection.rs extract_tool_mentions + select_skills_from_mentions:
+ * a plain `$name` only resolves when exactly one skill carries that name.
+ * Results preserve `skills` order and are de-duplicated.
+ *
+ * The codex-rs `[$name](path)` linked form and structured `UserInput::Skill`
+ * selection are intentionally not mirrored — ace-mv mentions skills by plain
+ * name only.
+ */
+export function extractSkillMentions(text, skills) {
+    const mentioned = collectMentionNames(text);
+    if (mentioned.size === 0) {
+        return [];
+    }
+    const nameCounts = new Map();
+    for (const skill of skills) {
+        nameCounts.set(skill.name, (nameCounts.get(skill.name) ?? 0) + 1);
+    }
+    const selected = [];
+    const seen = new Set();
+    for (const skill of skills) {
+        if (seen.has(skill.name)) {
+            continue;
+        }
+        if (mentioned.has(skill.name) && nameCounts.get(skill.name) === 1) {
+            selected.push(skill);
+            seen.add(skill.name);
+        }
+    }
+    return selected;
+}
+// injection.rs extract_tool_mentions_with_sigil — `$` followed by one or more
+// mention-name chars (ASCII alnum plus '-' '_').
+function collectMentionNames(text) {
+    const names = new Set();
+    for (const match of text.matchAll(/\$([a-zA-Z0-9_-]+)/g)) {
+        const name = match[1];
+        if (name && !COMMON_ENV_VARS.has(name)) {
+            names.add(name);
+        }
+    }
+    return names;
+}
+// ─── Layer 2: full-body envelope (mirrors skill_instructions.rs) ──────────────
+/**
+ * Wrap a skill's full SKILL.md body for injection as a turn-scoped user message.
+ * Mirrors skill_instructions.rs SkillInstructions::body + the `<skill>` markers.
+ */
+export function renderSkillInjection(skill, contents) {
+    return `<skill>\n<name>${skill.name}</name>\n<path>${skill.path}</path>\n${contents}\n</skill>`;
+}
+//# sourceMappingURL=skills.js.map