@cuylabs/agent-core 4.9.0 → 5.0.0

package/dist/{chunk-BGG2HVIR.js → chunk-V4MIDL5B.js}

@@ -27,6 +27,14 @@ function detectModelFamily(model) {
   }
   return "default";
 }
+var DEFAULT_SYSTEM_PROMPT = `You are a capable AI assistant with access to tools.
+
+Think step by step about what you need to do.
+Use the available tools to accomplish tasks.
+Verify your results after each action.
+
+If a tool fails, try an alternative approach \u2014 do not give up after a single error.
+Keep working until the task is fully resolved or you have exhausted all options.`;
 var TEMPLATE_ANTHROPIC = `You are a capable AI assistant with access to tools.
 
 <approach>
@@ -527,6 +535,7 @@ function createPromptBuilder(config) {
 
 export {
   detectModelFamily,
+  DEFAULT_SYSTEM_PROMPT,
   getTemplate,
   getAvailableFamilies,
   gatherEnvironment,

package/dist/chunk-W6LWIMIX.js

@@ -0,0 +1,8 @@
+// src/middleware/types.ts
+function isBlockedModelCall(value) {
+  return "block" in value && value.block === true;
+}
+
+export {
+  isBlockedModelCall
+};

package/dist/context/assembly/index.d.ts

@@ -0,0 +1,3 @@
+export { assembleModelContext } from "./prepare.js";
+export type { ContextFragmentCollector, ModelContextAssemblyOptions, ModelContextAssemblyReport, ModelContextAssemblyResult, ModelContextCompactionPhase, ModelContextCompactionReport, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/assembly/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/context/assembly/prepare.d.ts

@@ -0,0 +1,11 @@
+import type { ModelContextAssemblyOptions, ModelContextAssemblyResult } from "./types.js";
+/**
+ * Assemble the model-visible context for one model step.
+ *
+ * The caller owns persistence and compaction side effects. This function owns
+ * the deterministic in-memory model input shape: start with visible session
+ * messages, collect transient context fragments, fit/place/dedupe them, and
+ * return a small report that direct and durable runtimes can log or persist.
+ */
+export declare function assembleModelContext(options: ModelContextAssemblyOptions): Promise<ModelContextAssemblyResult>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/context/assembly/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/prepare.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,2BAA2B,EAE3B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AA+DpB;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/context/assembly/types.d.ts

@@ -0,0 +1,64 @@
+import type { Message } from "../../types/messages.js";
+import type { CompactionCutReason, CompactionEffectiveness, CompactionReason, CompactionTrigger } from "../../types/compaction.js";
+import type { AgentContextFragmentApplyReport, AgentContextFragmentBuildContext, AgentContextFragmentBudgetOptions, AgentContextFragmentInput } from "../fragments/types.js";
+import type { ContextCompactionDecision } from "../window/decision.js";
+import type { ContextWindowStats } from "../window/manager.js";
+import type { ContextTokenEstimator } from "../window/estimation.js";
+export type ModelContextCompactionPhase = "pre-step" | "recovery" | "post-turn" | "manual";
+export interface ContextFragmentCollector {
+    hasMiddleware?: boolean;
+    collectContextFragments(context: AgentContextFragmentBuildContext): Promise<AgentContextFragmentInput[]>;
+}
+export interface ModelContextAssemblyOptions {
+    sessionId: string;
+    turnId?: string;
+    step: number;
+    cwd: string;
+    messages: readonly Message[];
+    toolNames?: readonly string[];
+    mcpToolNames?: readonly string[];
+    abort?: AbortSignal;
+    contextFragmentCollector?: ContextFragmentCollector;
+    contextFragments?: readonly AgentContextFragmentInput[];
+    contextFragmentBudget?: AgentContextFragmentBudgetOptions;
+    window?: {
+        getStats(messages: readonly Message[]): ContextWindowStats;
+        getTokenEstimator?(): ContextTokenEstimator | undefined;
+    };
+    compaction?: ModelContextCompactionReport;
+}
+export interface ModelContextCompactionReport {
+    applied: boolean;
+    phase: ModelContextCompactionPhase;
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
+    inputTokens: number;
+    limit: number;
+    decision: ContextCompactionDecision;
+    effectiveness: CompactionEffectiveness;
+    removedCount: number;
+    tokensRemoved: number;
+    summarized: boolean;
+    cutIndex?: number;
+    cutReason?: CompactionCutReason;
+}
+export interface ModelContextAssemblyReport {
+    sessionId: string;
+    turnId?: string;
+    step: number;
+    messages: {
+        inputCount: number;
+        outputCount: number;
+    };
+    contextFragments: AgentContextFragmentApplyReport;
+    window: {
+        before?: ContextWindowStats;
+        after?: ContextWindowStats;
+    };
+    compaction?: ModelContextCompactionReport;
+}
+export interface ModelContextAssemblyResult {
+    messages: Message[];
+    report: ModelContextAssemblyReport;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/assembly/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,MAAM,2BAA2B,GACnC,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CACrB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,qBAAqB,CAAC,EAAE,iCAAiC,CAAC;IAC1D,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,kBAAkB,CAAC;QAC3D,iBAAiB,CAAC,IAAI,qBAAqB,GAAG,SAAS,CAAC;KACzD,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,2BAA2B,CAAC;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,uBAAuB,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,CAAC,EAAE,kBAAkB,CAAC;KAC5B,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,0BAA0B,CAAC;CACpC"}

package/dist/context/config.d.ts

@@ -0,0 +1,20 @@
+import type { ContextTokenEstimator } from "./window/index.js";
+export interface AgentContextConfig {
+    /**
+     * Maximum estimated tokens allowed for transient context fragments injected
+     * before a model step, including memory recall and middleware context.
+     *
+     * When omitted, the runtime uses a proportional cap based on the usable
+     * context window.
+     */
+    maxFragmentTokens?: number;
+    /**
+     * Optional estimator used by context-window planning.
+     *
+     * Agent-core still treats these numbers as estimates. Provider usage
+     * metadata remains a lower bound when available, and provider overflow
+     * recovery is still the final safety net.
+     */
+    tokenEstimator?: ContextTokenEstimator;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/context/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/context/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC"}

package/dist/context/fragments/index.d.ts

@@ -0,0 +1,4 @@
+export type { AgentContextFragmentBuildContext, AgentContextFragmentInput, AgentContextFragmentApplyReport, AgentContextFragmentApplyResult, AgentContextFragmentBudgetBehavior, AgentContextFragmentKind, AgentContextFragmentLifetime, AgentContextFragmentMessageMetadata, AgentContextFragmentPlacement, AgentContextFragmentRole, AgentContextFragmentBudgetOptions, AgentContextFragmentBudgetReport, AgentContextFragmentSkipReason, } from "./types.js";
+export { AGENT_CONTEXT_FRAGMENT_CLOSE, AGENT_CONTEXT_FRAGMENT_OPEN, AGENT_CONTEXT_FRAGMENT_TAG, isRenderedAgentContextFragment, normalizeAgentContextFragment, parseRenderedAgentContextFragment, renderAgentContextFragment, type NormalizedAgentContextFragment, } from "./render.js";
+export { applyAgentContextFragments, applyAgentContextFragmentsWithReport, createAgentContextFragmentMessage, getAgentContextFragmentMetadata, isAgentContextFragmentMessage, } from "./messages.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/fragments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/fragments/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC5B,mCAAmC,EACnC,6BAA6B,EAC7B,wBAAwB,EACxB,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,0BAA0B,EAC1B,KAAK,8BAA8B,GACpC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,iCAAiC,EACjC,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,eAAe,CAAC"}

package/dist/context/fragments/messages.d.ts

@@ -0,0 +1,12 @@
+import type { Message } from "../../types/messages.js";
+import { type ContextTokenEstimator } from "../window/estimation.js";
+import type { AgentContextFragmentApplyResult, AgentContextFragmentBudgetOptions, AgentContextFragmentInput, AgentContextFragmentMessageMetadata } from "./types.js";
+export declare function createAgentContextFragmentMessage(input: AgentContextFragmentInput): Message;
+export declare function getAgentContextFragmentMetadata(message: Message): AgentContextFragmentMessageMetadata | undefined;
+export declare function isAgentContextFragmentMessage(message: Message): boolean;
+export declare function applyAgentContextFragmentsWithReport(messages: readonly Message[], contextFragments?: readonly AgentContextFragmentInput[], options?: {
+    budget?: AgentContextFragmentBudgetOptions;
+    tokenEstimator?: ContextTokenEstimator;
+}): AgentContextFragmentApplyResult;
+export declare function applyAgentContextFragments(messages: readonly Message[], contextFragments?: readonly AgentContextFragmentInput[]): Message[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/context/fragments/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/context/fragments/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAEV,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EAEzB,mCAAmC,EAIpC,MAAM,YAAY,CAAC;AAapB,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAWT;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf,mCAAmC,GAAG,SAAS,CASjD;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvE;AA8GD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,EAC3D,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,iCAAiC,CAAC;IAC3C,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACnC,GACL,+BAA+B,CAgHjC;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,GAC1D,OAAO,EAAE,CAGX"}

package/dist/context/fragments/render.d.ts

@@ -0,0 +1,16 @@
+import type { AgentContextFragmentInput, AgentContextFragmentMessageMetadata } from "./types.js";
+export declare const AGENT_CONTEXT_FRAGMENT_TAG = "agent-context-fragment";
+export declare const AGENT_CONTEXT_FRAGMENT_OPEN = "<agent-context-fragment";
+export declare const AGENT_CONTEXT_FRAGMENT_CLOSE = "</agent-context-fragment>";
+export interface NormalizedAgentContextFragment {
+    content: string;
+    metadata: AgentContextFragmentMessageMetadata;
+}
+export declare function normalizeAgentContextFragment(input: AgentContextFragmentInput): NormalizedAgentContextFragment;
+export declare function renderAgentContextFragment(options: {
+    content: string;
+    metadata: AgentContextFragmentMessageMetadata;
+}): string;
+export declare function isRenderedAgentContextFragment(content: string): boolean;
+export declare function parseRenderedAgentContextFragment(content: string): AgentContextFragmentMessageMetadata | undefined;
+//# sourceMappingURL=render.d.ts.map

package/dist/context/fragments/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/context/fragments/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,mCAAmC,EACpC,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,2BAA2B,4BAAmC,CAAC;AAC5E,eAAO,MAAM,4BAA4B,8BAAqC,CAAC;AAE/E,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mCAAmC,CAAC;CAC/C;AAQD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,8BAA8B,CAoBhC;AAqBD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mCAAmC,CAAC;CAC/C,GAAG,MAAM,CAmBT;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,GACd,mCAAmC,GAAG,SAAS,CAmDjD"}

package/dist/context/fragments/types.d.ts

@@ -0,0 +1,87 @@
+import type { Message } from "../../types/messages.js";
+export type AgentContextFragmentRole = "system" | "user";
+export type AgentContextFragmentPlacement = "before-history" | "after-latest-user" | "after-history";
+export type AgentContextFragmentLifetime = "turn" | "session";
+export type AgentContextFragmentBudgetBehavior = "required" | "droppable";
+export type AgentContextFragmentSkipReason = "empty" | "duplicate-existing" | "duplicate-incoming" | "budget-exceeded";
+/**
+ * Diagnostic category for reports and tooling. Core does not switch behavior
+ * based on kind; use explicit fields such as role, placement, lifetime, and
+ * budgetBehavior for behavior.
+ */
+export type AgentContextFragmentKind = "environment" | "runtime" | "session" | "memory" | "instruction" | "hook" | (string & {});
+/**
+ * Serializable identity metadata carried by model-visible context fragment
+ * messages. The actual model-visible text stays in `Message.content`.
+ */
+export interface AgentContextFragmentMessageMetadata {
+    id: string;
+    kind: AgentContextFragmentKind;
+    role: AgentContextFragmentRole;
+    placement: AgentContextFragmentPlacement;
+    lifetime: AgentContextFragmentLifetime;
+    createdAt: string;
+    source?: string;
+    title?: string;
+    dedupeKey?: string;
+    budgetBehavior?: AgentContextFragmentBudgetBehavior;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentContextFragmentInput {
+    id?: string;
+    kind: AgentContextFragmentKind;
+    content: string;
+    role?: AgentContextFragmentRole;
+    placement?: AgentContextFragmentPlacement;
+    lifetime?: AgentContextFragmentLifetime;
+    source?: string;
+    title?: string;
+    dedupeKey?: string;
+    /**
+     * Budget behavior used when transient context fragments exceed their
+     * model-step budget. Required fragments are kept even when they exceed the
+     * budget. Droppable fragments are skipped when they do not fit.
+     */
+    budgetBehavior?: AgentContextFragmentBudgetBehavior;
+    /** Per-fragment content cap applied before rendering the model-visible text. */
+    maxChars?: number;
+    createdAt?: string | Date;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentContextFragmentBudgetOptions {
+    /** Maximum estimated model-input tokens allowed for transient fragments. */
+    maxEstimatedTokens: number;
+}
+export interface AgentContextFragmentBudgetReport {
+    applied: boolean;
+    maxEstimatedTokens: number;
+    requestedEstimatedTokens: number;
+    insertedEstimatedTokens: number;
+    skippedEstimatedTokens: number;
+}
+export interface AgentContextFragmentApplyReport {
+    requestedCount: number;
+    insertedCount: number;
+    skippedCount: number;
+    skippedByReason: Partial<Record<AgentContextFragmentSkipReason, number>>;
+    insertedKinds: AgentContextFragmentKind[];
+    insertedPlacements: AgentContextFragmentPlacement[];
+    insertedDedupeKeys: string[];
+    skippedDedupeKeys: string[];
+    budget?: AgentContextFragmentBudgetReport;
+}
+export interface AgentContextFragmentApplyResult {
+    messages: Message[];
+    report: AgentContextFragmentApplyReport;
+}
+export interface AgentContextFragmentBuildContext {
+    sessionId: string;
+    turnId?: string;
+    step: number;
+    cwd: string;
+    messages: readonly Message[];
+    toolNames: readonly string[];
+    mcpToolNames: readonly string[];
+    abort?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/fragments/types.d.ts.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context primitives.
+ *
+ * The context domain has three subdomains:
+ * - window: token budgets, pruning, and compaction planning
+ * - fragments: model-visible runtime/session context injected before a step
+ * - assembly: model-step context assembly and reporting
+ */
+export * from "./assembly/index.js";
+export * from "./window/index.js";
+export * from "./fragments/index.js";
+export * from "./config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,96 @@
+import {
+  assembleModelContext
+} from "../chunk-TYQWH6XH.js";
+import {
+  ContextSummaryModelRequiredError,
+  ContextWindowManager,
+  DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO,
+  DEFAULT_CONTEXT_LIMITS,
+  DEFAULT_SUMMARY_MAX_INPUT_TOKENS,
+  DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS,
+  DEFAULT_TOOL_CONTEXT_PRUNE_POLICY,
+  canGenerateCompactionSummary,
+  createCompactionEffectiveness,
+  createCompactionSummaryContent,
+  decideContextCompaction,
+  extractCompactionSummaryText,
+  generateSplitTurnSummary,
+  generateSummary,
+  getAutoCompactTokenLimit,
+  getEffectiveContextWindow,
+  getUsableTokenLimit,
+  isContextOverflowing,
+  planCompactionCut,
+  pruneContext,
+  pruneToolContext,
+  pruneToolContextWithReport,
+  redactSummaryText,
+  resolveContextSummaryPolicy,
+  resolveSummaryOutputTokens,
+  serializeMessagesForSummary,
+  shouldFallbackOnSummaryFailure,
+  shouldPruneContext
+} from "../chunk-DYZGHHDB.js";
+import {
+  AGENT_CONTEXT_FRAGMENT_CLOSE,
+  AGENT_CONTEXT_FRAGMENT_OPEN,
+  AGENT_CONTEXT_FRAGMENT_TAG,
+  applyAgentContextFragments,
+  applyAgentContextFragmentsWithReport,
+  createAgentContextFragmentMessage,
+  estimateConversationTokens,
+  estimateMessageTokens,
+  estimateTokens,
+  getAgentContextFragmentMetadata,
+  isAgentContextFragmentMessage,
+  isRenderedAgentContextFragment,
+  normalizeAgentContextFragment,
+  parseRenderedAgentContextFragment,
+  renderAgentContextFragment
+} from "../chunk-CGP6UNCQ.js";
+export {
+  AGENT_CONTEXT_FRAGMENT_CLOSE,
+  AGENT_CONTEXT_FRAGMENT_OPEN,
+  AGENT_CONTEXT_FRAGMENT_TAG,
+  ContextSummaryModelRequiredError,
+  ContextWindowManager,
+  DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO,
+  DEFAULT_CONTEXT_LIMITS,
+  DEFAULT_SUMMARY_MAX_INPUT_TOKENS,
+  DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS,
+  DEFAULT_TOOL_CONTEXT_PRUNE_POLICY,
+  applyAgentContextFragments,
+  applyAgentContextFragmentsWithReport,
+  assembleModelContext,
+  canGenerateCompactionSummary,
+  createAgentContextFragmentMessage,
+  createCompactionEffectiveness,
+  createCompactionSummaryContent,
+  decideContextCompaction,
+  estimateConversationTokens,
+  estimateMessageTokens,
+  estimateTokens,
+  extractCompactionSummaryText,
+  generateSplitTurnSummary,
+  generateSummary,
+  getAgentContextFragmentMetadata,
+  getAutoCompactTokenLimit,
+  getEffectiveContextWindow,
+  getUsableTokenLimit,
+  isAgentContextFragmentMessage,
+  isContextOverflowing,
+  isRenderedAgentContextFragment,
+  normalizeAgentContextFragment,
+  parseRenderedAgentContextFragment,
+  planCompactionCut,
+  pruneContext,
+  pruneToolContext,
+  pruneToolContextWithReport,
+  redactSummaryText,
+  renderAgentContextFragment,
+  resolveContextSummaryPolicy,
+  resolveSummaryOutputTokens,
+  serializeMessagesForSummary,
+  shouldFallbackOnSummaryFailure,
+  shouldPruneContext
+};

package/dist/context/text/truncation.d.ts

@@ -0,0 +1,13 @@
+export type TextTruncationBoundary = "semantic" | "word" | "grapheme";
+export interface PrefixTruncationOptions {
+    boundary?: TextTruncationBoundary;
+    marker?: string;
+    separator?: string;
+}
+export interface MiddleTruncationOptions {
+    headRatio?: number;
+    marker?: (omittedChars: number) => string;
+}
+export declare function truncateTextPrefix(text: string, maxChars: number | undefined, options?: PrefixTruncationOptions): string;
+export declare function truncateTextMiddle(text: string, maxChars: number | undefined, options?: MiddleTruncationOptions): string;
+//# sourceMappingURL=truncation.d.ts.map

package/dist/context/text/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../../src/context/text/truncation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAwKD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAcR;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAoCR"}

package/dist/context/window/budget.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Context window budgets.
+ *
+ * Centralizes the token formulas used by overflow detection, pruning, and
+ * summary generation. Keeping these formulas together makes it harder for the
+ * chat loop, Dapr workflow, and direct window-manager paths to drift.
+ */
+import type { CompactionEffectiveness } from "../../types/compaction.js";
+/**
+ * Context limits configuration.
+ *
+ * All values are in estimated tokens.
+ */
+export interface ContextLimits {
+    /** Maximum context window size in tokens */
+    contextWindow: number;
+    /**
+     * Percentage of the context window considered usable for model input.
+     *
+     * This is a coarse safety margin for provider overhead, system prompts, tool
+     * schemas, and tokenizer-estimation error. It is combined with
+     * `reserveTokens`; the smaller limit wins.
+     */
+    effectiveContextWindowPercent?: number;
+    /**
+     * Token threshold that triggers automatic compaction.
+     *
+     * When unset, automatic compaction triggers at the usable token limit. When
+     * set, it is clamped to the usable limit so a configured threshold cannot
+     * exceed the model-safe input budget.
+     */
+    autoCompactTokenLimit?: number;
+    /** Reserve tokens for output generation */
+    reserveTokens: number;
+    /** Protect this many recent tokens from pruning */
+    protectedTokens: number;
+    /** Minimum tokens to trigger pruning (avoid pruning tiny contexts) */
+    pruneMinimum: number;
+}
+/**
+ * Default context limits.
+ * Based on typical 128 k context-window models.
+ */
+export declare const DEFAULT_CONTEXT_LIMITS: ContextLimits;
+/**
+ * Default summary output cap.
+ *
+ * This is intentionally conservative. Larger summaries can be enabled by
+ * configuration, but they are still clamped by the reserved output budget.
+ */
+export declare const DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS = 2000;
+/**
+ * Default cap for the serialized transcript sent to the summary model.
+ *
+ * This bounds compaction's own prompt independently from the main model's
+ * context window. It is intentionally generous enough to preserve useful
+ * technical detail while preventing old tool context from making the summary
+ * request fail.
+ */
+export declare const DEFAULT_SUMMARY_MAX_INPUT_TOKENS = 24000;
+/**
+ * Minimum proportional savings before a compaction pass is considered
+ * effective.
+ */
+export declare const DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO = 0.02;
+/**
+ * Compute the usable token budget: the context window minus reserved output
+ * tokens.
+ *
+ * This is the single formula for the safe input threshold used by overflow
+ * detection, auto-compaction event emission, and step-processing limits.
+ */
+export declare function getUsableTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens" | "effectiveContextWindowPercent">): number;
+/**
+ * Compute the safety-adjusted context window before output-token reservation.
+ */
+export declare function getEffectiveContextWindow(limits: Pick<ContextLimits, "contextWindow" | "effectiveContextWindowPercent">): number;
+/**
+ * Resolve the threshold that starts automatic compaction.
+ *
+ * This is intentionally separate from the usable limit: callers can compact
+ * before the hard input budget is exhausted, but never after it.
+ */
+export declare function getAutoCompactTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens" | "effectiveContextWindowPercent" | "autoCompactTokenLimit">): number;
+/**
+ * Check whether the context is overflowing.
+ *
+ * @param tokens - Current estimated token count
+ * @param limits - Context limits (defaults to 128 k window)
+ * @returns `true` if context exceeds context window minus reserve
+ */
+export declare function isContextOverflowing(tokens: number, limits?: ContextLimits): boolean;
+/**
+ * Check whether pruning should be triggered.
+ *
+ * Returns `false` when the conversation is still small enough that pruning
+ * would be wasteful (below `pruneMinimum`).
+ */
+export declare function shouldPruneContext(tokens: number, limits?: ContextLimits): boolean;
+/**
+ * Build the shared compaction-effectiveness report used by direct and durable
+ * runtimes.
+ */
+export declare function createCompactionEffectiveness(tokensBefore: number, tokensAfter: number, minSavingsRatio?: number): CompactionEffectiveness;
+export interface SummaryOutputBudgetOptions {
+    /** Estimated tokens in the messages being summarized. */
+    inputTokens: number;
+    /** Context limits for the active model. */
+    limits?: ContextLimits;
+    /**
+     * Maximum tokens the compaction summary is allowed to request.
+     *
+     * Use this as the model output cap when the provider does not expose one
+     * through the model object.
+     */
+    summaryMaxOutputTokens?: number;
+    /**
+     * Optional proportional target based on the removed content size.
+     *
+     * When unset, the resolver returns the configured cap. When set, the
+     * computed target is clamped to the configured cap and the reserved output
+     * budget.
+     */
+    summaryTargetRatio?: number;
+}
+/**
+ * Resolve the max output tokens for a compaction summary.
+ *
+ * The resolver has two safety caps:
+ * - explicit `summaryMaxOutputTokens`, defaulting to 2,000
+ * - 80% of `reserveTokens`, so summary generation cannot consume the full
+ *   output reserve needed by the next model response
+ */
+export declare function resolveSummaryOutputTokens(options: SummaryOutputBudgetOptions): number;
+//# sourceMappingURL=budget.d.ts.map

package/dist/context/window/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/context/window/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AAmBF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,8CAA8C,OAAO,CAAC;AAMnE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CACV,aAAa,EACb,eAAe,GAAG,eAAe,GAAG,+BAA+B,CACpE,GACA,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CACV,aAAa,EACb,eAAe,GAAG,+BAA+B,CAClD,GACA,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CACV,aAAa,EACX,eAAe,GACf,eAAe,GACf,+BAA+B,GAC/B,uBAAuB,CAC1B,GACA,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAGT;AAWD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,MAAuD,GACvE,uBAAuB,CAiBzB;AAMD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAgBR"}