@cuylabs/agent-core 4.8.1 → 4.10.0

package/dist/{chunk-UMIVJDEJ.js → chunk-SAWRDGBE.js}

@@ -554,6 +554,35 @@ function describeFetchTarget(input, init) {
 }
 
 // src/mcp/auth.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readOptionalString(data, key) {
+  const value = data[key];
+  return typeof value === "string" ? value : void 0;
+}
+function readOptionalNumber(data, key) {
+  const value = data[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function parseOAuthTokenResponse(data) {
+  if (!isRecord(data)) {
+    throw new Error("ClientCredentialsProvider: token response was not JSON.");
+  }
+  const accessToken = readOptionalString(data, "access_token");
+  if (!accessToken) {
+    throw new Error(
+      'ClientCredentialsProvider: token response missing "access_token".'
+    );
+  }
+  return {
+    access_token: accessToken,
+    token_type: readOptionalString(data, "token_type") ?? "bearer",
+    expires_in: readOptionalNumber(data, "expires_in"),
+    scope: readOptionalString(data, "scope"),
+    refresh_token: readOptionalString(data, "refresh_token")
+  };
+}
 var ClientCredentialsProvider = class {
   _tokens;
   _expiresAt;
@@ -658,13 +687,7 @@ var ClientCredentialsProvider = class {
       );
     }
     const json = await response.json();
-    const tokens = {
-      access_token: String(json.access_token),
-      token_type: String(json.token_type ?? "bearer"),
-      expires_in: typeof json.expires_in === "number" ? json.expires_in : void 0,
-      scope: typeof json.scope === "string" ? json.scope : void 0,
-      refresh_token: typeof json.refresh_token === "string" ? json.refresh_token : void 0
-    };
+    const tokens = parseOAuthTokenResponse(json);
     await this.saveTokens(tokens);
     return tokens;
   }

package/dist/{chunk-GEBFHREI.js → chunk-TU5KDFWI.js}

@@ -1,7 +1,6 @@
 import {
-  DEFAULT_AGENT_NAME,
   isBlockedModelCall
-} from "./chunk-CJI7PVS2.js";
+} from "./chunk-W6LWIMIX.js";
 import {
   extractModelId,
   extractProvider
@@ -199,6 +198,29 @@ var MiddlewareRunner = class {
     return sections;
   }
   // --------------------------------------------------------------------------
+  // contextFragments — array order, transient model-visible context
+  // --------------------------------------------------------------------------
+  async collectContextFragments(ctx) {
+    const contextFragments = [];
+    for (const mw of this.stack) {
+      if (!mw.contextFragments) continue;
+      try {
+        const result = await mw.contextFragments(ctx);
+        if (!result) continue;
+        if (Array.isArray(result)) {
+          contextFragments.push(...result);
+        } else {
+          contextFragments.push(result);
+        }
+      } catch (err) {
+        this.log.warn(
+          `"${mw.name}" contextFragments error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    return contextFragments;
+  }
+  // --------------------------------------------------------------------------
   // onEvent — fire-and-forget, all run
   // --------------------------------------------------------------------------
   /**
@@ -212,7 +234,10 @@ var MiddlewareRunner = class {
       if (!mw.onEvent) continue;
       try {
         mw.onEvent(event);
-      } catch {
+      } catch (err) {
+        this.log.warn(
+          `"${mw.name}" onEvent error: ${err instanceof Error ? err.message : String(err)}`
+        );
       }
     }
   }
@@ -375,6 +400,7 @@ function safeJsonStringify(value) {
   }
 }
 var A365_MESSAGE_SCHEMA_VERSION = "0.1.0";
+var DEFAULT_TELEMETRY_AGENT_NAME = "agent";
 function createInputMessagesAttribute(content) {
   return JSON.stringify({
     version: A365_MESSAGE_SCHEMA_VERSION,
@@ -421,7 +447,7 @@ function scheduleSpanTimeout(options) {
 function otelMiddleware(config = {}) {
   const recordInputs = config.recordInputs ?? true;
   const recordOutputs = config.recordOutputs ?? true;
-  const agentName = config.agentName ?? DEFAULT_AGENT_NAME;
+  const agentName = config.agentName ?? DEFAULT_TELEMETRY_AGENT_NAME;
   const emitToolSpans = config.emitToolSpans ?? true;
   const spanTimeoutMs = config.spanTimeoutMs ?? 5 * 60 * 1e3;
   const configuredSpanAttributes = config.spanAttributes ?? {};
@@ -776,7 +802,6 @@ async function createAndRegisterProvider(spanProcessor, serviceName) {
   ]);
   const provider = new NodeTracerProvider({
     resource: resourceFromAttributes({ [ATTR_SERVICE_NAME]: serviceName }),
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     spanProcessors: [spanProcessor]
   });
   provider.register();

package/dist/{chunk-QJV5XPPS.js → chunk-UEEHZ4QH.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SZ2XBPTW.js";
 import {
   Tool
-} from "./chunk-Q742PSH3.js";
+} from "./chunk-MJML3A2F.js";
 import {
   extractApprovalPatterns,
   matchApprovalPattern,

package/dist/chunk-UG5PVNZV.js

@@ -0,0 +1,53 @@
+// src/events/signal/local.ts
+var LocalSignal = class {
+  /** type → Set<handler> for typed subscriptions */
+  typed = /* @__PURE__ */ new Map();
+  /** handlers that receive every event */
+  wildcard = /* @__PURE__ */ new Set();
+  on(type, handler) {
+    let set = this.typed.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.typed.set(type, set);
+    }
+    const wrapped = (event) => {
+      handler(event);
+    };
+    set.add(wrapped);
+    return () => {
+      set.delete(wrapped);
+      if (set.size === 0) this.typed.delete(type);
+    };
+  }
+  onAny(handler) {
+    this.wildcard.add(handler);
+    return () => {
+      this.wildcard.delete(handler);
+    };
+  }
+  emit(event) {
+    const set = this.typed.get(event.type);
+    if (set) {
+      for (const fn of set) {
+        try {
+          fn(event);
+        } catch {
+        }
+      }
+    }
+    for (const fn of this.wildcard) {
+      try {
+        fn(event);
+      } catch {
+      }
+    }
+  }
+  clear() {
+    this.typed.clear();
+    this.wildcard.clear();
+  }
+};
+
+export {
+  LocalSignal
+};

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-BJC46FIF.js → chunk-V4YQ6MBK.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-TPZ37IWI.js";
 import {
   createLocalDispatchRuntime
-} from "./chunk-HSUPTXNV.js";
+} from "./chunk-EBVSPHXA.js";
 import {
   Tool
-} from "./chunk-Q742PSH3.js";
+} from "./chunk-MJML3A2F.js";
 
 // src/subagents/types.ts
 var DEFAULT_SUBAGENT_CONCURRENCY = 6;

package/dist/{chunk-H3GRHFFG.js → chunk-VMGZKIFT.js}

@@ -1,3 +1,7 @@
+import {
+  createAgentContextFragmentMessage
+} from "./chunk-AAGKWUXR.js";
+
 // src/storage/types.ts
 var STORAGE_VERSION = 1;
 
@@ -34,7 +38,8 @@ function serializeMessage(message) {
     id: message.id,
     role: message.role,
     content: typeof message.content === "string" ? message.content : JSON.stringify(message.content),
-    createdAt: message.createdAt.toISOString()
+    createdAt: message.createdAt.toISOString(),
+    ...message.contextFragment ? { contextFragment: structuredClone(message.contextFragment) } : {}
   };
   if (message.role === "user" && "system" in message) {
     serialized.system = message.system;
@@ -57,7 +62,8 @@ function serializeMessage(message) {
 function deserializeMessage(serialized) {
   const base = {
     id: serialized.id,
-    createdAt: new Date(serialized.createdAt)
+    createdAt: new Date(serialized.createdAt),
+    ...serialized.contextFragment ? { contextFragment: structuredClone(serialized.contextFragment) } : {}
   };
   switch (serialized.role) {
     case "user":
@@ -129,7 +135,7 @@ function extractSessionInfo(entries, path) {
     lastTimestamp = entry.timestamp;
     if (entry.type === "message") {
       messageCount++;
-      if (!firstMessage && entry.message.role === "user") {
+      if (!firstMessage && entry.message.role === "user" && !entry.message.contextFragment) {
         firstMessage = entry.message.content.slice(0, 100);
       }
     }
@@ -208,14 +214,16 @@ function buildMessagesFromEntries(entries, leafId) {
     if (entry.type === "compaction") {
       messages.length = 0;
       skipUntilId = entry.firstKeptEntryId !== entry.id ? entry.firstKeptEntryId : void 0;
-      messages.push({
-        id: entry.id,
-        role: "system",
-        content: `## Previous Conversation Summary
+      if (entry.displaySummary !== false) {
+        messages.push({
+          id: entry.id,
+          role: "system",
+          content: `## Previous Conversation Summary
 
 ${entry.summary}`,
-        createdAt: new Date(entry.timestamp)
-      });
+          createdAt: new Date(entry.timestamp)
+        });
+      }
       continue;
     }
     if (skipUntilId && entry.id !== skipUntilId) {
@@ -262,6 +270,9 @@ function buildRecentMessagesFromEntryMap(entriesById, leafId, options = {}) {
         recent.push(message);
       }
     } else if (entry.type === "compaction") {
+      if (entry.displaySummary === false) {
+        break;
+      }
       recent.push({
         id: entry.id,
         role: "system",
@@ -767,6 +778,15 @@ var SessionManager = class {
     this.currentLeafId = entries[entries.length - 1].id;
     return entries.map((entry) => entry.id);
   }
+  async addContextFragment(contextFragment) {
+    return this.addMessage(
+      createAgentContextFragmentMessage({
+        lifetime: "session",
+        placement: "before-history",
+        ...contextFragment
+      })
+    );
+  }
   getMessages(leafId) {
     return buildMessagesFromEntries(
       this.entriesCache,
@@ -818,6 +838,7 @@ var SessionManager = class {
       parentId: this.currentLeafId,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       summary: options.summary,
+      ...options.displaySummary === false ? { displaySummary: false } : {},
       firstKeptEntryId: messageEntries[0]?.id ?? compactionId,
       tokensBefore: options.tokensBefore,
       tokensAfter: options.tokensAfter,

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,CAkCrC"}

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

@@ -0,0 +1,60 @@
+import type { Message } from "../../types/messages.js";
+import type { CompactionCutReason, CompactionEffectiveness } 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";
+export type ModelContextCompactionPhase = "pre-step" | "recovery" | "post-turn";
+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;
+    };
+    compaction?: ModelContextCompactionReport;
+}
+export interface ModelContextCompactionReport {
+    applied: boolean;
+    phase: ModelContextCompactionPhase;
+    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,EACxB,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;AAE/D,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhF,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;KAC5D,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,2BAA2B,CAAC;IACnC,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,11 @@
+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.
+     */
+    maxEstimatedFragmentTokens?: number;
+}
+//# 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,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC"}

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,10 @@
+import type { Message } from "../../types/messages.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;
+}): 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;AAOvD,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;IAAE,MAAM,CAAC,EAAE,iCAAiC,CAAA;CAAO,GAC3D,+BAA+B,CA6GjC;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"}