octoflow-core 1.0.0

package/dist/capabilities/agent-context/section-cap.js

@@ -0,0 +1,111 @@
+const DEFAULT_PROTECTED_KEYS = /* @__PURE__ */ new Set([
+  "identity",
+  "identity-role",
+  "instructions",
+  "tools",
+  "tool-delivery"
+]);
+const DEFAULT_PROTECTED_SOURCES = [
+  "guardrail"
+];
+const TRIM_MARKER_OVERHEAD = 60;
+function defaultEstimator(text) {
+  return Math.ceil(text.length / 4);
+}
+function isProtected(section, keys, sources) {
+  if (keys.has(section.key)) return true;
+  if (section.source && sources.has(section.source)) return true;
+  return false;
+}
+function applySectionCap(sections, cap) {
+  if (!cap.maxTokens || cap.maxTokens <= 0) {
+    return { sections, overflow: void 0 };
+  }
+  const estimator = cap.estimator ?? defaultEstimator;
+  const protectedKeys = /* @__PURE__ */ new Set([
+    ...DEFAULT_PROTECTED_KEYS,
+    ...cap.protectedKeys ?? []
+  ]);
+  const protectedSources = /* @__PURE__ */ new Set([
+    ...DEFAULT_PROTECTED_SOURCES,
+    ...cap.protectedSources ?? []
+  ]);
+  const tokensFor = (s) => estimator(s.content);
+  const originalTokens = sections.reduce((sum, s) => sum + tokensFor(s), 0);
+  if (originalTokens <= cap.maxTokens) return { sections, overflow: void 0 };
+  const protectedSections = [];
+  const trimmable = [];
+  for (const s of sections) {
+    if (isProtected(s, protectedKeys, protectedSources)) {
+      protectedSections.push(s);
+    } else {
+      trimmable.push(s);
+    }
+  }
+  const protectedTokens = protectedSections.reduce(
+    (sum, s) => sum + tokensFor(s),
+    0
+  );
+  const trimmableBudget = Math.max(0, cap.maxTokens - protectedTokens);
+  const byImportance = [...trimmable].sort((a, b) => a.priority - b.priority);
+  const allotments = /* @__PURE__ */ new Map();
+  let remaining = trimmableBudget;
+  for (const s of byImportance) {
+    const need = tokensFor(s);
+    if (remaining <= 0) {
+      allotments.set(s.key, 0);
+      continue;
+    }
+    if (need <= remaining) {
+      allotments.set(s.key, need);
+      remaining -= need;
+    } else {
+      allotments.set(s.key, remaining);
+      remaining = 0;
+    }
+  }
+  const trimmedReports = [];
+  const replaced = /* @__PURE__ */ new Map();
+  for (const s of trimmable) {
+    const allotted = allotments.get(s.key) ?? 0;
+    const before = tokensFor(s);
+    if (allotted >= before) continue;
+    const next = trimContent(s, allotted, before);
+    replaced.set(s.key, next);
+    trimmedReports.push({ key: s.key, before, after: tokensFor(next) });
+  }
+  const finalSections = sections.map((s) => replaced.get(s.key) ?? s);
+  const finalTokens = finalSections.reduce((sum, s) => sum + tokensFor(s), 0);
+  const overflow = {
+    cap: cap.maxTokens,
+    originalTokens,
+    finalTokens,
+    trimmed: trimmedReports
+  };
+  cap.onOverflow?.(overflow);
+  return { sections: finalSections, overflow };
+}
+function trimContent(section, allotted, before) {
+  const droppedTokens = before - allotted;
+  if (allotted <= 0) {
+    return {
+      ...section,
+      content: `[\u2026trimmed ${droppedTokens} tokens to fit context budget\u2026]`
+    };
+  }
+  const ratio = allotted / Math.max(1, before);
+  const targetChars = Math.max(
+    0,
+    Math.floor(section.content.length * ratio) - TRIM_MARKER_OVERHEAD
+  );
+  return {
+    ...section,
+    content: section.content.slice(0, targetChars) + `
+
+[\u2026trimmed ${droppedTokens} tokens to fit context budget\u2026]`
+  };
+}
+export {
+  applySectionCap
+};
+//# sourceMappingURL=section-cap.js.map

package/dist/capabilities/agent-context/section-cap.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/agent-context/section-cap.ts"],
+  "sourcesContent": ["import type {\n  AgentContextSection,\n  AgentContextSectionSource,\n  SectionCapOptions,\n  SectionOverflowInfo,\n} from './types.js';\n\n/**\n * Keys that are NEVER trimmed by the section cap. These carry the agent's\n * identity, behavioral instructions, hard guardrails, and the tool catalog\n * required for prompt-injection function calling \u2014 trimming any of them\n * would silently break agent behavior.\n *\n * Section content with `source === 'guardrail'` is also protected regardless\n * of key (covers the dynamically-built \"Guardrails\" section as well as any\n * caller-supplied guardrail-sourced section).\n */\nconst DEFAULT_PROTECTED_KEYS = new Set<string>([\n  'identity',\n  'identity-role',\n  'instructions',\n  'tools',\n  'tool-delivery',\n]);\n\nconst DEFAULT_PROTECTED_SOURCES: ReadonlyArray<AgentContextSectionSource> = [\n  'guardrail',\n];\n\nconst TRIM_MARKER_OVERHEAD = 60;\n\nfunction defaultEstimator(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n\nfunction isProtected(\n  section: AgentContextSection,\n  keys: ReadonlySet<string>,\n  sources: ReadonlySet<AgentContextSectionSource>\n): boolean {\n  if (keys.has(section.key)) return true;\n  if (section.source && sources.has(section.source)) return true;\n  return false;\n}\n\n/**\n * Apply a soft per-section token cap to the system-prompt sections of an\n * agent context. Total tokens above the cap are reduced by trimming\n * non-protected sections in priority-ascending order \u2014 the lowest-priority\n * (most important) section keeps its full content, followed by the next, and\n * so on. Any allotment less than the section's full length is replaced with\n * a clearly-marked truncation suffix so the model still sees a hint that\n * content was dropped.\n *\n * Protected sections (identity, instructions, tools, guardrails, etc.) are\n * never trimmed regardless of size \u2014 they may push the result above the cap.\n * This is a soft policy: it prefers preserving correctness over hitting the\n * exact budget.\n *\n * Section order in the output matches the input order; only contents change.\n */\nexport function applySectionCap(\n  sections: AgentContextSection[],\n  cap: SectionCapOptions\n): {\n  sections: AgentContextSection[];\n  overflow: SectionOverflowInfo | undefined;\n} {\n  if (!cap.maxTokens || cap.maxTokens <= 0) {\n    return { sections, overflow: undefined };\n  }\n\n  const estimator = cap.estimator ?? defaultEstimator;\n  const protectedKeys = new Set<string>([\n    ...DEFAULT_PROTECTED_KEYS,\n    ...(cap.protectedKeys ?? []),\n  ]);\n  const protectedSources = new Set<AgentContextSectionSource>([\n    ...DEFAULT_PROTECTED_SOURCES,\n    ...(cap.protectedSources ?? []),\n  ]);\n\n  const tokensFor = (s: AgentContextSection): number => estimator(s.content);\n\n  const originalTokens = sections.reduce((sum, s) => sum + tokensFor(s), 0);\n  if (originalTokens <= cap.maxTokens) return { sections, overflow: undefined };\n\n  const protectedSections: AgentContextSection[] = [];\n  const trimmable: AgentContextSection[] = [];\n  for (const s of sections) {\n    if (isProtected(s, protectedKeys, protectedSources)) {\n      protectedSections.push(s);\n    } else {\n      trimmable.push(s);\n    }\n  }\n\n  const protectedTokens = protectedSections.reduce(\n    (sum, s) => sum + tokensFor(s),\n    0\n  );\n  const trimmableBudget = Math.max(0, cap.maxTokens - protectedTokens);\n\n  // Allocate budget greedily by priority ascending: lowest priority number\n  // (most important non-protected) gets its full token usage first, the\n  // remainder is for the rest. Highest-priority (most disposable) sections\n  // are trimmed first.\n  const byImportance = [...trimmable].sort((a, b) => a.priority - b.priority);\n  const allotments = new Map<string, number>();\n  let remaining = trimmableBudget;\n  for (const s of byImportance) {\n    const need = tokensFor(s);\n    if (remaining <= 0) {\n      allotments.set(s.key, 0);\n      continue;\n    }\n    if (need <= remaining) {\n      allotments.set(s.key, need);\n      remaining -= need;\n    } else {\n      allotments.set(s.key, remaining);\n      remaining = 0;\n    }\n  }\n\n  const trimmedReports: SectionOverflowInfo['trimmed'] = [];\n  const replaced = new Map<string, AgentContextSection>();\n\n  for (const s of trimmable) {\n    const allotted = allotments.get(s.key) ?? 0;\n    const before = tokensFor(s);\n    if (allotted >= before) continue;\n    const next = trimContent(s, allotted, before);\n    replaced.set(s.key, next);\n    trimmedReports.push({ key: s.key, before, after: tokensFor(next) });\n  }\n\n  const finalSections = sections.map((s) => replaced.get(s.key) ?? s);\n  const finalTokens = finalSections.reduce((sum, s) => sum + tokensFor(s), 0);\n\n  const overflow: SectionOverflowInfo = {\n    cap: cap.maxTokens,\n    originalTokens,\n    finalTokens,\n    trimmed: trimmedReports,\n  };\n\n  cap.onOverflow?.(overflow);\n\n  return { sections: finalSections, overflow };\n}\n\nfunction trimContent(\n  section: AgentContextSection,\n  allotted: number,\n  before: number\n): AgentContextSection {\n  const droppedTokens = before - allotted;\n  if (allotted <= 0) {\n    return {\n      ...section,\n      content: `[\u2026trimmed ${droppedTokens} tokens to fit context budget\u2026]`,\n    };\n  }\n  const ratio = allotted / Math.max(1, before);\n  const targetChars = Math.max(\n    0,\n    Math.floor(section.content.length * ratio) - TRIM_MARKER_OVERHEAD\n  );\n  return {\n    ...section,\n    content:\n      section.content.slice(0, targetChars) +\n      `\\n\\n[\u2026trimmed ${droppedTokens} tokens to fit context budget\u2026]`,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/capabilities/agent-context/types.d.ts

@@ -0,0 +1,87 @@
+import type { CapabilityState } from '../types.js';
+export type AgentContextSectionSource = 'bridge' | 'harness' | 'mcp' | 'plugin' | 'user' | 'guardrail';
+export interface AgentContextSection {
+    key: string;
+    title: string;
+    content: string;
+    priority: number;
+    cacheable?: boolean;
+    source?: AgentContextSectionSource;
+}
+export type AgentGuardrailEnforcement = 'hard' | 'soft';
+export interface AgentGuardrail {
+    name: string;
+    content: string;
+    enforcement: AgentGuardrailEnforcement;
+}
+export type ToolEntrySource = 'action' | 'mcp' | 'skill' | 'builtin';
+export type ToolEntryPermission = 'allow' | 'deny' | 'ask';
+export interface ToolEntry {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    source: ToolEntrySource;
+    serverName?: string;
+    permission?: ToolEntryPermission;
+}
+export interface AgentContextMeta {
+    sectionCount: number;
+    toolCount: number;
+    guardrailCount: number;
+    estimatedTokens?: number;
+    sources: AgentContextSectionSource[];
+}
+export interface AgentContext {
+    sections: AgentContextSection[];
+    tools: ToolEntry[];
+    guardrails: AgentGuardrail[];
+    systemPrompt: string;
+    meta: AgentContextMeta;
+}
+export interface ContextMiddleware {
+    beforeBuild?: (sections: AgentContextSection[], state?: CapabilityState) => AgentContextSection[] | Promise<AgentContextSection[]>;
+    afterBuild?: (context: AgentContext, state?: CapabilityState) => AgentContext | Promise<AgentContext>;
+}
+export interface InheritOptions {
+    sections?: string[];
+    tools?: 'all' | 'filtered' | 'none';
+    toolFilter?: (tool: ToolEntry) => boolean;
+    guardrails: 'all';
+}
+/** Per-section trimming report when {@link SectionCapOptions} fires. */
+export interface SectionOverflowInfo {
+    cap: number;
+    originalTokens: number;
+    finalTokens: number;
+    trimmed: Array<{
+        key: string;
+        before: number;
+        after: number;
+    }>;
+}
+/**
+ * Soft cap applied to the composed system-prompt sections after
+ * `AgentContextBuilder` runs. Total estimated tokens above `maxTokens` are
+ * reduced by trimming non-protected sections (identity, instructions,
+ * tools, and guardrails are never trimmed). When the total is already
+ * under the cap, this is a no-op.
+ */
+export interface SectionCapOptions {
+    /** Token cap. `<= 0` disables the cap. */
+    maxTokens: number;
+    /** Token estimator. Defaults to `chars/4`. */
+    estimator?: (text: string) => number;
+    /** Fired when sections were trimmed. */
+    onOverflow?: (info: SectionOverflowInfo) => void;
+    /**
+     * Extra section keys to protect in addition to the built-in set
+     * (`identity`, `identity-role`, `instructions`, `tools`, `tool-delivery`).
+     */
+    protectedKeys?: ReadonlyArray<string>;
+    /**
+     * Extra section sources to protect in addition to the built-in set
+     * (`guardrail`).
+     */
+    protectedSources?: ReadonlyArray<AgentContextSectionSource>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/agent-context/types.d.ts.map

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

package/dist/capabilities/agent-context/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/capabilities/agent-context/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/capabilities/context-compaction-types.d.ts

@@ -0,0 +1,5 @@
+export interface ProtectedOverflowInfo {
+    evicted: number;
+    remainingTokens: number;
+}
+//# sourceMappingURL=context-compaction-types.d.ts.map

package/dist/capabilities/context-compaction-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-types.d.ts","sourceRoot":"","sources":["../../src/capabilities/context-compaction-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/capabilities/context-compaction-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=context-compaction-types.js.map

package/dist/capabilities/context-compaction-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/capabilities/context-compaction.d.ts

@@ -0,0 +1,38 @@
+import type { BackendName } from '../domain/core-client.js';
+import type { ContextCompactionOptions, ContextCompactionSummaryClient } from '../runtime/sessions/compaction-types.js';
+import type { ProtectedOverflowInfo } from './context-compaction-types.js';
+export interface HistoryEntry {
+    role: 'user' | 'assistant';
+    content: string;
+    /** — skip eviction and survive summarization verbatim. */
+    protected?: boolean;
+    /** Origin of this entry. `'skill'` entries are always protected. */
+    source?: 'skill' | 'action' | 'user';
+}
+export type SummaryClient = ContextCompactionSummaryClient;
+export type { ProtectedOverflowInfo } from './context-compaction-types.js';
+export interface CompactHistoryResult {
+    history: HistoryEntry[];
+    protectedOverflow?: ProtectedOverflowInfo;
+}
+/**
+ * Build a backend-aware chars-per-token estimator. Falls back to chars/4
+ * when the backend is unknown. Always rounds up so partial tokens are billed.
+ *
+ * Pluggable via `ContextCompactionOptions.estimator` — the resolver injects
+ * this default when the caller has not supplied a custom estimator.
+ */
+export declare function backendTokenEstimator(backend?: BackendName): (text: string) => number;
+/**
+ * Apply the `maxProtectedTokens` cap to a list of protected entries. Oldest-
+ * first eviction — caller is responsible for emitting
+ * `skill:protection:overflow` when `evicted > 0`.
+ */
+export declare function capProtectedEntries(entries: HistoryEntry[], maxProtectedTokens: number, estimator?: (t: string) => number): {
+    kept: HistoryEntry[];
+    evicted: number;
+    remainingTokens: number;
+};
+export declare function compactHistoryWithInfo(history: HistoryEntry[], currentPrompt: string, opts: ContextCompactionOptions, summaryClient?: SummaryClient, isApi?: boolean, force?: boolean): Promise<CompactHistoryResult>;
+export declare function compactHistory(history: HistoryEntry[], currentPrompt: string, opts: ContextCompactionOptions, summaryClient?: SummaryClient, isApi?: boolean, force?: boolean): Promise<HistoryEntry[]>;
+//# sourceMappingURL=context-compaction.d.ts.map

package/dist/capabilities/context-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction.d.ts","sourceRoot":"","sources":["../../src/capabilities/context-compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GAAG,8BAA8B,CAAC;AAE3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AA8BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,WAAW,GACpB,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAI1B;AAgED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAyB,GAClD;IAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAoBpE;AAqID,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,wBAAwB,EAC9B,aAAa,CAAC,EAAE,aAAa,EAC7B,KAAK,UAAO,EACZ,KAAK,UAAQ,GACZ,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,wBAAwB,EAC9B,aAAa,CAAC,EAAE,aAAa,EAC7B,KAAK,UAAO,EACZ,KAAK,UAAQ,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC,CAUzB"}

package/dist/capabilities/context-compaction.js

@@ -0,0 +1,205 @@
+import { transcriptTokens } from "../utils/tokens.js";
+const DEFAULT_CHARS_PER_TOKEN = 4;
+const DEFAULT_MAX_PROTECTED_TOKENS = 25e3;
+const BACKEND_CHARS_PER_TOKEN = {
+  "anthropic-api": 3.6,
+  "claude-code-cli": 3.6,
+  "codex-cli": 4,
+  "cursor-cli": 4,
+  ollama: 3.5,
+  "openai-api": 4,
+  "vercel-ai:anthropic": 3.6,
+  "vercel-ai:google": 4,
+  "vercel-ai:openai": 4
+};
+function backendTokenEstimator(backend) {
+  const charsPerToken = (backend && BACKEND_CHARS_PER_TOKEN[backend]) ?? DEFAULT_CHARS_PER_TOKEN;
+  return (text) => Math.ceil(text.length / charsPerToken);
+}
+function defaultEstimator(text) {
+  return Math.ceil(text.length / DEFAULT_CHARS_PER_TOKEN);
+}
+function isProtected(entry) {
+  return entry.protected === true || entry.source === "skill";
+}
+function taggedSection(name, content) {
+  return `<${name}>
+${content.trim()}
+</${name}>`;
+}
+function messageTag(entry) {
+  return `<message role="${entry.role}">
+${entry.content}
+</message>`;
+}
+function compactedContextContent(messageCount, summary) {
+  return [
+    `[Summary of previous ${messageCount} messages]`,
+    `<compacted_context messages_compacted="${messageCount}" layer="historical_context">`,
+    taggedSection("summary", summary),
+    "</compacted_context>"
+  ].join("\n");
+}
+function toCompactResult(history, capped) {
+  const protectedOverflow = protectedOverflowFromCap(capped);
+  return {
+    history,
+    ...protectedOverflow ? { protectedOverflow } : {}
+  };
+}
+function protectedOverflowFromCap(capped) {
+  if (!capped || capped.evicted <= 0) return void 0;
+  return {
+    evicted: capped.evicted,
+    remainingTokens: capped.remainingTokens
+  };
+}
+function mergeProtectedOverflow(left, right) {
+  if (!left) return right;
+  if (!right) return left;
+  return {
+    evicted: left.evicted + right.evicted,
+    remainingTokens: right.remainingTokens
+  };
+}
+function capProtectedEntries(entries, maxProtectedTokens, estimator = defaultEstimator) {
+  let total = 0;
+  for (const e of entries) total += estimator(e.content);
+  if (total <= maxProtectedTokens) {
+    return { kept: entries, evicted: 0, remainingTokens: total };
+  }
+  const kept = [];
+  let keptTokens = 0;
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const t = estimator(entries[i].content);
+    if (keptTokens + t > maxProtectedTokens) continue;
+    kept.unshift(entries[i]);
+    keptTokens += t;
+  }
+  return {
+    kept,
+    evicted: entries.length - kept.length,
+    remainingTokens: keptTokens
+  };
+}
+function truncateHistoryWithInfo(history, currentPrompt, opts) {
+  const estimator = opts.estimator ?? defaultEstimator;
+  const keepRecent = opts.keepRecent ?? 4;
+  const maxTokens = opts.maxTokens ?? 0;
+  const promptTokens = estimator(currentPrompt);
+  const historyBudget = Math.max(0, maxTokens - promptTokens);
+  const recentSlice = history.slice(-keepRecent);
+  const recentTokens = transcriptTokens(recentSlice, estimator);
+  const older = history.slice(0, -keepRecent);
+  const protectedOlder = [];
+  const unprotectedOlder = [];
+  for (const e of older) {
+    if (isProtected(e)) protectedOlder.push(e);
+    else unprotectedOlder.push(e);
+  }
+  const cap = opts.maxProtectedTokens ?? DEFAULT_MAX_PROTECTED_TOKENS;
+  const capped = capProtectedEntries(protectedOlder, cap, estimator);
+  const protectedKept = capped.kept;
+  const protectedTokens = transcriptTokens(protectedKept, estimator);
+  if (recentTokens + protectedTokens >= historyBudget) {
+    return toCompactResult([...protectedKept, ...recentSlice], capped);
+  }
+  const budget = historyBudget - recentTokens - protectedTokens;
+  const kept = [];
+  let used = 0;
+  for (let i = unprotectedOlder.length - 1; i >= 0; i -= 1) {
+    const entry = unprotectedOlder[i];
+    const entryTokens = estimator(entry.content);
+    if (used + entryTokens > budget) break;
+    kept.unshift(entry);
+    used += entryTokens;
+  }
+  const olderOrderIndex = /* @__PURE__ */ new Map();
+  older.forEach((e, idx) => olderOrderIndex.set(e, idx));
+  const combined = [...protectedKept, ...kept];
+  combined.sort(
+    (a, b) => (olderOrderIndex.get(a) ?? 0) - (olderOrderIndex.get(b) ?? 0)
+  );
+  return toCompactResult([...combined, ...recentSlice], capped);
+}
+async function summarizeHistory(history, currentPrompt, opts, summaryClient) {
+  if (!summaryClient) {
+    return truncateHistoryWithInfo(history, currentPrompt, opts);
+  }
+  const estimator = opts.estimator ?? defaultEstimator;
+  const keepRecent = opts.keepRecent ?? 4;
+  const recentSlice = history.slice(-keepRecent);
+  if (history.length <= keepRecent) {
+    return toCompactResult(history);
+  }
+  const olderMessages = history.slice(0, -keepRecent);
+  const protectedOlder = olderMessages.filter(isProtected);
+  const capped = capProtectedEntries(
+    protectedOlder,
+    opts.maxProtectedTokens ?? DEFAULT_MAX_PROTECTED_TOKENS,
+    estimator
+  );
+  const protectedKept = capped.kept;
+  const summarizable = olderMessages.filter((e) => !isProtected(e));
+  const transcript = taggedSection(
+    "conversation_transcript",
+    summarizable.map(messageTag).join("\n\n")
+  );
+  const systemPrompt = opts.summarySystemPrompt ?? "Summarize the following conversation transcript concisely, preserving key decisions, code references, file paths, and action items. The summary will be used as context for continuing the conversation. Keep prompt layers explicit: do not merge system instructions, tools, MCP servers, skills, plugins, task directives, or user messages into one another.";
+  const summary = summarizable.length > 0 ? await summaryClient(systemPrompt, transcript) : "";
+  const summaryEntries = summarizable.length > 0 ? [
+    {
+      role: "assistant",
+      content: compactedContextContent(summarizable.length, summary)
+    }
+  ] : [];
+  const result = [...protectedKept, ...summaryEntries, ...recentSlice];
+  const totalTokens = transcriptTokens(result, estimator);
+  const maxTokens = opts.maxTokens ?? 0;
+  const promptTokens = estimator(currentPrompt);
+  const historyBudget = Math.max(0, maxTokens - promptTokens);
+  if (totalTokens > historyBudget) {
+    const truncated = truncateHistoryWithInfo(result, currentPrompt, opts);
+    return {
+      history: truncated.history,
+      protectedOverflow: mergeProtectedOverflow(
+        protectedOverflowFromCap(capped),
+        truncated.protectedOverflow
+      )
+    };
+  }
+  return toCompactResult(result, capped);
+}
+async function compactHistoryWithInfo(history, currentPrompt, opts, summaryClient, isApi = true, force = false) {
+  if (!isApi || history.length === 0) return toCompactResult(history);
+  const estimator = opts.estimator ?? defaultEstimator;
+  const maxTokens = opts.maxTokens ?? 0;
+  const promptTokens = estimator(currentPrompt);
+  const historyTokens = transcriptTokens(history, estimator);
+  if (!force && historyTokens + promptTokens <= maxTokens) {
+    return toCompactResult(history);
+  }
+  const strategy = opts.strategy ?? "truncate";
+  if (strategy === "summarize") {
+    return summarizeHistory(history, currentPrompt, opts, summaryClient);
+  }
+  return truncateHistoryWithInfo(history, currentPrompt, opts);
+}
+async function compactHistory(history, currentPrompt, opts, summaryClient, isApi = true, force = false) {
+  const result = await compactHistoryWithInfo(
+    history,
+    currentPrompt,
+    opts,
+    summaryClient,
+    isApi,
+    force
+  );
+  return result.history;
+}
+export {
+  backendTokenEstimator,
+  capProtectedEntries,
+  compactHistory,
+  compactHistoryWithInfo
+};
+//# sourceMappingURL=context-compaction.js.map

package/dist/capabilities/context-compaction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/capabilities/context-compaction.ts"],
+  "sourcesContent": ["import type { BackendName } from '../domain/core-client.js';\nimport type {\n  ContextCompactionOptions,\n  ContextCompactionSummaryClient,\n} from '../runtime/sessions/compaction-types.js';\nimport { transcriptTokens } from '../utils/tokens.js';\nimport type { ProtectedOverflowInfo } from './context-compaction-types.js';\n\nexport interface HistoryEntry {\n  role: 'user' | 'assistant';\n  content: string;\n  /** \u2014 skip eviction and survive summarization verbatim. */\n  protected?: boolean;\n  /** Origin of this entry. `'skill'` entries are always protected. */\n  source?: 'skill' | 'action' | 'user';\n}\n\nexport type SummaryClient = ContextCompactionSummaryClient;\n\nexport type { ProtectedOverflowInfo } from './context-compaction-types.js';\n\nexport interface CompactHistoryResult {\n  history: HistoryEntry[];\n  protectedOverflow?: ProtectedOverflowInfo;\n}\n\nconst DEFAULT_CHARS_PER_TOKEN = 4;\nconst DEFAULT_MAX_PROTECTED_TOKENS = 25_000;\n\n/**\n * Per-backend chars-per-token defaults for the built-in estimator.\n *\n * Sources:\n *   - Claude family (3.6): empirical Anthropic tokenizer ratio for English.\n *   - OpenAI / Gemini family (4.0): cl100k baseline used by tiktoken.\n *   - Llama BPE family (3.5): Ollama / llama.cpp typical English ratio.\n *\n * These are heuristics, not exact tokenizers \u2014 the public estimator hook on\n * `ContextCompactionOptions.estimator` always wins when the caller provides\n * one (e.g. a real tiktoken-based estimator). Use this map to avoid making\n * `chars/4` the universal default for every backend.\n */\nconst BACKEND_CHARS_PER_TOKEN: Partial<Record<BackendName, number>> = {\n  'anthropic-api': 3.6,\n  'claude-code-cli': 3.6,\n  'codex-cli': 4.0,\n  'cursor-cli': 4.0,\n  ollama: 3.5,\n  'openai-api': 4.0,\n  'vercel-ai:anthropic': 3.6,\n  'vercel-ai:google': 4.0,\n  'vercel-ai:openai': 4.0,\n};\n\n/**\n * Build a backend-aware chars-per-token estimator. Falls back to chars/4\n * when the backend is unknown. Always rounds up so partial tokens are billed.\n *\n * Pluggable via `ContextCompactionOptions.estimator` \u2014 the resolver injects\n * this default when the caller has not supplied a custom estimator.\n */\nexport function backendTokenEstimator(\n  backend?: BackendName\n): (text: string) => number {\n  const charsPerToken =\n    (backend && BACKEND_CHARS_PER_TOKEN[backend]) ?? DEFAULT_CHARS_PER_TOKEN;\n  return (text: string) => Math.ceil(text.length / charsPerToken);\n}\n\nfunction defaultEstimator(text: string): number {\n  return Math.ceil(text.length / DEFAULT_CHARS_PER_TOKEN);\n}\n\nfunction isProtected(entry: HistoryEntry): boolean {\n  return entry.protected === true || entry.source === 'skill';\n}\n\nfunction taggedSection(name: string, content: string): string {\n  return `<${name}>\\n${content.trim()}\\n</${name}>`;\n}\n\nfunction messageTag(entry: HistoryEntry): string {\n  return `<message role=\"${entry.role}\">\\n${entry.content}\\n</message>`;\n}\n\nfunction compactedContextContent(\n  messageCount: number,\n  summary: string\n): string {\n  return [\n    `[Summary of previous ${messageCount} messages]`,\n    `<compacted_context messages_compacted=\"${messageCount}\" layer=\"historical_context\">`,\n    taggedSection('summary', summary),\n    '</compacted_context>',\n  ].join('\\n');\n}\n\nfunction toCompactResult(\n  history: HistoryEntry[],\n  capped?: { evicted: number; remainingTokens: number }\n): CompactHistoryResult {\n  const protectedOverflow = protectedOverflowFromCap(capped);\n  return {\n    history,\n    ...(protectedOverflow ? { protectedOverflow } : {}),\n  };\n}\n\nfunction protectedOverflowFromCap(capped?: {\n  evicted: number;\n  remainingTokens: number;\n}): ProtectedOverflowInfo | undefined {\n  if (!capped || capped.evicted <= 0) return undefined;\n  return {\n    evicted: capped.evicted,\n    remainingTokens: capped.remainingTokens,\n  };\n}\n\nfunction mergeProtectedOverflow(\n  left: ProtectedOverflowInfo | undefined,\n  right: ProtectedOverflowInfo | undefined\n): ProtectedOverflowInfo | undefined {\n  if (!left) return right;\n  if (!right) return left;\n  return {\n    evicted: left.evicted + right.evicted,\n    remainingTokens: right.remainingTokens,\n  };\n}\n\n/**\n * Apply the `maxProtectedTokens` cap to a list of protected entries. Oldest-\n * first eviction \u2014 caller is responsible for emitting\n * `skill:protection:overflow` when `evicted > 0`.\n */\nexport function capProtectedEntries(\n  entries: HistoryEntry[],\n  maxProtectedTokens: number,\n  estimator: (t: string) => number = defaultEstimator\n): { kept: HistoryEntry[]; evicted: number; remainingTokens: number } {\n  let total = 0;\n  for (const e of entries) total += estimator(e.content);\n  if (total <= maxProtectedTokens) {\n    return { kept: entries, evicted: 0, remainingTokens: total };\n  }\n  const kept: HistoryEntry[] = [];\n  let keptTokens = 0;\n  // Walk newest-first; keep until we hit the budget; drop older.\n  for (let i = entries.length - 1; i >= 0; i -= 1) {\n    const t = estimator(entries[i]!.content);\n    if (keptTokens + t > maxProtectedTokens) continue;\n    kept.unshift(entries[i]!);\n    keptTokens += t;\n  }\n  return {\n    kept,\n    evicted: entries.length - kept.length,\n    remainingTokens: keptTokens,\n  };\n}\n\nfunction truncateHistoryWithInfo(\n  history: HistoryEntry[],\n  currentPrompt: string,\n  opts: ContextCompactionOptions\n): CompactHistoryResult {\n  const estimator = opts.estimator ?? defaultEstimator;\n  const keepRecent = opts.keepRecent ?? 4;\n  const maxTokens = opts.maxTokens ?? 0;\n  const promptTokens = estimator(currentPrompt);\n  const historyBudget = Math.max(0, maxTokens - promptTokens);\n\n  const recentSlice = history.slice(-keepRecent);\n  const recentTokens = transcriptTokens(recentSlice, estimator);\n  const older = history.slice(0, -keepRecent);\n\n  // Split older into protected vs unprotected.\n  const protectedOlder: HistoryEntry[] = [];\n  const unprotectedOlder: HistoryEntry[] = [];\n  for (const e of older) {\n    if (isProtected(e)) protectedOlder.push(e);\n    else unprotectedOlder.push(e);\n  }\n\n  // Apply the maxProtectedTokens cap (advisory, per).\n  const cap = opts.maxProtectedTokens ?? DEFAULT_MAX_PROTECTED_TOKENS;\n  const capped = capProtectedEntries(protectedOlder, cap, estimator);\n  const protectedKept = capped.kept;\n  const protectedTokens = transcriptTokens(protectedKept, estimator);\n\n  if (recentTokens + protectedTokens >= historyBudget) {\n    return toCompactResult([...protectedKept, ...recentSlice], capped);\n  }\n\n  const budget = historyBudget - recentTokens - protectedTokens;\n  const kept: HistoryEntry[] = [];\n  let used = 0;\n  for (let i = unprotectedOlder.length - 1; i >= 0; i -= 1) {\n    const entry = unprotectedOlder[i]!;\n    const entryTokens = estimator(entry.content);\n    if (used + entryTokens > budget) break;\n    kept.unshift(entry);\n    used += entryTokens;\n  }\n\n  // Re-stitch preserving original order across the mix of kept unprotected\n  // and protected entries.\n  const olderOrderIndex = new Map<HistoryEntry, number>();\n  older.forEach((e, idx) => olderOrderIndex.set(e, idx));\n  const combined = [...protectedKept, ...kept];\n  combined.sort(\n    (a, b) => (olderOrderIndex.get(a) ?? 0) - (olderOrderIndex.get(b) ?? 0)\n  );\n\n  return toCompactResult([...combined, ...recentSlice], capped);\n}\n\nasync function summarizeHistory(\n  history: HistoryEntry[],\n  currentPrompt: string,\n  opts: ContextCompactionOptions,\n  summaryClient?: SummaryClient\n): Promise<CompactHistoryResult> {\n  if (!summaryClient) {\n    return truncateHistoryWithInfo(history, currentPrompt, opts);\n  }\n\n  const estimator = opts.estimator ?? defaultEstimator;\n  const keepRecent = opts.keepRecent ?? 4;\n  const recentSlice = history.slice(-keepRecent);\n\n  if (history.length <= keepRecent) {\n    return toCompactResult(history);\n  }\n\n  const olderMessages = history.slice(0, -keepRecent);\n  // Protected entries survive summarization verbatim.\n  const protectedOlder = olderMessages.filter(isProtected);\n  const capped = capProtectedEntries(\n    protectedOlder,\n    opts.maxProtectedTokens ?? DEFAULT_MAX_PROTECTED_TOKENS,\n    estimator\n  );\n  const protectedKept = capped.kept;\n  const summarizable = olderMessages.filter((e) => !isProtected(e));\n\n  const transcript = taggedSection(\n    'conversation_transcript',\n    summarizable.map(messageTag).join('\\n\\n')\n  );\n\n  const systemPrompt =\n    opts.summarySystemPrompt ??\n    'Summarize the following conversation transcript concisely, preserving key decisions, ' +\n      'code references, file paths, and action items. The summary will be used as context for continuing the conversation. ' +\n      'Keep prompt layers explicit: do not merge system instructions, tools, MCP servers, skills, plugins, task directives, or user messages into one another.';\n\n  const summary =\n    summarizable.length > 0\n      ? await summaryClient(systemPrompt, transcript)\n      : '';\n\n  const summaryEntries: HistoryEntry[] =\n    summarizable.length > 0\n      ? [\n          {\n            role: 'assistant',\n            content: compactedContextContent(summarizable.length, summary),\n          },\n        ]\n      : [];\n\n  const result = [...protectedKept, ...summaryEntries, ...recentSlice];\n  const totalTokens = transcriptTokens(result, estimator);\n  const maxTokens = opts.maxTokens ?? 0;\n  const promptTokens = estimator(currentPrompt);\n  const historyBudget = Math.max(0, maxTokens - promptTokens);\n\n  if (totalTokens > historyBudget) {\n    const truncated = truncateHistoryWithInfo(result, currentPrompt, opts);\n    return {\n      history: truncated.history,\n      protectedOverflow: mergeProtectedOverflow(\n        protectedOverflowFromCap(capped),\n        truncated.protectedOverflow\n      ),\n    };\n  }\n\n  return toCompactResult(result, capped);\n}\n\nexport async function compactHistoryWithInfo(\n  history: HistoryEntry[],\n  currentPrompt: string,\n  opts: ContextCompactionOptions,\n  summaryClient?: SummaryClient,\n  isApi = true,\n  force = false\n): Promise<CompactHistoryResult> {\n  if (!isApi || history.length === 0) return toCompactResult(history);\n\n  const estimator = opts.estimator ?? defaultEstimator;\n  const maxTokens = opts.maxTokens ?? 0;\n  const promptTokens = estimator(currentPrompt);\n  const historyTokens = transcriptTokens(history, estimator);\n\n  if (!force && historyTokens + promptTokens <= maxTokens) {\n    return toCompactResult(history);\n  }\n\n  const strategy = opts.strategy ?? 'truncate';\n  if (strategy === 'summarize') {\n    return summarizeHistory(history, currentPrompt, opts, summaryClient);\n  }\n\n  return truncateHistoryWithInfo(history, currentPrompt, opts);\n}\n\nexport async function compactHistory(\n  history: HistoryEntry[],\n  currentPrompt: string,\n  opts: ContextCompactionOptions,\n  summaryClient?: SummaryClient,\n  isApi = true,\n  force = false\n): Promise<HistoryEntry[]> {\n  const result = await compactHistoryWithInfo(\n    history,\n    currentPrompt,\n    opts,\n    summaryClient,\n    isApi,\n    force\n  );\n  return result.history;\n}\n"],
+  "mappings": "AAKA,SAAS,wBAAwB;AAqBjC,MAAM,0BAA0B;AAChC,MAAM,+BAA+B;AAerC,MAAM,0BAAgE;AAAA,EACpE,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,oBAAoB;AACtB;AASO,SAAS,sBACd,SAC0B;AAC1B,QAAM,iBACH,WAAW,wBAAwB,OAAO,MAAM;AACnD,SAAO,CAAC,SAAiB,KAAK,KAAK,KAAK,SAAS,aAAa;AAChE;AAEA,SAAS,iBAAiB,MAAsB;AAC9C,SAAO,KAAK,KAAK,KAAK,SAAS,uBAAuB;AACxD;AAEA,SAAS,YAAY,OAA8B;AACjD,SAAO,MAAM,cAAc,QAAQ,MAAM,WAAW;AACtD;AAEA,SAAS,cAAc,MAAc,SAAyB;AAC5D,SAAO,IAAI,IAAI;AAAA,EAAM,QAAQ,KAAK,CAAC;AAAA,IAAO,IAAI;AAChD;AAEA,SAAS,WAAW,OAA6B;AAC/C,SAAO,kBAAkB,MAAM,IAAI;AAAA,EAAO,MAAM,OAAO;AAAA;AACzD;AAEA,SAAS,wBACP,cACA,SACQ;AACR,SAAO;AAAA,IACL,wBAAwB,YAAY;AAAA,IACpC,0CAA0C,YAAY;AAAA,IACtD,cAAc,WAAW,OAAO;AAAA,IAChC;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,gBACP,SACA,QACsB;AACtB,QAAM,oBAAoB,yBAAyB,MAAM;AACzD,SAAO;AAAA,IACL;AAAA,IACA,GAAI,oBAAoB,EAAE,kBAAkB,IAAI,CAAC;AAAA,EACnD;AACF;AAEA,SAAS,yBAAyB,QAGI;AACpC,MAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO;AAC3C,SAAO;AAAA,IACL,SAAS,OAAO;AAAA,IAChB,iBAAiB,OAAO;AAAA,EAC1B;AACF;AAEA,SAAS,uBACP,MACA,OACmC;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;AAAA,IACL,SAAS,KAAK,UAAU,MAAM;AAAA,IAC9B,iBAAiB,MAAM;AAAA,EACzB;AACF;AAOO,SAAS,oBACd,SACA,oBACA,YAAmC,kBACiC;AACpE,MAAI,QAAQ;AACZ,aAAW,KAAK,QAAS,UAAS,UAAU,EAAE,OAAO;AACrD,MAAI,SAAS,oBAAoB;AAC/B,WAAO,EAAE,MAAM,SAAS,SAAS,GAAG,iBAAiB,MAAM;AAAA,EAC7D;AACA,QAAM,OAAuB,CAAC;AAC9B,MAAI,aAAa;AAEjB,WAAS,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AAC/C,UAAM,IAAI,UAAU,QAAQ,CAAC,EAAG,OAAO;AACvC,QAAI,aAAa,IAAI,mBAAoB;AACzC,SAAK,QAAQ,QAAQ,CAAC,CAAE;AACxB,kBAAc;AAAA,EAChB;AACA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,QAAQ,SAAS,KAAK;AAAA,IAC/B,iBAAiB;AAAA,EACnB;AACF;AAEA,SAAS,wBACP,SACA,eACA,MACsB;AACtB,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,aAAa,KAAK,cAAc;AACtC,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,eAAe,UAAU,aAAa;AAC5C,QAAM,gBAAgB,KAAK,IAAI,GAAG,YAAY,YAAY;AAE1D,QAAM,cAAc,QAAQ,MAAM,CAAC,UAAU;AAC7C,QAAM,eAAe,iBAAiB,aAAa,SAAS;AAC5D,QAAM,QAAQ,QAAQ,MAAM,GAAG,CAAC,UAAU;AAG1C,QAAM,iBAAiC,CAAC;AACxC,QAAM,mBAAmC,CAAC;AAC1C,aAAW,KAAK,OAAO;AACrB,QAAI,YAAY,CAAC,EAAG,gBAAe,KAAK,CAAC;AAAA,QACpC,kBAAiB,KAAK,CAAC;AAAA,EAC9B;AAGA,QAAM,MAAM,KAAK,sBAAsB;AACvC,QAAM,SAAS,oBAAoB,gBAAgB,KAAK,SAAS;AACjE,QAAM,gBAAgB,OAAO;AAC7B,QAAM,kBAAkB,iBAAiB,eAAe,SAAS;AAEjE,MAAI,eAAe,mBAAmB,eAAe;AACnD,WAAO,gBAAgB,CAAC,GAAG,eAAe,GAAG,WAAW,GAAG,MAAM;AAAA,EACnE;AAEA,QAAM,SAAS,gBAAgB,eAAe;AAC9C,QAAM,OAAuB,CAAC;AAC9B,MAAI,OAAO;AACX,WAAS,IAAI,iBAAiB,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AACxD,UAAM,QAAQ,iBAAiB,CAAC;AAChC,UAAM,cAAc,UAAU,MAAM,OAAO;AAC3C,QAAI,OAAO,cAAc,OAAQ;AACjC,SAAK,QAAQ,KAAK;AAClB,YAAQ;AAAA,EACV;AAIA,QAAM,kBAAkB,oBAAI,IAA0B;AACtD,QAAM,QAAQ,CAAC,GAAG,QAAQ,gBAAgB,IAAI,GAAG,GAAG,CAAC;AACrD,QAAM,WAAW,CAAC,GAAG,eAAe,GAAG,IAAI;AAC3C,WAAS;AAAA,IACP,CAAC,GAAG,OAAO,gBAAgB,IAAI,CAAC,KAAK,MAAM,gBAAgB,IAAI,CAAC,KAAK;AAAA,EACvE;AAEA,SAAO,gBAAgB,CAAC,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM;AAC9D;AAEA,eAAe,iBACb,SACA,eACA,MACA,eAC+B;AAC/B,MAAI,CAAC,eAAe;AAClB,WAAO,wBAAwB,SAAS,eAAe,IAAI;AAAA,EAC7D;AAEA,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,aAAa,KAAK,cAAc;AACtC,QAAM,cAAc,QAAQ,MAAM,CAAC,UAAU;AAE7C,MAAI,QAAQ,UAAU,YAAY;AAChC,WAAO,gBAAgB,OAAO;AAAA,EAChC;AAEA,QAAM,gBAAgB,QAAQ,MAAM,GAAG,CAAC,UAAU;AAElD,QAAM,iBAAiB,cAAc,OAAO,WAAW;AACvD,QAAM,SAAS;AAAA,IACb;AAAA,IACA,KAAK,sBAAsB;AAAA,IAC3B;AAAA,EACF;AACA,QAAM,gBAAgB,OAAO;AAC7B,QAAM,eAAe,cAAc,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAEhE,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,aAAa,IAAI,UAAU,EAAE,KAAK,MAAM;AAAA,EAC1C;AAEA,QAAM,eACJ,KAAK,uBACL;AAIF,QAAM,UACJ,aAAa,SAAS,IAClB,MAAM,cAAc,cAAc,UAAU,IAC5C;AAEN,QAAM,iBACJ,aAAa,SAAS,IAClB;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,SAAS,wBAAwB,aAAa,QAAQ,OAAO;AAAA,IAC/D;AAAA,EACF,IACA,CAAC;AAEP,QAAM,SAAS,CAAC,GAAG,eAAe,GAAG,gBAAgB,GAAG,WAAW;AACnE,QAAM,cAAc,iBAAiB,QAAQ,SAAS;AACtD,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,eAAe,UAAU,aAAa;AAC5C,QAAM,gBAAgB,KAAK,IAAI,GAAG,YAAY,YAAY;AAE1D,MAAI,cAAc,eAAe;AAC/B,UAAM,YAAY,wBAAwB,QAAQ,eAAe,IAAI;AACrE,WAAO;AAAA,MACL,SAAS,UAAU;AAAA,MACnB,mBAAmB;AAAA,QACjB,yBAAyB,MAAM;AAAA,QAC/B,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAEA,SAAO,gBAAgB,QAAQ,MAAM;AACvC;AAEA,eAAsB,uBACpB,SACA,eACA,MACA,eACA,QAAQ,MACR,QAAQ,OACuB;AAC/B,MAAI,CAAC,SAAS,QAAQ,WAAW,EAAG,QAAO,gBAAgB,OAAO;AAElE,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,eAAe,UAAU,aAAa;AAC5C,QAAM,gBAAgB,iBAAiB,SAAS,SAAS;AAEzD,MAAI,CAAC,SAAS,gBAAgB,gBAAgB,WAAW;AACvD,WAAO,gBAAgB,OAAO;AAAA,EAChC;AAEA,QAAM,WAAW,KAAK,YAAY;AAClC,MAAI,aAAa,aAAa;AAC5B,WAAO,iBAAiB,SAAS,eAAe,MAAM,aAAa;AAAA,EACrE;AAEA,SAAO,wBAAwB,SAAS,eAAe,IAAI;AAC7D;AAEA,eAAsB,eACpB,SACA,eACA,MACA,eACA,QAAQ,MACR,QAAQ,OACiB;AACzB,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO,OAAO;AAChB;",
+  "names": []
+}

package/dist/capabilities/context-composer.d.ts

@@ -0,0 +1,4 @@
+import type { BridgeSendMessageParams } from '../domain/bridge-api.js';
+import type { CapabilityState } from './types.js';
+export declare function buildCapabilityState(params: BridgeSendMessageParams, input: Omit<CapabilityState, 'params'>): CapabilityState;
+//# sourceMappingURL=context-composer.d.ts.map

package/dist/capabilities/context-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-composer.d.ts","sourceRoot":"","sources":["../../src/capabilities/context-composer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GACrC,eAAe,CAEjB"}

package/dist/capabilities/context-composer.js

@@ -0,0 +1,7 @@
+function buildCapabilityState(params, input) {
+  return { ...input, params };
+}
+export {
+  buildCapabilityState
+};
+//# sourceMappingURL=context-composer.js.map

package/dist/capabilities/context-composer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/capabilities/context-composer.ts"],
+  "sourcesContent": ["import type { BridgeSendMessageParams } from '../domain/bridge-api.js';\nimport type { CapabilityState } from './types.js';\n\nexport function buildCapabilityState(\n  params: BridgeSendMessageParams,\n  input: Omit<CapabilityState, 'params'>\n): CapabilityState {\n  return { ...input, params };\n}\n"],
+  "mappings": "AAGO,SAAS,qBACd,QACA,OACiB;AACjB,SAAO,EAAE,GAAG,OAAO,OAAO;AAC5B;",
+  "names": []
+}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,19 @@
+export type { AgentContext, AgentContextMeta, AgentContextSection, AgentContextSectionSource, AgentGuardrail, AgentGuardrailEnforcement, BuildBridgeAgentContextOptions, ContextMiddleware, InheritOptions, ToolEntry, ToolEntryPermission, ToolEntrySource, } from './agent-context/index.js';
+export { AgentContextBuilder, buildBridgeAgentContext, buildBridgeSystemPrompt, createNativeToolDeliveryMiddleware, renderContext, renderGuardrails, renderSection, } from './agent-context/index.js';
+export { buildCapabilityState } from './context-composer.js';
+export { prepareSkillDelivery } from './skill-delivery.js';
+export { resolveSkillActions } from './skill-injector.js';
+export { SkillRegistry } from './skill-registry.js';
+export type { SkillBackendFamily, SkillDefinition, SkillDeliveryResult, SkillDeliveryStrategy, } from './skill-types.js';
+export { classifyBackendForSkills } from './skill-types.js';
+export type { SkillBundleLoaderOptions, SkillBundleMetadata, } from './skills/bundle-loader.js';
+export { loadSkillBundle, loadSkillBundles, loadSkillPath, loadSkillPaths, } from './skills/bundle-loader.js';
+export type { DiscoveredSkill, DiscoveredSkillOrigin, DiscoverLocalSkillsOptions, DiscoverLocalSkillsResult, RelativePathDiscovery, } from './skills/discovery.js';
+export { discoverLocalSkills } from './skills/discovery.js';
+export type { LoadSkillFromGithubOptions, ParsedGithubSource, SkillFetcher, SkillFetcherRunArgs, SkillFetcherRunner, } from './skills/github-loader.js';
+export { loadSkillFromGithub, parseSkillGithubSource, } from './skills/github-loader.js';
+export { extractCapabilityToolCalls } from './tool-calls.js';
+export type { AgentLoopOptions, BridgeMcpLoadOptions, BridgeMcpServerConfig, CapabilityContextOptions, CapabilityContextSection, CapabilityMiddleware, CapabilitySkill, CapabilityState, CapabilityToolCall, } from './types.js';
+export type { DiscoverSkillsFromPathsOptions, ReadSkillInput, ReadSkillOptions, SkillCatalogSection, SkillMetadata, SkillRecord, SkillRunnerOptions, SkillToolDefinition, WellKnownSkillLocationsOptions, } from 'octoflow-skill-runner';
+export { activateSkillByName, buildSkillCatalog, createActivateSkillTool, createReadSkillTool, createSkillRunner, discoverSkillsFromPaths, discoverWellKnownSkillLocations, isSkillResourcePathInside, parseFrontmatterLoose, readSkill, } from 'octoflow-skill-runner';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,yBAAyB,EACzB,8BAA8B,EAC9B,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAClC,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EACV,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,8BAA8B,EAC9B,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,SAAS,GACV,MAAM,uBAAuB,CAAC"}