@alvin0/ai-agent-sdk-core 0.1.0

package/dist/agent/accounting/usage.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"../../primitives/freeze.js";import{OBSERVATION_ERROR_CODES as t}from"../../observation/report.js";import{addUsageCounters as n}from"../../observation/usage.js";import{accountingError as r}from"./common.js";const i=[`inputTokens`,`outputTokens`,`totalTokens`,`cacheReadTokens`,`cacheWriteTokens`,`reasoningTokens`];function a(n,i){let a={logicalCalls:n.length,attempts:n.reduce((e,t)=>e+t.attempts.length,0),complete:n.filter(e=>e.coverage===`complete`).length,partial:n.filter(e=>e.coverage===`partial`).length,estimated:n.filter(e=>e.coverage===`estimated`).length,missing:n.filter(e=>e.coverage===`missing`).length,notApplicable:n.filter(e=>e.coverage===`not-applicable`).length,possiblyBilledAttemptsWithoutUsage:n.reduce((e,t)=>p(e,t.possiblyBilledAttemptsWithoutUsage).value,0)};if(n.length===0)return e({reported:{inputTokens:0,outputTokens:0,totalTokens:0},coverage:a,authoritative:!0});let o=u(n.map(e=>e.reported),i),s=n.flatMap(e=>e.estimated===void 0?[]:[e.estimated]),l=s.length===0?void 0:u(s,i),d;for(let e of n){let n;for(let a of e.attempts){if(a.dispatchState===`not-sent`)continue;let e=c({...a,authoritative:a.coverage===`complete`});if(e===void 0)continue;let o=p(n??0,e);n=o.value,o.overflow&&i.push(r(`attempt usage budget saturated at Number.MAX_SAFE_INTEGER`,t.USAGE_COUNTER_OVERFLOW))}let a=c(e),o=a===void 0?n:Math.max(a,n??0);if(o===void 0)continue;let s=p(d??0,o);d=s.value,s.overflow&&i.push(r(`usage budget saturated at Number.MAX_SAFE_INTEGER`,t.USAGE_COUNTER_OVERFLOW))}let f=n.every(e=>e.authoritative)&&!i.some(e=>e.code===t.USAGE_COUNTER_OVERFLOW||e.code===t.USAGE_INVALID);return e({reported:o,...l===void 0?{}:{estimated:l},...d===void 0?{}:{budgetTokens:d},coverage:a,authoritative:f})}function o(e){return a(e,[])}function s(e){if(!e.authoritative)return;let t=e.reported.inputTokens,n=e.reported.outputTokens;if(t!==void 0&&n!==void 0)return Object.freeze({inputTokens:t,outputTokens:n,...e.reported.totalTokens===void 0?{}:{totalTokens:e.reported.totalTokens},...e.reported.cacheReadTokens===void 0?{}:{cacheReadTokens:e.reported.cacheReadTokens},...e.reported.cacheWriteTokens===void 0?{}:{cacheWriteTokens:e.reported.cacheWriteTokens},...e.reported.reasoningTokens===void 0?{}:{reasoningTokens:e.reported.reasoningTokens}})}function c(e){if(e.budgetTokens!==void 0)return e.budgetTokens;if(e.authoritative)return e.reported.totalTokens??d(e.reported);let t=d(Object.freeze({...l(e,`inputTokens`),...l(e,`cacheReadTokens`),...l(e,`cacheWriteTokens`),...l(e,`outputTokens`)}));return t===void 0?e.reported.totalTokens??e.estimated?.totalTokens:Math.max(t,e.reported.totalTokens??e.estimated?.totalTokens??0)}function l(e,t){let n=e.reported[t]??e.estimated?.[t];return n===void 0?{}:{[t]:n}}function u(e,i){let a=n(e);return a.overflow&&i.push(r(`usage aggregation saturated at Number.MAX_SAFE_INTEGER`,t.USAGE_COUNTER_OVERFLOW)),a.counters}function d(e){let t=[e.inputTokens,e.cacheReadTokens,e.cacheWriteTokens,e.outputTokens];if(t.every(e=>e===void 0))return;let n=0;for(let e of t)n=p(n,e??0).value;return n}function f(e,t){let n={};for(let r of i)t[r]===void 0&&e[r]!==void 0&&(n[r]=e[r]);return Object.freeze({...n})}function p(e,t){let n=e+t;return Number.isSafeInteger(n)?{value:n,overflow:!1}:{value:2**53-1,overflow:!0}}export{i as COUNTER_KEYS,u as aggregateCounterSets,a as aggregateUsage,s as authoritativeTokenUsage,c as budgetTokenTotal,l as counterValue,d as disjointTotal,f as missingCounters,p as saturating,o as summarizeModelCallUsage};
+//# sourceMappingURL=usage.js.map

package/dist/agent/accounting/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","names":[],"sources":["../../../src/agent/accounting/usage.ts"],"sourcesContent":["import {\n  OBSERVATION_ERROR_CODES, addUsageCounters, type ModelCallReport, type SafeErrorRecord,\n  type UsageCounters,\n} from '../../observation/index.ts'\nimport { deepFreeze } from '../../primitives/index.ts'\nimport type { RunUsageReport } from './report.ts'\nimport type { TokenUsage } from '../../stream/index.ts'\nimport { accountingError } from './common.ts'\n\nexport const COUNTER_KEYS = [\n  'inputTokens', 'outputTokens', 'totalTokens', 'cacheReadTokens',\n  'cacheWriteTokens', 'reasoningTokens',\n] as const satisfies readonly (keyof UsageCounters)[]\n\nexport function aggregateUsage(reports: readonly ModelCallReport[], errors: SafeErrorRecord[]): RunUsageReport {\n  const coverage = {\n    logicalCalls: reports.length,\n    attempts: reports.reduce((total, report) => total + report.attempts.length, 0),\n    complete: reports.filter(report => report.coverage === 'complete').length,\n    partial: reports.filter(report => report.coverage === 'partial').length,\n    estimated: reports.filter(report => report.coverage === 'estimated').length,\n    missing: reports.filter(report => report.coverage === 'missing').length,\n    notApplicable: reports.filter(report => report.coverage === 'not-applicable').length,\n    possiblyBilledAttemptsWithoutUsage: reports.reduce(\n      (total, report) => saturating(total, report.possiblyBilledAttemptsWithoutUsage).value,\n      0,\n    ),\n  }\n  if (reports.length === 0) {\n    return deepFreeze({\n      reported: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },\n      coverage,\n      authoritative: true,\n    })\n  }\n  const reported = aggregateCounterSets(reports.map(report => report.reported), errors)\n  const estimatedValues = reports.flatMap(report => report.estimated === undefined ? [] : [report.estimated])\n  const estimated = estimatedValues.length === 0 ? undefined : aggregateCounterSets(estimatedValues, errors)\n  let budgetTokens: number | undefined\n  for (const report of reports) {\n    // Aggregate counters can omit incomparable totals. The attempt evidence\n    // still owns those known costs, without charging call + attempts twice.\n    let attemptTokens: number | undefined\n    for (const attempt of report.attempts) {\n      if (attempt.dispatchState === 'not-sent') continue\n      const tokens = budgetTokenTotal({ ...attempt, authoritative: attempt.coverage === 'complete' })\n      if (tokens === undefined) continue\n      const sum = saturating(attemptTokens ?? 0, tokens)\n      attemptTokens = sum.value\n      if (sum.overflow) errors.push(accountingError(\n        'attempt usage budget saturated at Number.MAX_SAFE_INTEGER',\n        OBSERVATION_ERROR_CODES.USAGE_COUNTER_OVERFLOW,\n      ))\n    }\n    const logicalTokens = budgetTokenTotal(report)\n    const contribution = logicalTokens === undefined ? attemptTokens\n      : Math.max(logicalTokens, attemptTokens ?? 0)\n    if (contribution === undefined) continue\n    const sum = saturating(budgetTokens ?? 0, contribution)\n    budgetTokens = sum.value\n    if (sum.overflow) errors.push(accountingError(\n      'usage budget saturated at Number.MAX_SAFE_INTEGER',\n      OBSERVATION_ERROR_CODES.USAGE_COUNTER_OVERFLOW,\n    ))\n  }\n  const authoritative = reports.every(report => report.authoritative)\n    && !errors.some(error => error.code === OBSERVATION_ERROR_CODES.USAGE_COUNTER_OVERFLOW\n      || error.code === OBSERVATION_ERROR_CODES.USAGE_INVALID)\n  return deepFreeze({\n    reported,\n    ...(estimated === undefined ? {} : { estimated }),\n    ...(budgetTokens === undefined ? {} : { budgetTokens }),\n    coverage,\n    authoritative,\n  })\n}\n\n/** Deterministic public projection used by turn outcomes and the canonical ledger. */\nexport function summarizeModelCallUsage(reports: readonly ModelCallReport[]): RunUsageReport {\n  return aggregateUsage(reports, [])\n}\n\n/** Legacy exact usage exists only when every logical call is authoritative. */\nexport function authoritativeTokenUsage(report: RunUsageReport): TokenUsage | undefined {\n  if (!report.authoritative) return undefined\n  const inputTokens = report.reported.inputTokens\n  const outputTokens = report.reported.outputTokens\n  if (inputTokens === undefined || outputTokens === undefined) return undefined\n  return Object.freeze({\n    inputTokens,\n    outputTokens,\n    ...(report.reported.totalTokens === undefined ? {} : { totalTokens: report.reported.totalTokens }),\n    ...(report.reported.cacheReadTokens === undefined ? {} : { cacheReadTokens: report.reported.cacheReadTokens }),\n    ...(report.reported.cacheWriteTokens === undefined ? {} : { cacheWriteTokens: report.reported.cacheWriteTokens }),\n    ...(report.reported.reasoningTokens === undefined ? {} : { reasoningTokens: report.reported.reasoningTokens }),\n  })\n}\n\n/** Budget projection: reported buckets plus estimates only where reporting is absent. */\nexport function budgetTokenTotal(report: Pick<RunUsageReport, 'reported' | 'estimated' | 'authoritative' | 'budgetTokens'>): number | undefined {\n  if (report.budgetTokens !== undefined) return report.budgetTokens\n  if (report.authoritative) return report.reported.totalTokens ?? disjointTotal(report.reported)\n  const combined: UsageCounters = Object.freeze({\n    ...counterValue(report, 'inputTokens'),\n    ...counterValue(report, 'cacheReadTokens'),\n    ...counterValue(report, 'cacheWriteTokens'),\n    ...counterValue(report, 'outputTokens'),\n  })\n  const bucketTotal = disjointTotal(combined)\n  if (bucketTotal !== undefined) return Math.max(\n    bucketTotal, report.reported.totalTokens ?? report.estimated?.totalTokens ?? 0,\n  )\n  return report.reported.totalTokens ?? report.estimated?.totalTokens\n}\n\nexport function counterValue(\n  report: Pick<RunUsageReport, 'reported' | 'estimated'>,\n  key: 'inputTokens' | 'cacheReadTokens' | 'cacheWriteTokens' | 'outputTokens',\n): Partial<Record<typeof key, number>> {\n  const value = report.reported[key] ?? report.estimated?.[key]\n  return value === undefined ? {} : { [key]: value }\n}\n\nexport function aggregateCounterSets(values: readonly UsageCounters[], errors: SafeErrorRecord[]): UsageCounters {\n  // A prior aggregation may contain input/output from different subsets.\n  // Only the provider normalization boundary may derive an exact total.\n  const result = addUsageCounters(values)\n  if (result.overflow) errors.push(accountingError(\n    'usage aggregation saturated at Number.MAX_SAFE_INTEGER',\n    OBSERVATION_ERROR_CODES.USAGE_COUNTER_OVERFLOW,\n  ))\n  return result.counters\n}\n\nexport function disjointTotal(value: UsageCounters): number | undefined {\n  const parts = [value.inputTokens, value.cacheReadTokens, value.cacheWriteTokens, value.outputTokens]\n  if (parts.every(part => part === undefined)) return undefined\n  let total = 0\n  for (const part of parts) total = saturating(total, part ?? 0).value\n  return total\n}\n\nexport function missingCounters(estimated: UsageCounters, reported: UsageCounters): UsageCounters {\n  const output: Partial<Record<keyof UsageCounters, number>> = {}\n  for (const key of COUNTER_KEYS) {\n    if (reported[key] === undefined && estimated[key] !== undefined) output[key] = estimated[key]\n  }\n  return Object.freeze({ ...output })\n}\n\nexport function saturating(left: number, right: number): { value: number; overflow: boolean } {\n  const total = left + right\n  return !Number.isSafeInteger(total)\n    ? { value: Number.MAX_SAFE_INTEGER, overflow: true }\n    : { value: total, overflow: false }\n}\n"],"mappings":"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"}

package/dist/agent/context/section.d.ts

@@ -0,0 +1,15 @@
+import { ContextSection } from "./types.js";
+//#region src/agent/context/section.d.ts
+declare const CONTEXT_SECTION_ID_PATTERN: RegExp;
+declare const CONTEXT_SECTION_INVALID = "CONTEXT_SECTION_INVALID";
+/** Ceiling for one section's rendered text. A section budgets its own content below this. */
+declare const MAX_CONTEXT_SECTION_TEXT_BYTES = 262144;
+/**
+ * Capture one section after checking the parts the loop depends on.
+ * @param input - the authored section.
+ * @returns a frozen section with its `resolve` bound to the authored object.
+ */
+declare function defineContextSection(input: ContextSection): ContextSection;
+//#endregion
+export { CONTEXT_SECTION_ID_PATTERN, CONTEXT_SECTION_INVALID, MAX_CONTEXT_SECTION_TEXT_BYTES, defineContextSection };
+//# sourceMappingURL=section.d.ts.map

package/dist/agent/context/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","names":[],"sources":["../../../src/agent/context/section.ts"],"mappings":";;cAea,4BAA0B;cAC1B;;cAEA;;;;;;iBAaG,qBAAqB,OAAO,iBAAiB"}

package/dist/agent/context/section.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../../errors/agent-sdk-error.js";import{createUserMessage as t}from"../../message/message.js";const n=/^[a-z0-9]+(?:-[a-z0-9]+)*$/,r=`CONTEXT_SECTION_INVALID`,i=262144,a=`context-section:`;function o(e){return new TextEncoder().encode(e).byteLength}function s(t){if(typeof t.id!=`string`||!n.test(t.id))throw new e(`context section id must be kebab-case, received '${String(t.id)}'`,r);if(typeof t.resolve!=`function`)throw new e(`context section '${t.id}' must supply resolve()`,r);let i=t.resolve.bind(t);return Object.freeze({id:t.id,resolve:i,...t.retractionText===void 0?{}:{retractionText:t.retractionText}})}function c(t){if(t===void 0)return;let n=new Set,i=t.map(t=>{let i=s(t);if(n.has(i.id))throw new e(`duplicate context section '${i.id}'`,r);return n.add(i.id),i});return Object.freeze(i)}function l(e){return e.retractionText??`The previously provided '${e.id}' context no longer applies.`}var u=class{sections;history;logger;guard;maxTextBytes;scope;live=new Map;adopted=new Set;constructor(e){this.sections=e.sections,this.history=e.history,this.logger=e.logger,this.guard=e.guard??(e=>e),this.maxTextBytes=e.maxTextBytes??262144,this.scope=Object.freeze(e.scope??{agentId:void 0,conversationId:void 0})}async reconcile(e,t,n){for(let r of this.sections){if(n.aborted)return;let i=this.resync(r.id),a={signal:n,step:e,touches:t,scope:this.scope,current:i===void 0||i.retracted||i.revision===void 0?void 0:{revision:i.revision,text:i.text}},s;try{s=await this.guard(Promise.resolve().then(()=>r.resolve(a)),`context-section:${r.id}`)}catch(e){this.logger?.warn(`context section resolve failed`,{section:r.id,error:e instanceof Error?e.message:String(e)});continue}if(s===void 0){i!==void 0&&!i.retracted&&this.write(r,l(r),void 0,!0,i.seq);continue}if(typeof s.revision!=`string`||typeof s.text!=`string`){this.logger?.warn(`context section returned an invalid state`,{section:r.id});continue}if(i!==void 0&&!i.retracted){if(i.revision===s.revision)continue;if(i.text===s.text){this.live.set(r.id,{...i,revision:s.revision});continue}}let c=o(s.text);if(c>this.maxTextBytes){this.logger?.warn(`context section exceeded its byte ceiling`,{section:r.id,bytes:c,maxTextBytes:this.maxTextBytes});continue}this.write(r,s.text,s.revision,!1,i?.seq)}}resync(e){let t=this.live.get(e),n=this.history.generation();if(this.adopted.has(e)&&t?.generation===n)return t;this.adopted.add(e);let r=`${a}${e}`,i;for(let e of this.history.surface()){if(e.message.source.kind!==`app`||e.message.source.producer!==r)continue;let a=e.message.content.flatMap(e=>e.type===`text`?[e.text]:[]).join(``);i={seq:e.seq,text:a,revision:t?.seq===e.seq?t.revision:void 0,retracted:t?.seq===e.seq&&t.retracted,generation:n}}return i===void 0?this.live.delete(e):this.live.set(e,i),i}write(e,n,r,i,o){let s=t({source:{kind:`app`,producer:`${a}${e.id}`},content:[{type:`text`,text:n}]});if(o!==void 0)try{let t=this.history.append({kind:`user`,message:s},{op:`replace`,from:o,to:o,targets:[o]}).seq;this.live.set(e.id,{seq:t,text:n,revision:r,retracted:i,generation:this.history.generation()});return}catch{this.live.delete(e.id)}let c=this.history.append({kind:`user`,message:s}).seq;this.live.set(e.id,{seq:c,text:n,revision:r,retracted:i,generation:this.history.generation()})}};export{n as CONTEXT_SECTION_ID_PATTERN,r as CONTEXT_SECTION_INVALID,a as CONTEXT_SECTION_PRODUCER_PREFIX,u as ContextSectionRuntime,i as MAX_CONTEXT_SECTION_TEXT_BYTES,c as captureContextSections,s as defineContextSection};
+//# sourceMappingURL=section.js.map

package/dist/agent/context/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","names":[],"sources":["../../../src/agent/context/section.ts"],"sourcesContent":["/**\n * Validation and the turn-scoped reconciler for {@link ContextSection}.\n *\n * @module ai-agent-sdk/core/agent/context/section\n */\n\nimport { createUserMessage } from '../../message/index.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport type { SdkLogger } from '../../logging/types.ts'\nimport type { History } from '../history/history.ts'\nimport type {\n  ContextSection, ContextSectionResolveInput, ContextSectionScope, ContextSectionState,\n  ContextToolTouch,\n} from './types.ts'\n\nexport const CONTEXT_SECTION_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\nexport const CONTEXT_SECTION_INVALID = 'CONTEXT_SECTION_INVALID'\n/** Ceiling for one section's rendered text. A section budgets its own content below this. */\nexport const MAX_CONTEXT_SECTION_TEXT_BYTES = 262_144\n/** Message-source producer prefix that identifies a section's own surface node. */\nexport const CONTEXT_SECTION_PRODUCER_PREFIX = 'context-section:'\n\nfunction byteLength(value: string): number {\n  return new TextEncoder().encode(value).byteLength\n}\n\n/**\n * Capture one section after checking the parts the loop depends on.\n * @param input - the authored section.\n * @returns a frozen section with its `resolve` bound to the authored object.\n */\nexport function defineContextSection(input: ContextSection): ContextSection {\n  if (typeof input.id !== 'string' || !CONTEXT_SECTION_ID_PATTERN.test(input.id)) {\n    throw new AgentSdkError(\n      `context section id must be kebab-case, received '${String(input.id)}'`,\n      CONTEXT_SECTION_INVALID,\n    )\n  }\n  if (typeof input.resolve !== 'function') {\n    throw new AgentSdkError(`context section '${input.id}' must supply resolve()`, CONTEXT_SECTION_INVALID)\n  }\n  const resolve = input.resolve.bind(input)\n  return Object.freeze({\n    id: input.id,\n    resolve,\n    ...input.retractionText === undefined ? {} : { retractionText: input.retractionText },\n  })\n}\n\n/**\n * Reject duplicate ids once, at assembly, rather than per step.\n * @param sections - authored sections in surface order.\n * @returns the frozen, validated list.\n */\nexport function captureContextSections(\n  sections: readonly ContextSection[] | undefined,\n): readonly ContextSection[] | undefined {\n  if (sections === undefined) return undefined\n  const seen = new Set<string>()\n  const captured = sections.map(section => {\n    const validated = defineContextSection(section)\n    if (seen.has(validated.id)) {\n      throw new AgentSdkError(`duplicate context section '${validated.id}'`, CONTEXT_SECTION_INVALID)\n    }\n    seen.add(validated.id)\n    return validated\n  })\n  return Object.freeze(captured)\n}\n\nfunction retraction(section: ContextSection): string {\n  return section.retractionText\n    ?? `The previously provided '${section.id}' context no longer applies.`\n}\n\n/**\n * What one section currently has on the model surface.\n *\n * `revision` is absent for a node adopted from an earlier turn: the text is\n * known, its producer's revision key is not, so the first comparison of that\n * turn falls back to comparing the text itself.\n */\ninterface LiveNode {\n  readonly seq: number\n  readonly text: string\n  readonly revision: string | undefined\n  /** True once the node holds a retraction notice rather than section content. */\n  readonly retracted: boolean\n  /** History replacement generation when this node was written or adopted. */\n  readonly generation: number\n}\n\nexport interface ContextSectionRuntimeOptions {\n  readonly sections: readonly ContextSection[]\n  readonly history: History\n  readonly logger?: SdkLogger\n  /** Bounds one resolve the same way a turn hook is bounded. */\n  readonly guard?: <T>(pending: Promise<T>, name: string) => Promise<T>\n  readonly maxTextBytes?: number\n  /** Conversation identity handed to every resolve. */\n  readonly scope?: ContextSectionScope\n}\n\n/**\n * Keeps each section's single live surface node in step with its content.\n *\n * A failing or over-budget section is skipped for that step with its previous\n * node intact: assembled context is advisory, and losing it must never cost the\n * turn. Every write goes through the same replace-in-place path the tool-budget\n * notice uses, so a section never accumulates stale copies of itself.\n *\n * A runtime lives for one turn, but the surface does not. Before deciding\n * anything, a section whose node may have moved — the first step of a new turn,\n * or any step after a compaction shadowed part of the surface — re-reads the\n * live surface and adopts whatever node it still owns there. Without that, a\n * second turn would append a duplicate copy of context the model can already\n * read, and a compacted-away node would never be rewritten because its revision\n * still matched.\n */\nexport class ContextSectionRuntime {\n  private readonly sections: readonly ContextSection[]\n  private readonly history: History\n  private readonly logger: SdkLogger | undefined\n  private readonly guard: <T>(pending: Promise<T>, name: string) => Promise<T>\n  private readonly maxTextBytes: number\n  private readonly scope: ContextSectionScope\n  private readonly live = new Map<string, LiveNode>()\n  private readonly adopted = new Set<string>()\n\n  constructor(options: ContextSectionRuntimeOptions) {\n    this.sections = options.sections\n    this.history = options.history\n    this.logger = options.logger\n    this.guard = options.guard ?? (pending => pending)\n    this.maxTextBytes = options.maxTextBytes ?? MAX_CONTEXT_SECTION_TEXT_BYTES\n    this.scope = Object.freeze(options.scope ?? { agentId: undefined, conversationId: undefined })\n  }\n\n  /**\n   * Recompute every section and write only what changed.\n   * @param step - 0 before the first model round, then one per completed step.\n   * @param touches - tool calls committed since the previous reconcile.\n   * @param signal - turn cancellation.\n   */\n  async reconcile(\n    step: number,\n    touches: readonly ContextToolTouch[],\n    signal: AbortSignal,\n  ): Promise<void> {\n    for (const section of this.sections) {\n      if (signal.aborted) return\n      const node = this.resync(section.id)\n      const input: ContextSectionResolveInput = {\n        signal,\n        step,\n        touches,\n        scope: this.scope,\n        current: node === undefined || node.retracted || node.revision === undefined\n          ? undefined\n          : { revision: node.revision, text: node.text },\n      }\n      let next: ContextSectionState | undefined\n      try {\n        next = await this.guard(\n          Promise.resolve().then(() => section.resolve(input)),\n          `context-section:${section.id}`,\n        )\n      } catch (error: unknown) {\n        // Advisory context. A section that throws keeps whatever it last wrote\n        // rather than taking the turn down with it.\n        this.logger?.warn('context section resolve failed', {\n          section: section.id,\n          error: error instanceof Error ? error.message : String(error),\n        })\n        continue\n      }\n      if (next === undefined) {\n        // A section that stays retracted must not rewrite the notice on every\n        // step; one notice replaces the content and then stands.\n        if (node !== undefined && !node.retracted) {\n          this.write(section, retraction(section), undefined, true, node.seq)\n        }\n        continue\n      }\n      if (typeof next.revision !== 'string' || typeof next.text !== 'string') {\n        this.logger?.warn('context section returned an invalid state', { section: section.id })\n        continue\n      }\n      if (node !== undefined && !node.retracted) {\n        if (node.revision === next.revision) continue\n        if (node.text === next.text) {\n          // Same text under a new revision key — an adopted node, or a producer\n          // that rekeyed identical content. Record the key; write nothing.\n          this.live.set(section.id, { ...node, revision: next.revision })\n          continue\n        }\n      }\n      const bytes = byteLength(next.text)\n      if (bytes > this.maxTextBytes) {\n        this.logger?.warn('context section exceeded its byte ceiling', {\n          section: section.id, bytes, maxTextBytes: this.maxTextBytes,\n        })\n        continue\n      }\n      this.write(section, next.text, next.revision, false, node?.seq)\n    }\n  }\n\n  /**\n   * Reconcile the tracked node against the surface the model actually reads.\n   * @param id - the section's id.\n   * @returns the live node, or undefined when the section owns none.\n   */\n  private resync(id: string): LiveNode | undefined {\n    const tracked = this.live.get(id)\n    const generation = this.history.generation()\n    if (this.adopted.has(id) && tracked?.generation === generation) return tracked\n    this.adopted.add(id)\n    const producer = `${CONTEXT_SECTION_PRODUCER_PREFIX}${id}`\n    // Last wins: a replace reinserts at the original position, so a section that\n    // somehow owns two nodes keeps the newest and rewrites over it.\n    let found: LiveNode | undefined\n    for (const node of this.history.surface()) {\n      if (node.message.source.kind !== 'app' || node.message.source.producer !== producer) continue\n      const text = node.message.content\n        .flatMap(block => block.type === 'text' ? [block.text] : [])\n        .join('')\n      found = {\n        seq: node.seq,\n        text,\n        // A tracked revision survives only while the node it described is the\n        // one still on the surface.\n        revision: tracked?.seq === node.seq ? tracked.revision : undefined,\n        retracted: tracked?.seq === node.seq ? tracked.retracted : false,\n        generation,\n      }\n    }\n    if (found === undefined) this.live.delete(id)\n    else this.live.set(id, found)\n    return found\n  }\n\n  private write(\n    section: ContextSection,\n    text: string,\n    revision: string | undefined,\n    retracted: boolean,\n    previous: number | undefined,\n  ): void {\n    const message = createUserMessage({\n      source: { kind: 'app', producer: `${CONTEXT_SECTION_PRODUCER_PREFIX}${section.id}` },\n      content: [{ type: 'text', text }],\n    })\n    if (previous !== undefined) {\n      // Replacing is best-effort for the same reason the budget notice is:\n      // compaction can shadow the earlier node between steps, and a replace\n      // whose target left the surface is rejected. Fall through to an append so\n      // the model still reads the current content.\n      try {\n        const seq = this.history.append(\n          { kind: 'user', message },\n          { op: 'replace', from: previous, to: previous, targets: [previous] },\n        ).seq\n        this.live.set(section.id, { seq, text, revision, retracted, generation: this.history.generation() })\n        return\n      } catch {\n        this.live.delete(section.id)\n      }\n    }\n    const seq = this.history.append({ kind: 'user', message }).seq\n    this.live.set(section.id, { seq, text, revision, retracted, generation: this.history.generation() })\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,98 @@
+//#region src/agent/context/types.d.ts
+/**
+ * Turn-scoped model-visible context sections.
+ *
+ * A section owns at most one live node on the model surface and is recomputed
+ * before every model round. Unchanged sections cost nothing: the loop compares
+ * the returned {@link ContextSectionState.revision} against the live node and
+ * writes only on a difference. A changed section *replaces* its own node rather
+ * than appending beside it, so the model never reads two versions of the same
+ * context at once.
+ *
+ * Nothing here touches a filesystem, a clock, or a network. A section is a
+ * pure recompute callback; where its content comes from is the host's concern.
+ *
+ * @module ai-agent-sdk/core/agent/context/types
+ */
+/** What one context section currently wants the model to read. */
+interface ContextSectionState {
+  /**
+   * Change key for this content.
+   *
+   * Equal to the live node's revision means no rewrite and no token cost. Any
+   * other value replaces the live node. A content digest is the usual choice;
+   * a monotonic counter works when the producer already tracks versions.
+   */
+  readonly revision: string;
+  /** Exact model-facing text. The loop never trims, wraps, or rewrites it. */
+  readonly text: string;
+}
+/** One tool call committed since the previous resolve. */
+interface ContextToolTouch {
+  readonly toolName: string;
+  /** Verbatim provider arguments; a section parses only what it recognizes. */
+  readonly rawArguments: string;
+  /** Whether the call ended in a tool failure. */
+  readonly failed: boolean;
+}
+interface ContextSectionResolveInput {
+  readonly signal: AbortSignal;
+  /** 0 before the first model round of the turn, then one per completed step. */
+  readonly step: number;
+  /** Tool calls committed since the previous resolve, in model order. */
+  readonly touches: readonly ContextToolTouch[];
+  /** The state currently on the model surface, when this section has one. */
+  readonly current: ContextSectionState | undefined;
+  /**
+   * Who is asking, so a section instance shared by several agents can keep its
+   * state apart.
+   *
+   * One section object is routinely mounted on a definition that many sessions
+   * instantiate — every member of a team, every worker cloned from a lead — and
+   * those sessions run concurrently. A section that accumulates anything across
+   * steps must key that state by this scope, or one agent's discoveries leak
+   * into another's context. Both fields are absent for a bare `runTurn` that
+   * was given no trace identity.
+   */
+  readonly scope: ContextSectionScope;
+}
+/** Stable identity of the conversation a resolve belongs to. */
+interface ContextSectionScope {
+  readonly agentId: string | undefined;
+  readonly conversationId: string | undefined;
+}
+/**
+ * A recomputed block of model-visible context.
+ *
+ * ```ts
+ * const clock = defineContextSection({
+ *   id: 'wall-clock',
+ *   resolve() {
+ *     const text = `Current time: ${new Date().toISOString()}`
+ *     return { revision: text, text }
+ *   },
+ * })
+ * ```
+ */
+interface ContextSection {
+  /** Kebab-case identity, unique within one turn. */
+  readonly id: string;
+  /**
+   * Recompute this section.
+   *
+   * Return the same revision to leave the surface untouched, a new state to
+   * replace it, or `undefined` to retract the section entirely.
+   */
+  resolve(input: ContextSectionResolveInput): ContextSectionState | undefined | Promise<ContextSectionState | undefined>;
+  /**
+   * Replaces the live node when a section that had one retracts.
+   *
+   * The loop cannot delete a surface node, so a retraction becomes a short
+   * message saying the earlier text no longer applies. Defaults to a generic
+   * line naming the section id.
+   */
+  readonly retractionText?: string;
+}
+//#endregion
+export { ContextSection, ContextSectionResolveInput, ContextSectionScope, ContextSectionState, ContextToolTouch };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/agent/context/types.ts"],"mappings":";;;;;;;;;;;;;;;;;UAiBiB;;;;;;;;WAQN;;WAEA;;;UAIM;WACN;;WAEA;;WAEA;;UAGM;WACN,QAAQ;;WAER;;WAEA,kBAAkB;;WAElB,SAAS;;;;;;;;;;;;WAYT,OAAO;;;UAID;WACN;WACA;;;;;;;;;;;;;;;UAgBM;;WAEN;;;;;;;EAOT,QAAQ,OAAO,6BACb,kCAAkC,QAAQ;;;;;;;;WAQnC"}

package/dist/agent/define/definition.d.ts

@@ -0,0 +1,110 @@
+import { ReasoningEffortId } from "../../primitives/brand.js";
+import { NativeToolSchema, ToolChoice } from "../../contract/tool.js";
+import { ModelOutputFormat } from "../../contract/output-format.js";
+import { ToolDefinition } from "../tool/definition.js";
+import { ContextSection } from "../context/types.js";
+import { AgentMode } from "../mode/run-agent.js";
+import { AgentCompactionConfig, AgentCompactionOptions } from "../memory/compaction-config.js";
+import { AgentMemoryConfig, AgentMemoryConfigInput } from "../memory/memory.js";
+import { SkillSource } from "../skill/definition.js";
+import { AgentSkillOptions, ResolvedAgentSkillOptions } from "../skill/tools.js";
+import { AgentResumeSessionOptions, AgentSessionOptions } from "./session/types.js";
+import { AgentSession } from "./session.js";
+//#region src/agent/define/definition.d.ts
+interface AgentDefinitionInput {
+  /** Stable code-owned identity used by traces and catalogs. */
+  readonly id: string;
+  /** Human-readable display name; defaults to `id`. */
+  readonly name?: string;
+  readonly description?: string;
+  /** Provider route; defaults to `codex`. */
+  readonly provider?: string;
+  /** Provider model id; defaults to `gpt-5.6-luna`. */
+  readonly model?: string;
+  /**
+   * Provider reasoning effort. Omitted means no preference.
+   *
+   * An agent that never asked for a level should not be given one: the value
+   * is validated against the model's own ladder, so an invented default makes
+   * the agent unrunnable on every provider that declares no efforts — and
+   * silently overrides the provider's own default everywhere else.
+   */
+  readonly effort?: string;
+  /** Requested output budget; omission uses the selected model's declared default/cap. */
+  readonly maxTokens?: number;
+  /** The agent's stable system instructions. */
+  readonly instructions: string;
+  /** Execution policy; defaults to `basic`. */
+  readonly mode?: AgentMode;
+  /** Host-executed tools owned by this definition. */
+  readonly tools?: readonly ToolDefinition<any>[];
+  /** Provider-executed tools such as web search or image generation. */
+  readonly nativeTools?: readonly NativeToolSchema[];
+  /** Inline web skills and/or lazy providers such as filesystem discovery. */
+  readonly skills?: readonly SkillSource[];
+  /** Optional allowlist resolved across definition and per-session skill sources. */
+  readonly skillIds?: readonly string[];
+  /** Progressive-disclosure catalog and resource limits. */
+  readonly skillOptions?: AgentSkillOptions;
+  /**
+   * Model-visible context this agent always recomputes before a model round.
+   *
+   * Sections are platform-neutral callbacks. A filesystem-backed one (project
+   * instruction files, working-tree state) is built by a platform package and
+   * mounted here or per session.
+   */
+  readonly contextSections?: readonly ContextSection[];
+  readonly toolChoice?: ToolChoice;
+  /** Constrain visible model output to plain text or a named JSON Schema. */
+  readonly outputFormat?: ModelOutputFormat;
+  /** Maximum model iterations for one user turn; defaults to 16. */
+  /** Model steps per prompt; 'auto' continues without a fixed step ceiling. */
+  readonly maxTurns?: number | 'auto';
+  /** Maximum host tool calls for one user turn; defaults to 64. */
+  readonly maxToolCalls?: number;
+  /** Public progress narration policy; defaults to `concise`. */
+  readonly commentary?: 'auto' | 'concise' | 'off';
+  /** Durable task facts injected outside compactable conversation history. */
+  readonly memory?: AgentMemoryConfigInput;
+  /** Automatic context checkpointing; false disables it. Defaults to enabled. */
+  readonly compaction?: AgentCompactionOptions | false;
+}
+interface AgentDefinition {
+  readonly id: string;
+  readonly name: string;
+  readonly description: string | undefined;
+  readonly provider: string;
+  readonly model: string;
+  readonly effort: ReasoningEffortId | undefined;
+  readonly maxTokens: number | undefined;
+  readonly instructions: string;
+  readonly mode: AgentMode;
+  readonly tools: readonly ToolDefinition<any>[];
+  readonly nativeTools: readonly NativeToolSchema[];
+  readonly skills: readonly SkillSource[];
+  readonly skillIds: readonly string[] | undefined;
+  readonly skillOptions: ResolvedAgentSkillOptions;
+  readonly contextSections: readonly ContextSection[];
+  readonly toolChoice: ToolChoice | undefined;
+  readonly outputFormat: ModelOutputFormat | undefined;
+  readonly maxTurns: number | 'auto';
+  readonly maxToolCalls: number;
+  readonly commentary: 'auto' | 'concise' | 'off';
+  readonly memory: AgentMemoryConfig;
+  readonly compaction: AgentCompactionConfig | false;
+}
+interface DefinedAgent extends AgentDefinition {
+  /** Start an isolated, multi-turn conversation for this definition. */
+  createSession(options: AgentSessionOptions): AgentSession;
+  /** Resume a snapshot without manually hydrating history and memory. */
+  resumeSession(options: AgentResumeSessionOptions): AgentSession;
+  /** Derive a definition while preserving all unspecified settings. */
+  with(overrides: AgentDefinitionOverrides): DefinedAgent;
+}
+type AgentDefinitionOverrides = Partial<Omit<AgentDefinitionInput, 'id'>>;
+type CloneAgentOverrides = AgentDefinitionOverrides & {
+  readonly id: string;
+};
+//#endregion
+export { AgentDefinition, AgentDefinitionInput, AgentDefinitionOverrides, CloneAgentOverrides, DefinedAgent };
+//# sourceMappingURL=definition.d.ts.map

package/dist/agent/define/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","names":[],"sources":["../../../src/agent/define/definition.ts"],"mappings":";;;;;;;;;;;;;UAkCiB;;WAEN;;WAEA;WACA;;WAEA;;WAEA;;;;;;;;;WASA;;WAEA;;WAEA;;WAEA,OAAO;;WAEP,iBAAiB;;WAEjB,uBAAuB;;WAEvB,kBAAkB;;WAElB;;WAEA,eAAe;;;;;;;;WAQf,2BAA2B;WAC3B,aAAa;;WAEb,eAAe;;;WAGf;;WAEA;;WAEA;;WAEA,SAAS;;WAET,aAAa;;UAGP;WACN;WACA;WACA;WACA;WACA;WACA,QAAQ;WACR;WACA;WACA,MAAM;WACN,gBAAgB;WAChB,sBAAsB;WACtB,iBAAiB;WACjB;WACA,cAAc;WACd,0BAA0B;WAC1B,YAAY;WACZ,cAAc;WACd;WACA;WACA;WACA,QAAQ;WACR,YAAY;;UAGN,qBAAqB;;EAEpC,cAAc,SAAS,sBAAsB;;EAE7C,cAAc,SAAS,4BAA4B;;EAEnD,KAAK,WAAW,2BAA2B;;KAGjC,2BAA2B,QAAQ,KAAK;KACxC,sBAAsB;WAAsC"}

package/dist/agent/define/definition.js

@@ -0,0 +1,2 @@
+import{ReasoningEffortId as e}from"../../primitives/brand.js";import{resolveMemoryConfig as t}from"../memory/memory.js";import{resolveCompactionConfig as n}from"../memory/compaction-config.js";import{validateSkillId as r,validateSkillSource as i}from"../skill/definition.js";import{SKILL_TOOL_NAMES as a,resolveSkillOptions as o}from"../skill/tools.js";import{captureContextSections as s}from"../context/section.js";import{AgentSession as c}from"./session.js";import{captureOutputFormat as l}from"./output-format.js";const u=/^[a-zA-Z][a-zA-Z0-9_-]*$/;var d=class{id;name;description;provider;model;effort;maxTokens;instructions;mode;tools;nativeTools;skills;skillIds;skillOptions;contextSections;toolChoice;outputFormat;maxTurns;maxToolCalls;commentary;memory;compaction;constructor(r){g(r),this.id=r.id,this.name=r.name??r.id,this.description=r.description,this.provider=r.provider??`codex`,this.model=r.model??`gpt-5.6-luna`,this.effort=r.effort===void 0?void 0:e(r.effort),this.maxTokens=r.maxTokens,this.instructions=r.instructions,this.mode=r.mode??`basic`,this.tools=Object.freeze([...r.tools??[]]),this.nativeTools=Object.freeze((r.nativeTools??[]).map(e=>Object.freeze({...e}))),this.skills=Object.freeze([...r.skills??[]]),this.skillIds=r.skillIds===void 0?void 0:Object.freeze([...r.skillIds]),this.skillOptions=o(r.skillOptions),this.contextSections=s(r.contextSections)??Object.freeze([]),this.toolChoice=r.toolChoice,this.outputFormat=l(r.outputFormat),this.maxTurns=r.maxTurns??16,this.maxToolCalls=r.maxToolCalls??64,this.commentary=r.commentary??`concise`,this.memory=t(r.memory),this.compaction=r.compaction!==!1&&n(r.compaction),Object.freeze(this)}createSession(e){return new c(this,e)}resumeSession(e){return c.fromSnapshot(this,e)}with(e){return f(m(this,e))}};function f(e){return new d(e)}function p(e,t){return f(m(e,t))}function m(e,t){let n=t.description??e.description,r=t.toolChoice??e.toolChoice,i=t.outputFormat??e.outputFormat,a=t.skillIds??e.skillIds,o=t.maxTokens??e.maxTokens;return{id:t.id??e.id,name:t.name??e.name,...n===void 0?{}:{description:n},provider:t.provider??e.provider,model:t.model??e.model,...(t.effort??e.effort)===void 0?{}:{effort:t.effort??e.effort},...o===void 0?{}:{maxTokens:o},instructions:t.instructions??e.instructions,mode:t.mode??e.mode,tools:t.tools??e.tools,nativeTools:t.nativeTools??e.nativeTools,skills:t.skills??e.skills,...a===void 0?{}:{skillIds:a},skillOptions:t.skillOptions??e.skillOptions,contextSections:t.contextSections??e.contextSections,...r===void 0?{}:{toolChoice:r},...i===void 0?{}:{outputFormat:i},maxTurns:t.maxTurns??e.maxTurns,maxToolCalls:t.maxToolCalls??e.maxToolCalls,commentary:t.commentary??e.commentary,memory:t.memory??e.memory,compaction:t.compaction??h(e.compaction)}}function h(e){return e!==!1&&{auto:e.auto,...e.maxInputTokens===void 0?{}:{maxInputTokens:e.maxInputTokens},thresholdRatio:e.thresholdRatio,...e.retainRatio===void 0?{}:{retainRatio:e.retainRatio},...e.retainTokens===void 0?{}:{retainTokens:e.retainTokens},...e.summarizationProvider===void 0?{}:{summarizationProvider:e.summarizationProvider},...e.summarizationModel===void 0?{}:{summarizationModel:e.summarizationModel},...e.summarizationEffort===void 0?{}:{summarizationEffort:e.summarizationEffort},maxSummaryTokens:e.maxSummaryTokens,compactionRetries:e.compactionRetries,maxOverflowRetries:e.maxOverflowRetries,maxSummaryInputChars:e.maxSummaryInputChars,maxSummaryRequestChars:e.maxSummaryRequestChars,maxSummaryRequestBytes:e.maxSummaryRequestBytes,maxSummaryResponseBytes:e.maxSummaryResponseBytes,maxSummaryStreamEvents:e.maxSummaryStreamEvents,summaryTimeoutMs:e.summaryTimeoutMs,teardownTimeoutMs:e.teardownTimeoutMs,maxToolResultChars:e.maxToolResultChars}}function g(e){if(!u.test(e.id))throw TypeError(`agent id must start with a letter and contain only letters, numbers, _ or -`);for(let[t,n]of[[`name`,e.name],[`description`,e.description],[`provider`,e.provider],[`model`,e.model],[`effort`,e.effort]])if(n!==void 0&&n.trim().length===0)throw TypeError(`agent ${t} must be a non-empty string`);if(e.instructions.trim().length===0)throw TypeError(`agent instructions must be a non-empty string`);if(e.maxTurns!==void 0&&e.maxTurns!==`auto`&&(!Number.isSafeInteger(e.maxTurns)||e.maxTurns<1))throw RangeError(`agent maxTurns must be a positive safe integer or 'auto'`);if(e.maxTokens!==void 0&&(!Number.isSafeInteger(e.maxTokens)||e.maxTokens<1))throw RangeError(`agent maxTokens must be a positive safe integer`);if(e.maxToolCalls!==void 0&&(!Number.isInteger(e.maxToolCalls)||e.maxToolCalls<1))throw RangeError(`agent maxToolCalls must be a positive integer`);let t=new Set;for(let n of e.tools??[]){if(typeof n.name!=`string`||n.name.trim().length===0)throw TypeError(`agent host tools must have a non-empty name`);if(typeof n.description!=`string`||n.description.trim().length===0)throw TypeError(`agent host tool '${n.name}' must have a non-empty description`);if(typeof n.parameters!=`object`||n.parameters===null)throw TypeError(`agent host tool '${n.name}' must declare JSON Schema parameters`);if(typeof n.execute!=`function`)throw TypeError(`agent host tool '${n.name}' must implement execute()`);if(n.timeoutMs!==void 0&&(!Number.isFinite(n.timeoutMs)||n.timeoutMs<=0))throw RangeError(`agent host tool '${n.name}' must have a positive timeoutMs`);if(t.has(n.name))throw TypeError(`agent has duplicate host tool '${n.name}'`);t.add(n.name)}for(let n of e.nativeTools??[]){if(typeof n.name!=`string`||n.name.trim().length===0)throw TypeError(`agent native tools must have a non-empty name`);if(t.has(n.name))throw TypeError(`agent has duplicate tool '${n.name}'`);t.add(n.name)}if((e.skills?.length??0)>0||(e.skillIds?.length??0)>0){for(let e of a)if(t.has(e))throw TypeError(`agent tool '${e}' collides with the skill runtime`)}let n=new Set,o=new Set,s=new Set;for(let t of e.skillIds??[]){if(r(t,`agent skill`),s.has(t))throw TypeError(`agent has duplicate allowed skill '${t}'`);s.add(t)}for(let t of e.skills??[])if(i(t),t.kind===`skill`){if(n.has(t.id))throw TypeError(`agent has duplicate inline skill '${t.id}'`);n.add(t.id)}else{if(o.has(t.id))throw TypeError(`agent has duplicate skill provider '${t.id}'`);o.add(t.id)}}export{p as cloneAgent,f as defineAgent};
+//# sourceMappingURL=definition.js.map

package/dist/agent/define/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","names":[],"sources":["../../../src/agent/define/definition.ts"],"sourcesContent":["/** Declarative, code-first agent definitions. */\n\nimport type { ModelOutputFormat, ToolChoice, NativeToolSchema } from '../../contract/index.ts'\nimport { ReasoningEffortId, type ReasoningEffortId as ReasoningEffort } from '../../primitives/index.ts'\nimport type { AgentMode } from '../mode/run-agent.ts'\nimport type { ToolDefinition } from '../tool/definition.ts'\nimport { captureContextSections } from '../context/section.ts'\nimport type { ContextSection } from '../context/types.ts'\nimport {\n  SKILL_TOOL_NAMES,\n  resolveSkillOptions,\n  validateSkillId,\n  validateSkillSource,\n  type AgentSkillOptions,\n  type ResolvedAgentSkillOptions,\n  type SkillSource,\n} from '../skill/index.ts'\nimport {\n  resolveCompactionConfig,\n  type AgentCompactionConfig,\n  type AgentCompactionOptions,\n} from '../memory/compaction-config.ts'\nimport {\n  resolveMemoryConfig,\n  type AgentMemoryConfig,\n  type AgentMemoryConfigInput,\n} from '../memory/memory.ts'\nimport {\n  AgentSession,\n  type AgentResumeSessionOptions,\n  type AgentSessionOptions,\n} from './session.ts'\nimport { captureOutputFormat } from './output-format.ts'\n\nexport interface AgentDefinitionInput {\n  /** Stable code-owned identity used by traces and catalogs. */\n  readonly id: string\n  /** Human-readable display name; defaults to `id`. */\n  readonly name?: string\n  readonly description?: string\n  /** Provider route; defaults to `codex`. */\n  readonly provider?: string\n  /** Provider model id; defaults to `gpt-5.6-luna`. */\n  readonly model?: string\n  /**\n   * Provider reasoning effort. Omitted means no preference.\n   *\n   * An agent that never asked for a level should not be given one: the value\n   * is validated against the model's own ladder, so an invented default makes\n   * the agent unrunnable on every provider that declares no efforts — and\n   * silently overrides the provider's own default everywhere else.\n   */\n  readonly effort?: string\n  /** Requested output budget; omission uses the selected model's declared default/cap. */\n  readonly maxTokens?: number\n  /** The agent's stable system instructions. */\n  readonly instructions: string\n  /** Execution policy; defaults to `basic`. */\n  readonly mode?: AgentMode\n  /** Host-executed tools owned by this definition. */\n  readonly tools?: readonly ToolDefinition<any>[]\n  /** Provider-executed tools such as web search or image generation. */\n  readonly nativeTools?: readonly NativeToolSchema[]\n  /** Inline web skills and/or lazy providers such as filesystem discovery. */\n  readonly skills?: readonly SkillSource[]\n  /** Optional allowlist resolved across definition and per-session skill sources. */\n  readonly skillIds?: readonly string[]\n  /** Progressive-disclosure catalog and resource limits. */\n  readonly skillOptions?: AgentSkillOptions\n  /**\n   * Model-visible context this agent always recomputes before a model round.\n   *\n   * Sections are platform-neutral callbacks. A filesystem-backed one (project\n   * instruction files, working-tree state) is built by a platform package and\n   * mounted here or per session.\n   */\n  readonly contextSections?: readonly ContextSection[]\n  readonly toolChoice?: ToolChoice\n  /** Constrain visible model output to plain text or a named JSON Schema. */\n  readonly outputFormat?: ModelOutputFormat\n  /** Maximum model iterations for one user turn; defaults to 16. */\n  /** Model steps per prompt; 'auto' continues without a fixed step ceiling. */\n  readonly maxTurns?: number | 'auto'\n  /** Maximum host tool calls for one user turn; defaults to 64. */\n  readonly maxToolCalls?: number\n  /** Public progress narration policy; defaults to `concise`. */\n  readonly commentary?: 'auto' | 'concise' | 'off'\n  /** Durable task facts injected outside compactable conversation history. */\n  readonly memory?: AgentMemoryConfigInput\n  /** Automatic context checkpointing; false disables it. Defaults to enabled. */\n  readonly compaction?: AgentCompactionOptions | false\n}\n\nexport interface AgentDefinition {\n  readonly id: string\n  readonly name: string\n  readonly description: string | undefined\n  readonly provider: string\n  readonly model: string\n  readonly effort: ReasoningEffort | undefined\n  readonly maxTokens: number | undefined\n  readonly instructions: string\n  readonly mode: AgentMode\n  readonly tools: readonly ToolDefinition<any>[]\n  readonly nativeTools: readonly NativeToolSchema[]\n  readonly skills: readonly SkillSource[]\n  readonly skillIds: readonly string[] | undefined\n  readonly skillOptions: ResolvedAgentSkillOptions\n  readonly contextSections: readonly ContextSection[]\n  readonly toolChoice: ToolChoice | undefined\n  readonly outputFormat: ModelOutputFormat | undefined\n  readonly maxTurns: number | 'auto'\n  readonly maxToolCalls: number\n  readonly commentary: 'auto' | 'concise' | 'off'\n  readonly memory: AgentMemoryConfig\n  readonly compaction: AgentCompactionConfig | false\n}\n\nexport interface DefinedAgent extends AgentDefinition {\n  /** Start an isolated, multi-turn conversation for this definition. */\n  createSession(options: AgentSessionOptions): AgentSession\n  /** Resume a snapshot without manually hydrating history and memory. */\n  resumeSession(options: AgentResumeSessionOptions): AgentSession\n  /** Derive a definition while preserving all unspecified settings. */\n  with(overrides: AgentDefinitionOverrides): DefinedAgent\n}\n\nexport type AgentDefinitionOverrides = Partial<Omit<AgentDefinitionInput, 'id'>>\nexport type CloneAgentOverrides = AgentDefinitionOverrides & { readonly id: string }\ntype MergeAgentOverrides = AgentDefinitionOverrides & { readonly id?: string }\n\nconst ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*$/\n\nclass DefinedAgentValue implements DefinedAgent {\n  readonly id: string\n  readonly name: string\n  readonly description: string | undefined\n  readonly provider: string\n  readonly model: string\n  readonly effort: ReasoningEffort | undefined\n  readonly maxTokens: number | undefined\n  readonly instructions: string\n  readonly mode: AgentMode\n  readonly tools: readonly ToolDefinition<any>[]\n  readonly nativeTools: readonly NativeToolSchema[]\n  readonly skills: readonly SkillSource[]\n  readonly skillIds: readonly string[] | undefined\n  readonly skillOptions: ResolvedAgentSkillOptions\n  readonly contextSections: readonly ContextSection[]\n  readonly toolChoice: ToolChoice | undefined\n  readonly outputFormat: ModelOutputFormat | undefined\n  readonly maxTurns: number | 'auto'\n  readonly maxToolCalls: number\n  readonly commentary: 'auto' | 'concise' | 'off'\n  readonly memory: AgentMemoryConfig\n  readonly compaction: AgentCompactionConfig | false\n\n  constructor(input: AgentDefinitionInput) {\n    validate(input)\n    this.id = input.id\n    this.name = input.name ?? input.id\n    this.description = input.description\n    this.provider = input.provider ?? 'codex'\n    this.model = input.model ?? 'gpt-5.6-luna'\n    this.effort = input.effort === undefined ? undefined : ReasoningEffortId(input.effort)\n    this.maxTokens = input.maxTokens\n    this.instructions = input.instructions\n    this.mode = input.mode ?? 'basic'\n    this.tools = Object.freeze([...(input.tools ?? [])])\n    this.nativeTools = Object.freeze((input.nativeTools ?? []).map(tool => Object.freeze({ ...tool })))\n    this.skills = Object.freeze([...(input.skills ?? [])])\n    this.skillIds = input.skillIds === undefined ? undefined : Object.freeze([...input.skillIds])\n    this.skillOptions = resolveSkillOptions(input.skillOptions)\n    this.contextSections = captureContextSections(input.contextSections) ?? Object.freeze([])\n    this.toolChoice = input.toolChoice\n    this.outputFormat = captureOutputFormat(input.outputFormat)\n    this.maxTurns = input.maxTurns ?? 16\n    this.maxToolCalls = input.maxToolCalls ?? 64\n    this.commentary = input.commentary ?? 'concise'\n    this.memory = resolveMemoryConfig(input.memory)\n    this.compaction = input.compaction === false ? false : resolveCompactionConfig(input.compaction)\n    Object.freeze(this)\n  }\n\n  createSession(options: AgentSessionOptions): AgentSession {\n    return new AgentSession(this, options)\n  }\n\n  resumeSession(options: AgentResumeSessionOptions): AgentSession {\n    return AgentSession.fromSnapshot(this, options)\n  }\n\n  with(overrides: AgentDefinitionOverrides): DefinedAgent {\n    return defineAgent(mergedInput(this, overrides))\n  }\n}\n\n/** Define and validate one reusable agent. */\nexport function defineAgent(input: AgentDefinitionInput): DefinedAgent {\n  return new DefinedAgentValue(input)\n}\n\n/** Clone an agent under a new stable id. */\nexport function cloneAgent(source: AgentDefinition, overrides: CloneAgentOverrides): DefinedAgent {\n  return defineAgent(mergedInput(source, overrides))\n}\n\nfunction mergedInput(\n  source: AgentDefinition,\n  overrides: MergeAgentOverrides,\n): AgentDefinitionInput {\n  const description = overrides.description ?? source.description\n  const toolChoice = overrides.toolChoice ?? source.toolChoice\n  const outputFormat = overrides.outputFormat ?? source.outputFormat\n  const skillIds = overrides.skillIds ?? source.skillIds\n  const maxTokens = overrides.maxTokens ?? source.maxTokens\n  return {\n    id: overrides.id ?? source.id,\n    name: overrides.name ?? source.name,\n    ...(description === undefined ? {} : { description }),\n    provider: overrides.provider ?? source.provider,\n    model: overrides.model ?? source.model,\n    ...(overrides.effort ?? source.effort) === undefined\n      ? {}\n      : { effort: (overrides.effort ?? source.effort) as string },\n    ...(maxTokens === undefined ? {} : { maxTokens }),\n    instructions: overrides.instructions ?? source.instructions,\n    mode: overrides.mode ?? source.mode,\n    tools: overrides.tools ?? source.tools,\n    nativeTools: overrides.nativeTools ?? source.nativeTools,\n    skills: overrides.skills ?? source.skills,\n    ...(skillIds === undefined ? {} : { skillIds }),\n    skillOptions: overrides.skillOptions ?? source.skillOptions,\n    contextSections: overrides.contextSections ?? source.contextSections,\n    ...(toolChoice === undefined ? {} : { toolChoice }),\n    ...(outputFormat === undefined ? {} : { outputFormat }),\n    maxTurns: overrides.maxTurns ?? source.maxTurns,\n    maxToolCalls: overrides.maxToolCalls ?? source.maxToolCalls,\n    commentary: overrides.commentary ?? source.commentary,\n    memory: overrides.memory ?? source.memory,\n    compaction: overrides.compaction ?? compactionInput(source.compaction),\n  }\n}\n\nfunction compactionInput(value: AgentCompactionConfig | false): AgentCompactionOptions | false {\n  if (value === false) return false\n  return {\n    auto: value.auto,\n    ...(value.maxInputTokens === undefined ? {} : { maxInputTokens: value.maxInputTokens }),\n    thresholdRatio: value.thresholdRatio,\n    ...(value.retainRatio === undefined ? {} : { retainRatio: value.retainRatio }),\n    ...(value.retainTokens === undefined ? {} : { retainTokens: value.retainTokens }),\n    ...(value.summarizationProvider === undefined ? {} : { summarizationProvider: value.summarizationProvider }),\n    ...(value.summarizationModel === undefined ? {} : { summarizationModel: value.summarizationModel }),\n    ...(value.summarizationEffort === undefined ? {} : { summarizationEffort: value.summarizationEffort }),\n    maxSummaryTokens: value.maxSummaryTokens,\n    compactionRetries: value.compactionRetries,\n    maxOverflowRetries: value.maxOverflowRetries,\n    maxSummaryInputChars: value.maxSummaryInputChars,\n    maxSummaryRequestChars: value.maxSummaryRequestChars,\n    maxSummaryRequestBytes: value.maxSummaryRequestBytes,\n    maxSummaryResponseBytes: value.maxSummaryResponseBytes,\n    maxSummaryStreamEvents: value.maxSummaryStreamEvents,\n    summaryTimeoutMs: value.summaryTimeoutMs,\n    teardownTimeoutMs: value.teardownTimeoutMs,\n    maxToolResultChars: value.maxToolResultChars,\n  }\n}\n\nfunction validate(input: AgentDefinitionInput): void {\n  if (!ID_PATTERN.test(input.id)) {\n    throw new TypeError('agent id must start with a letter and contain only letters, numbers, _ or -')\n  }\n  for (const [field, value] of [\n    ['name', input.name], ['description', input.description], ['provider', input.provider],\n    ['model', input.model], ['effort', input.effort],\n  ] as const) {\n    if (value !== undefined && value.trim().length === 0) {\n      throw new TypeError(`agent ${field} must be a non-empty string`)\n    }\n  }\n  if (input.instructions.trim().length === 0) {\n    throw new TypeError('agent instructions must be a non-empty string')\n  }\n  if (input.maxTurns !== undefined && input.maxTurns !== 'auto'\n    && (!Number.isSafeInteger(input.maxTurns) || input.maxTurns < 1)) {\n    throw new RangeError(\"agent maxTurns must be a positive safe integer or 'auto'\")\n  }\n  if (input.maxTokens !== undefined\n    && (!Number.isSafeInteger(input.maxTokens) || input.maxTokens < 1)) {\n    throw new RangeError('agent maxTokens must be a positive safe integer')\n  }\n  if (input.maxToolCalls !== undefined\n    && (!Number.isInteger(input.maxToolCalls) || input.maxToolCalls < 1)) {\n    throw new RangeError('agent maxToolCalls must be a positive integer')\n  }\n  const names = new Set<string>()\n  for (const tool of input.tools ?? []) {\n    if (typeof tool.name !== 'string' || tool.name.trim().length === 0) {\n      throw new TypeError('agent host tools must have a non-empty name')\n    }\n    if (typeof tool.description !== 'string' || tool.description.trim().length === 0) {\n      throw new TypeError(`agent host tool '${tool.name}' must have a non-empty description`)\n    }\n    if (typeof tool.parameters !== 'object' || tool.parameters === null) {\n      throw new TypeError(`agent host tool '${tool.name}' must declare JSON Schema parameters`)\n    }\n    if (typeof tool.execute !== 'function') {\n      throw new TypeError(`agent host tool '${tool.name}' must implement execute()`)\n    }\n    if (tool.timeoutMs !== undefined && (!Number.isFinite(tool.timeoutMs) || tool.timeoutMs <= 0)) {\n      throw new RangeError(`agent host tool '${tool.name}' must have a positive timeoutMs`)\n    }\n    if (names.has(tool.name)) throw new TypeError(`agent has duplicate host tool '${tool.name}'`)\n    names.add(tool.name)\n  }\n  for (const tool of input.nativeTools ?? []) {\n    if (typeof tool.name !== 'string' || tool.name.trim().length === 0) {\n      throw new TypeError('agent native tools must have a non-empty name')\n    }\n    if (names.has(tool.name)) throw new TypeError(`agent has duplicate tool '${tool.name}'`)\n    names.add(tool.name)\n  }\n  if ((input.skills?.length ?? 0) > 0 || (input.skillIds?.length ?? 0) > 0) {\n    for (const reserved of SKILL_TOOL_NAMES) {\n      if (names.has(reserved)) throw new TypeError(`agent tool '${reserved}' collides with the skill runtime`)\n    }\n  }\n  const directSkills = new Set<string>()\n  const providers = new Set<string>()\n  const allowedSkills = new Set<string>()\n  for (const id of input.skillIds ?? []) {\n    validateSkillId(id, 'agent skill')\n    if (allowedSkills.has(id)) throw new TypeError(`agent has duplicate allowed skill '${id}'`)\n    allowedSkills.add(id)\n  }\n  for (const source of input.skills ?? []) {\n    validateSkillSource(source)\n    if (source.kind === 'skill') {\n      if (directSkills.has(source.id)) throw new TypeError(`agent has duplicate inline skill '${source.id}'`)\n      directSkills.add(source.id)\n    } else {\n      if (providers.has(source.id)) throw new TypeError(`agent has duplicate skill provider '${source.id}'`)\n      providers.add(source.id)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/agent/define/instructions.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../../errors/agent-sdk-error.js";const t=65536,n=`RUN_ADDITIONAL_INSTRUCTIONS_INVALID`;function r(t){if(t!==void 0){if(typeof t!=`string`||t.trim().length===0||new TextEncoder().encode(t).byteLength>65536)throw new e(`Run additional instructions are invalid`,n);return t}}function i(e,t){return t===void 0?e:`${e}\n\n${t}`}export{n as RUN_ADDITIONAL_INSTRUCTIONS_INVALID,t as RUN_ADDITIONAL_INSTRUCTIONS_MAX_BYTES,i as appendRunInstructions,r as captureAdditionalInstructions};
+//# sourceMappingURL=instructions.js.map

package/dist/agent/define/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","names":[],"sources":["../../../src/agent/define/instructions.ts"],"sourcesContent":["import { AgentSdkError } from '../../errors/agent-sdk-error.ts'\n\nexport const RUN_ADDITIONAL_INSTRUCTIONS_MAX_BYTES = 65_536\nexport const RUN_ADDITIONAL_INSTRUCTIONS_INVALID = 'RUN_ADDITIONAL_INSTRUCTIONS_INVALID'\n\n/** Capture the exact host-owned overlay; accepted text is never trimmed or rewritten. */\nexport function captureAdditionalInstructions(value: unknown): string | undefined {\n  if (value === undefined) return undefined\n  if (typeof value !== 'string' || value.trim().length === 0\n    || new TextEncoder().encode(value).byteLength > RUN_ADDITIONAL_INSTRUCTIONS_MAX_BYTES) {\n    throw new AgentSdkError('Run additional instructions are invalid', RUN_ADDITIONAL_INSTRUCTIONS_INVALID)\n  }\n  return value\n}\n\nexport function appendRunInstructions(system: string, overlay?: string): string {\n  return overlay === undefined ? system : `${system}\\n\\n${overlay}`\n}\n"],"mappings":"gEAEA,MAAa,EAAwC,MACxC,EAAsC,sCAGnD,SAAgB,EAA8B,EAAoC,CAC5E,OAAU,IAAA,GACd,IAAI,OAAO,GAAU,UAAY,EAAM,KAAK,CAAC,CAAC,SAAW,GACpD,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC,CAAC,WAAA,MACnC,MAAM,IAAI,EAAc,0CAA2C,CAAmC,EAExG,OAAO,CAFiG,CAG1G,CAEA,SAAgB,EAAsB,EAAgB,EAA0B,CAC9E,OAAO,IAAY,IAAA,GAAY,EAAS,GAAG,EAAO,MAAM,GAC1D"}

package/dist/agent/define/output-format.js

@@ -0,0 +1,2 @@
+import{snapshotJsonObject as e}from"../../primitives/json-snapshot.js";import{TOOL_DEFINITION_LIMITS as t}from"../tool/config.js";const n=/^[A-Za-z0-9_-]{1,64}$/u;function r(r){if(r===void 0)return;if(typeof r!=`object`||!r||Array.isArray(r))throw o();let s=i(r,`type`);if(s===`text`)return a(r,[`type`]),Object.freeze({type:s});if(s!==`json_schema`)throw o();a(r,[`type`,`name`,`schema`]);let c=i(r,`name`);if(typeof c!=`string`||!n.test(c))throw o();let l=e(i(r,`schema`),{maxObjectFields:t.schemaFields,maxArrayItems:t.schemaArrayItems,maxDepth:t.schemaDepth,maxNodes:t.schemaNodes,maxKeyBytes:t.schemaKeyBytes,maxBytes:t.schemaBytes});return Object.freeze({type:s,name:c,schema:l})}function i(e,t){let n=Object.getOwnPropertyDescriptor(e,t);if(n===void 0||!(`value`in n))throw o();return n.value}function a(e,t){let n=new Set(t);if(Reflect.ownKeys(e).some(e=>typeof e!=`string`||!n.has(e)))throw o()}function o(){return TypeError(`agent outputFormat must be text or a bounded JSON Schema with a valid name`)}export{r as captureOutputFormat};
+//# sourceMappingURL=output-format.js.map

package/dist/agent/define/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","names":[],"sources":["../../../src/agent/define/output-format.ts"],"sourcesContent":["import type { ModelOutputFormat } from '../../contract/output-format.ts'\nimport { snapshotJsonObject } from '../../primitives/json-snapshot.ts'\nimport { TOOL_DEFINITION_LIMITS } from '../tool/config.ts'\n\nconst NAME = /^[A-Za-z0-9_-]{1,64}$/u\n\n/** Validate, detach, bound, and freeze output configuration at definition time. */\nexport function captureOutputFormat(value: ModelOutputFormat | undefined): ModelOutputFormat | undefined {\n  if (value === undefined) return undefined\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw invalid()\n  const type = ownData(value, 'type')\n  if (type === 'text') {\n    exactKeys(value, ['type'])\n    return Object.freeze({ type })\n  }\n  if (type !== 'json_schema') throw invalid()\n  exactKeys(value, ['type', 'name', 'schema'])\n  const name = ownData(value, 'name')\n  if (typeof name !== 'string' || !NAME.test(name)) throw invalid()\n  const schema = snapshotJsonObject(ownData(value, 'schema'), {\n    maxObjectFields: TOOL_DEFINITION_LIMITS.schemaFields,\n    maxArrayItems: TOOL_DEFINITION_LIMITS.schemaArrayItems,\n    maxDepth: TOOL_DEFINITION_LIMITS.schemaDepth,\n    maxNodes: TOOL_DEFINITION_LIMITS.schemaNodes,\n    maxKeyBytes: TOOL_DEFINITION_LIMITS.schemaKeyBytes,\n    maxBytes: TOOL_DEFINITION_LIMITS.schemaBytes,\n  })\n  return Object.freeze({ type, name, schema })\n}\n\nfunction ownData(source: object, key: string): unknown {\n  const descriptor = Object.getOwnPropertyDescriptor(source, key)\n  if (descriptor === undefined || !('value' in descriptor)) throw invalid()\n  return descriptor.value\n}\n\nfunction exactKeys(source: object, allowed: readonly string[]): void {\n  const expected = new Set(allowed)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !expected.has(key))) throw invalid()\n}\n\nfunction invalid(): TypeError {\n  return new TypeError('agent outputFormat must be text or a bounded JSON Schema with a valid name')\n}\n"],"mappings":"kIAIA,MAAM,EAAO,yBAGb,SAAgB,EAAoB,EAAqE,CACvG,GAAI,IAAU,IAAA,GAAW,OACzB,GAAI,OAAO,GAAU,WAAY,GAAkB,MAAM,QAAQ,CAAK,EAAG,MAAM,EAAQ,EACvF,IAAM,EAAO,EAAQ,EAAO,MAAM,EAClC,GAAI,IAAS,OAEX,OADA,EAAU,EAAO,CAAC,MAAM,CAAC,EAClB,OAAO,OAAO,CAAE,MAAK,CAAC,EAE/B,GAAI,IAAS,cAAe,MAAM,EAAQ,EAC1C,EAAU,EAAO,CAAC,OAAQ,OAAQ,QAAQ,CAAC,EAC3C,IAAM,EAAO,EAAQ,EAAO,MAAM,EAClC,GAAI,OAAO,GAAS,UAAY,CAAC,EAAK,KAAK,CAAI,EAAG,MAAM,EAAQ,EAChE,IAAM,EAAS,EAAmB,EAAQ,EAAO,QAAQ,EAAG,CAC1D,gBAAiB,EAAuB,aACxC,cAAe,EAAuB,iBACtC,SAAU,EAAuB,YACjC,SAAU,EAAuB,YACjC,YAAa,EAAuB,eACpC,SAAU,EAAuB,WACnC,CAAC,EACD,OAAO,OAAO,OAAO,CAAE,OAAM,OAAM,QAAO,CAAC,CAC7C,CAEA,SAAS,EAAQ,EAAgB,EAAsB,CACrD,IAAM,EAAa,OAAO,yBAAyB,EAAQ,CAAG,EAC9D,GAAI,IAAe,IAAA,IAAa,EAAE,UAAW,GAAa,MAAM,EAAQ,EACxE,OAAO,EAAW,KACpB,CAEA,SAAS,EAAU,EAAgB,EAAkC,CACnE,IAAM,EAAW,IAAI,IAAI,CAAO,EAChC,GAAI,QAAQ,QAAQ,CAAM,CAAC,CAAC,KAAK,GAAO,OAAO,GAAQ,UAAY,CAAC,EAAS,IAAI,CAAG,CAAC,EAAG,MAAM,EAAQ,CACxG,CAEA,SAAS,GAAqB,CAC5B,OAAW,UAAU,4EAA4E,CACnG"}

package/dist/agent/define/session/accounting.js

@@ -0,0 +1,2 @@
+import{RunLedger as e}from"../../accounting/ledger.js";function t(t){let{definition:n,options:r,runtimeLimits:i,conversationId:a,runtime:o}=t;return new e({...r.observation===void 0?{}:{observation:r.observation},...r.observationResource===void 0?{}:{resource:r.observationResource},conversationId:a,sessionId:a,agentId:n.id,mode:n.mode,maxTurns:n.maxTurns,...r.usagePolicy===void 0?{}:{usagePolicy:r.usagePolicy},cumulativeTokenBudget:typeof i.maxTotalTokens==`number`,...o?.logger===void 0?{}:{logger:o.logger},...r.ledgerLimits===void 0?{}:{limits:r.ledgerLimits}})}export{t as createSessionLedger};
+//# sourceMappingURL=accounting.js.map

package/dist/agent/define/session/accounting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting.js","names":[],"sources":["../../../../src/agent/define/session/accounting.ts"],"sourcesContent":["import type { AgentDefinition } from '../definition.ts'\nimport type { AgentRuntimeLimits, AgentSessionOptions } from './types.ts'\nimport type { RuntimeSessionConfiguration } from './runtime-binding.ts'\nimport { RunLedger } from '../../accounting/ledger.ts'\n\nexport interface SessionLedgerInput {\n  readonly definition: AgentDefinition\n  readonly options: AgentSessionOptions\n  readonly runtimeLimits: Readonly<AgentRuntimeLimits>\n  readonly conversationId: string\n  readonly runtime?: RuntimeSessionConfiguration\n}\n\nexport function createSessionLedger(input: SessionLedgerInput): RunLedger {\n  const { definition, options, runtimeLimits, conversationId, runtime } = input\n  return new RunLedger({\n    ...options.observation === undefined ? {} : { observation: options.observation },\n    ...options.observationResource === undefined ? {} : { resource: options.observationResource },\n    conversationId,\n    sessionId: conversationId,\n    agentId: definition.id,\n    mode: definition.mode,\n    maxTurns: definition.maxTurns,\n    ...options.usagePolicy === undefined ? {} : { usagePolicy: options.usagePolicy },\n    cumulativeTokenBudget: typeof runtimeLimits.maxTotalTokens === 'number',\n    ...(runtime?.logger === undefined ? {} : { logger: runtime.logger }),\n    ...options.ledgerLimits === undefined ? {} : { limits: options.ledgerLimits },\n  })\n}\n"],"mappings":"uDAaA,SAAgB,EAAoB,EAAsC,CACxE,GAAM,CAAE,aAAY,UAAS,gBAAe,iBAAgB,WAAY,EACxE,OAAO,IAAI,EAAU,CACnB,GAAG,EAAQ,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAQ,WAAY,EAC/E,GAAG,EAAQ,sBAAwB,IAAA,GAAY,CAAC,EAAI,CAAE,SAAU,EAAQ,mBAAoB,EAC5F,iBACA,UAAW,EACX,QAAS,EAAW,GACpB,KAAM,EAAW,KACjB,SAAU,EAAW,SACrB,GAAG,EAAQ,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAQ,WAAY,EAC/E,sBAAuB,OAAO,EAAc,gBAAmB,SAC/D,GAAI,GAAS,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,MAAO,EAClE,GAAG,EAAQ,eAAiB,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,YAAa,CAC9E,CAAC,CACH"}

package/dist/agent/define/session/common.js

@@ -0,0 +1,2 @@
+import{systemRandomId as e}from"../../../platform/adapter.js";import{createTextMessage as t,freezeMessage as n}from"../../../message/message.js";import{ToolRegistry as r}from"../../tool/registry.js";function i(e){if(e===void 0)return a();if(e.trim().length===0||e.length>256)throw TypeError(`agent conversationId must be a non-empty string of at most 256 characters`);return e}function a(){return e()}function o(e){if(typeof e==`string`)return t(e);if(e.role!==`user`)throw TypeError(`agent input message must have role user`);return n(e)}function s(e){return e.role===`user`}function c(){let e=()=>void 0,t=()=>void 0;return{promise:new Promise((n,r)=>{e=n,t=r}),resolve:e,reject:t}}function l(e){return e instanceof Error?e.message:String(e)}function u(e){return typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:void 0}function d(e,t,n=[]){if(e.length===0&&t===void 0&&n.length===0)return;let i=new r;for(let t of e)i.register(t);if(t!==void 0){let e=`names`in t?t.names().map(e=>t.get(e)).filter(e=>e!==void 0):t;for(let t of e)i.register(t)}for(let e of n)i.register(e);return i}export{i as conversationId,c as deferred,u as errorCodeOf,s as isUserMessage,l as messageOf,a as newConversationId,d as toolCatalog,o as userMessage};
+//# sourceMappingURL=common.js.map

package/dist/agent/define/session/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["../../../../src/agent/define/session/common.ts"],"sourcesContent":["import { systemRandomId } from '../../../platform/adapter.ts'\nimport type { ToolDefinition } from '../../tool/definition.ts'\nimport { ToolRegistry, type ToolCatalog } from '../../tool/registry.ts'\nimport type { Message, UserMessage } from '../../../message/index.ts'\nimport { createTextMessage, freezeMessage } from '../../../message/index.ts'\nimport { type AgentInput } from './types.ts'\n\nexport function conversationId(value: string | undefined): string {\n  if (value === undefined) return newConversationId()\n  if (value.trim().length === 0 || value.length > 256) {\n    throw new TypeError('agent conversationId must be a non-empty string of at most 256 characters')\n  }\n  return value\n}\n\nexport function newConversationId(): string {\n  return systemRandomId()\n}\n\nexport function userMessage(input: AgentInput): UserMessage {\n  if (typeof input === 'string') return createTextMessage(input)\n  if (input.role !== 'user') throw new TypeError('agent input message must have role user')\n  return freezeMessage(input)\n}\n\nexport function isUserMessage(message: Message): message is UserMessage { return message.role === 'user' }\n\nexport interface Deferred<T> {\n  readonly promise: Promise<T>\n  readonly resolve: (value: T) => void\n  readonly reject: (error: unknown) => void\n}\n\nexport function deferred<T>(): Deferred<T> {\n  let resolve: (value: T) => void = () => undefined\n  let reject: (error: unknown) => void = () => undefined\n  const promise = new Promise<T>((resolvePromise, rejectPromise) => {\n    resolve = resolvePromise\n    reject = rejectPromise\n  })\n  return { promise, resolve, reject }\n}\n\nexport function messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n\nexport function errorCodeOf(error: unknown): string | undefined {\n  return typeof error === 'object' && error !== null\n    && 'code' in error && typeof error.code === 'string'\n    ? error.code\n    : undefined\n}\n\nexport function toolCatalog(\n  defined: readonly ToolDefinition<any>[],\n  additional: ToolCatalog | readonly ToolDefinition<any>[] | undefined,\n  generated: readonly ToolDefinition<any>[] = [],\n): ToolCatalog | undefined {\n  if (defined.length === 0 && additional === undefined && generated.length === 0) return undefined\n  const registry = new ToolRegistry()\n  for (const tool of defined) registry.register(tool)\n  if (additional !== undefined) {\n    const tools = 'names' in additional\n      ? additional.names().map(name => additional.get(name))\n        .filter((tool): tool is ToolDefinition => tool !== undefined)\n      : additional\n    for (const tool of tools) registry.register(tool)\n  }\n  for (const tool of generated) registry.register(tool)\n  return registry\n}\n"],"mappings":"uMAOA,SAAgB,EAAe,EAAmC,CAChE,GAAI,IAAU,IAAA,GAAW,OAAO,EAAkB,EAClD,GAAI,EAAM,KAAK,CAAC,CAAC,SAAW,GAAK,EAAM,OAAS,IAC9C,MAAU,UAAU,2EAA2E,EAEjG,OAAO,CACT,CAEA,SAAgB,GAA4B,CAC1C,OAAO,EAAe,CACxB,CAEA,SAAgB,EAAY,EAAgC,CAC1D,GAAI,OAAO,GAAU,SAAU,OAAO,EAAkB,CAAK,EAC7D,GAAI,EAAM,OAAS,OAAQ,MAAU,UAAU,yCAAyC,EACxF,OAAO,EAAc,CAAK,CAC5B,CAEA,SAAgB,EAAc,EAA0C,CAAE,OAAO,EAAQ,OAAS,MAAO,CAQzG,SAAgB,GAA2B,CACzC,IAAI,MAAoC,IAAA,GACpC,MAAyC,IAAA,GAK7C,MAAO,CAAE,QAAA,IAJW,SAAY,EAAgB,IAAkB,CAChE,EAAU,EACV,EAAS,CACX,CACe,EAAG,UAAS,QAAO,CACpC,CAEA,SAAgB,EAAU,EAAwB,CAChD,OAAO,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,CAC9D,CAEA,SAAgB,EAAY,EAAoC,CAC9D,OAAO,OAAO,GAAU,UAAY,GAC/B,SAAU,GAAS,OAAO,EAAM,MAAS,SAC1C,EAAM,KACN,IAAA,EACN,CAEA,SAAgB,EACd,EACA,EACA,EAA4C,CAAC,EACpB,CACzB,GAAI,EAAQ,SAAW,GAAK,IAAe,IAAA,IAAa,EAAU,SAAW,EAAG,OAChF,IAAM,EAAW,IAAI,EACrB,IAAK,IAAM,KAAQ,EAAS,EAAS,SAAS,CAAI,EAClD,GAAI,IAAe,IAAA,GAAW,CAC5B,IAAM,EAAQ,UAAW,EACrB,EAAW,MAAM,CAAC,CAAC,IAAI,GAAQ,EAAW,IAAI,CAAI,CAAC,CAAC,CACnD,OAAQ,GAAiC,IAAS,IAAA,EAAS,EAC5D,EACJ,IAAK,IAAM,KAAQ,EAAO,EAAS,SAAS,CAAI,CAClD,CACA,IAAK,IAAM,KAAQ,EAAW,EAAS,SAAS,CAAI,EACpD,OAAO,CACT"}

package/dist/agent/define/session/config.js

@@ -0,0 +1,2 @@
+import{timeoutValue as e}from"../../../platform/config.js";function t(t){if(t===void 0)return Object.freeze({});let n={...t};if(n.maxTotalTokens!==void 0&&n.maxTotalTokens!==`auto`&&(!Number.isSafeInteger(n.maxTotalTokens)||n.maxTotalTokens<1))throw RangeError(`agent runtimeLimits.maxTotalTokens must be a positive safe integer or 'auto'`);if(n.finalReportReserveTokens!==void 0&&(!Number.isSafeInteger(n.finalReportReserveTokens)||n.finalReportReserveTokens<0||typeof n.maxTotalTokens==`number`&&n.finalReportReserveTokens>=n.maxTotalTokens))throw RangeError(`agent runtimeLimits.finalReportReserveTokens must be a non-negative safe integer below maxTotalTokens`);for(let t of[`teardownTimeoutMs`,`modelTimeoutMs`,`maxModelRequestBytes`,`maxModelResponseBytes`,`maxModelStreamEvents`,`maxToolResultBytes`,`maxToolDurationMs`,`toolTeardownTimeoutMs`,`maxParallelToolCalls`,`maxConsecutiveToolErrors`,`repeatToolWarningAt`,`repeatToolLimit`,`toolCycleWarningAt`,`toolCycleLimit`,`maxToolCycleLength`,`maxToolResultTokens`,`hookTimeoutMs`,`hookTeardownTimeoutMs`,`memoryOperationTimeoutMs`,`observerTimeoutMs`]){let r=n[t];if(r!==void 0&&t.endsWith(`Ms`)&&e(r),r!==void 0&&(!Number.isSafeInteger(r)||r<1))throw RangeError(`agent runtimeLimits.${t} must be a positive safe integer`)}if(n.toolResultOverflow!==void 0&&![`auto`,`truncate`,`spill`].includes(n.toolResultOverflow))throw RangeError(`agent runtimeLimits.toolResultOverflow must be 'auto', 'truncate', or 'spill'`);if(n.onExhausted!==void 0&&![`force-final-answer`,`stop`,`continue`].includes(n.onExhausted))throw RangeError(`agent runtimeLimits.onExhausted must be 'force-final-answer', 'stop', or 'continue'`);if((n.repeatToolLimit??6)<(n.repeatToolWarningAt??3))throw RangeError(`agent runtimeLimits.repeatToolLimit must be >= repeatToolWarningAt`);if((n.toolCycleLimit??3)<(n.toolCycleWarningAt??2))throw RangeError(`agent runtimeLimits.toolCycleLimit must be >= toolCycleWarningAt`);return Object.freeze(n)}export{t as resolveRuntimeLimits};
+//# sourceMappingURL=config.js.map

package/dist/agent/define/session/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/agent/define/session/config.ts"],"sourcesContent":["import { type AgentRuntimeLimits } from './types.ts'\nimport { timeoutValue } from '../../../platform/config.ts'\n\nexport function resolveRuntimeLimits(input: AgentRuntimeLimits | undefined): Readonly<AgentRuntimeLimits> {\n  if (input === undefined) return Object.freeze({})\n  const values = { ...input }\n  if (values.maxTotalTokens !== undefined && values.maxTotalTokens !== 'auto'\n    && (!Number.isSafeInteger(values.maxTotalTokens) || values.maxTotalTokens < 1)) {\n    throw new RangeError(\"agent runtimeLimits.maxTotalTokens must be a positive safe integer or 'auto'\")\n  }\n  if (values.finalReportReserveTokens !== undefined\n    && (!Number.isSafeInteger(values.finalReportReserveTokens) || values.finalReportReserveTokens < 0\n      || (typeof values.maxTotalTokens === 'number' && values.finalReportReserveTokens >= values.maxTotalTokens))) {\n    throw new RangeError('agent runtimeLimits.finalReportReserveTokens must be a non-negative safe integer below maxTotalTokens')\n  }\n  for (const key of [\n    'teardownTimeoutMs', 'modelTimeoutMs', 'maxModelRequestBytes',\n    'maxModelResponseBytes', 'maxModelStreamEvents', 'maxToolResultBytes',\n    'maxToolDurationMs', 'toolTeardownTimeoutMs', 'maxParallelToolCalls',\n    'maxConsecutiveToolErrors', 'repeatToolWarningAt', 'repeatToolLimit',\n    'toolCycleWarningAt', 'toolCycleLimit', 'maxToolCycleLength', 'maxToolResultTokens',\n    'hookTimeoutMs', 'hookTeardownTimeoutMs', 'memoryOperationTimeoutMs',\n    'observerTimeoutMs',\n  ] as const) {\n    const value = values[key]\n    if (value !== undefined && key.endsWith('Ms')) timeoutValue(value)\n    if (value !== undefined && (!Number.isSafeInteger(value) || value < 1)) {\n      throw new RangeError(`agent runtimeLimits.${key} must be a positive safe integer`)\n    }\n  }\n  if (values.toolResultOverflow !== undefined\n    && !['auto', 'truncate', 'spill'].includes(values.toolResultOverflow)) {\n    throw new RangeError(\n      \"agent runtimeLimits.toolResultOverflow must be 'auto', 'truncate', or 'spill'\",\n    )\n  }\n  if (values.onExhausted !== undefined\n    && !['force-final-answer', 'stop', 'continue'].includes(values.onExhausted)) {\n    throw new RangeError(\n      \"agent runtimeLimits.onExhausted must be 'force-final-answer', 'stop', or 'continue'\",\n    )\n  }\n  if ((values.repeatToolLimit ?? 6) < (values.repeatToolWarningAt ?? 3)) {\n    throw new RangeError('agent runtimeLimits.repeatToolLimit must be >= repeatToolWarningAt')\n  }\n  if ((values.toolCycleLimit ?? 3) < (values.toolCycleWarningAt ?? 2)) {\n    throw new RangeError('agent runtimeLimits.toolCycleLimit must be >= toolCycleWarningAt')\n  }\n  return Object.freeze(values)\n}\n"],"mappings":"2DAGA,SAAgB,EAAqB,EAAqE,CACxG,GAAI,IAAU,IAAA,GAAW,OAAO,OAAO,OAAO,CAAC,CAAC,EAChD,IAAM,EAAS,CAAE,GAAG,CAAM,EAC1B,GAAI,EAAO,iBAAmB,IAAA,IAAa,EAAO,iBAAmB,SAC/D,CAAC,OAAO,cAAc,EAAO,cAAc,GAAK,EAAO,eAAiB,GAC5E,MAAU,WAAW,8EAA8E,EAErG,GAAI,EAAO,2BAA6B,IAAA,KAClC,CAAC,OAAO,cAAc,EAAO,wBAAwB,GAAK,EAAO,yBAA2B,GAC1F,OAAO,EAAO,gBAAmB,UAAY,EAAO,0BAA4B,EAAO,gBAC7F,MAAU,WAAW,uGAAuG,EAE9H,IAAK,IAAM,IAAO,CAChB,oBAAqB,iBAAkB,uBACvC,wBAAyB,uBAAwB,qBACjD,oBAAqB,wBAAyB,uBAC9C,2BAA4B,sBAAuB,kBACnD,qBAAsB,iBAAkB,qBAAsB,sBAC9D,gBAAiB,wBAAyB,2BAC1C,mBACF,EAAY,CACV,IAAM,EAAQ,EAAO,GAErB,GADI,IAAU,IAAA,IAAa,EAAI,SAAS,IAAI,GAAG,EAAa,CAAK,EAC7D,IAAU,IAAA,KAAc,CAAC,OAAO,cAAc,CAAK,GAAK,EAAQ,GAClE,MAAU,WAAW,uBAAuB,EAAI,iCAAiC,CAErF,CACA,GAAI,EAAO,qBAAuB,IAAA,IAC7B,CAAC,CAAC,OAAQ,WAAY,OAAO,CAAC,CAAC,SAAS,EAAO,kBAAkB,EACpE,MAAU,WACR,+EACF,EAEF,GAAI,EAAO,cAAgB,IAAA,IACtB,CAAC,CAAC,qBAAsB,OAAQ,UAAU,CAAC,CAAC,SAAS,EAAO,WAAW,EAC1E,MAAU,WACR,qFACF,EAEF,IAAK,EAAO,iBAAmB,IAAM,EAAO,qBAAuB,GACjE,MAAU,WAAW,oEAAoE,EAE3F,IAAK,EAAO,gBAAkB,IAAM,EAAO,oBAAsB,GAC/D,MAAU,WAAW,kEAAkE,EAEzF,OAAO,OAAO,OAAO,CAAM,CAC7B"}

package/dist/agent/define/session/model-config.js

@@ -0,0 +1,2 @@
+function e(e,t){return t===void 0?{provider:e.provider,model:e.model,...e.effort===void 0?{}:{reasoningEffort:e.effort},...e.maxTokens===void 0?{}:{maxTokens:e.maxTokens}}:{provider:t.provider,model:t.model,...t.reasoningEffort===void 0?{}:{reasoningEffort:t.reasoningEffort},...t.maxTokens===void 0?{}:{maxTokens:t.maxTokens}}}export{e as sessionCallConfig};
+//# sourceMappingURL=model-config.js.map

package/dist/agent/define/session/model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.js","names":[],"sources":["../../../../src/agent/define/session/model-config.ts"],"sourcesContent":["import type { AgentDefinition } from '../definition.ts'\nimport type { CallConfig } from '../../../contract/index.ts'\nimport type { RuntimeSessionConfiguration } from './runtime-binding.ts'\n\nexport function sessionCallConfig(\n  definition: AgentDefinition,\n  runtime: RuntimeSessionConfiguration | undefined,\n): Pick<CallConfig, 'provider' | 'model' | 'reasoningEffort' | 'maxTokens'> {\n  if (runtime !== undefined) return {\n    provider: runtime.provider,\n    model: runtime.model,\n    ...(runtime.reasoningEffort === undefined ? {} : { reasoningEffort: runtime.reasoningEffort }),\n    ...(runtime.maxTokens === undefined ? {} : { maxTokens: runtime.maxTokens }),\n  }\n  return {\n    provider: definition.provider,\n    model: definition.model,\n    // Omitted when the author expressed no preference: a value the SDK invented\n    // is rejected outright by a model that declares no ladder.\n    ...(definition.effort === undefined ? {} : { reasoningEffort: definition.effort }),\n    ...(definition.maxTokens === undefined ? {} : { maxTokens: definition.maxTokens }),\n  }\n}\n"],"mappings":"AAIA,SAAgB,EACd,EACA,EAC0E,CAO1E,OANI,IAAY,IAAA,GAMT,CACL,SAAU,EAAW,SACrB,MAAO,EAAW,MAGlB,GAAI,EAAW,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,gBAAiB,EAAW,MAAO,EAChF,GAAI,EAAW,YAAc,IAAA,GAAY,CAAC,EAAI,CAAE,UAAW,EAAW,SAAU,CAClF,EAbkC,CAChC,SAAU,EAAQ,SAClB,MAAO,EAAQ,MACf,GAAI,EAAQ,kBAAoB,IAAA,GAAY,CAAC,EAAI,CAAE,gBAAiB,EAAQ,eAAgB,EAC5F,GAAI,EAAQ,YAAc,IAAA,GAAY,CAAC,EAAI,CAAE,UAAW,EAAQ,SAAU,CAC5E,CASF"}

package/dist/agent/define/session/observer.js

@@ -0,0 +1,2 @@
+import{waitForSettlement as e}from"../../../async/settlement.js";async function t(t,n,r){for await(let i of t)n!==void 0&&await e(Promise.resolve().then(()=>n(i)),r)}export{t as consumeSessionEvents};
+//# sourceMappingURL=observer.js.map

package/dist/agent/define/session/observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.js","names":[],"sources":["../../../../src/agent/define/session/observer.ts"],"sourcesContent":["import { waitForSettlement } from '../../../async/index.ts'\nimport type { AgentRunEvent } from '../../mode/run-agent.ts'\n\nexport async function consumeSessionEvents(\n  events: AsyncIterable<AgentRunEvent>,\n  observer: ((event: AgentRunEvent) => void | Promise<void>) | undefined,\n  timeoutMs: number,\n): Promise<void> {\n  for await (const event of events) {\n    if (observer === undefined) continue\n    await waitForSettlement(Promise.resolve().then(() => observer(event)), timeoutMs)\n  }\n}\n"],"mappings":"iEAGA,eAAsB,EACpB,EACA,EACA,EACe,CACf,UAAW,IAAM,KAAS,EACpB,IAAa,IAAA,IACjB,MAAM,EAAkB,QAAQ,QAAQ,CAAC,CAAC,SAAW,EAAS,CAAK,CAAC,EAAG,CAAS,CAEpF"}

package/dist/agent/define/session/run-seal.js

@@ -0,0 +1,2 @@
+import{createRunTerminalRecord as e,withTerminalDelivery as t}from"../../accounting/delivery/terminal.js";import{AgentRunError as n}from"../../accounting/error.js";function r(r){if(r.isTerminal())return r.report.promise;r.markTerminal(),r.abort(),r.toolSources.resolve(r.currentToolSources());let i=Object.assign(Error(`Runtime close sealed an unsettled agent run`),{code:`RUNTIME_OPERATION_ABORTED`});return r.ledger.finalize(`aborted`,!1,i).then(a=>{let o=t(e(a),a.delivery),s=new n(`Agent run did not complete`,i.code,o,{cause:i});r.report.resolve(o),r.result.reject(s),r.buffer.fail(s)},e=>{r.report.reject(e),r.result.reject(e),r.buffer.fail(e)}).finally(r.release),r.report.promise}export{r as sealRuntimeRun};
+//# sourceMappingURL=run-seal.js.map

package/dist/agent/define/session/run-seal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-seal.js","names":[],"sources":["../../../../src/agent/define/session/run-seal.ts"],"sourcesContent":["import { AgentRunError } from '../../accounting/error.ts'\nimport type { RunLedger } from '../../accounting/ledger.ts'\nimport { RunEventBuffer } from '../../accounting/event-buffer.ts'\nimport type { RunReport, ToolSourceRunReference } from '../../accounting/delivery-types.ts'\nimport { createRunTerminalRecord, withTerminalDelivery } from '../../accounting/delivery/terminal.ts'\nimport type { AgentRunEvent } from '../../mode/run-agent.ts'\nimport type { AgentResponse } from './types.ts'\nimport type { Deferred } from './common.ts'\n\ninterface RuntimeRunSealInput {\n  readonly ledger: RunLedger\n  readonly buffer: RunEventBuffer<AgentRunEvent>\n  readonly report: Deferred<RunReport>\n  readonly result: Deferred<AgentResponse>\n  readonly toolSources: Deferred<readonly ToolSourceRunReference[]>\n  readonly currentToolSources: () => readonly ToolSourceRunReference[]\n  readonly isTerminal: () => boolean\n  readonly markTerminal: () => void\n  readonly abort: () => void\n  readonly release: () => void\n}\n\n/** Seal one uncooperative run without allowing its eventual return to replace public terminal state. */\nexport function sealRuntimeRun(input: RuntimeRunSealInput): Promise<RunReport> {\n  if (input.isTerminal()) return input.report.promise\n  input.markTerminal()\n  input.abort()\n  input.toolSources.resolve(input.currentToolSources())\n  const failure = Object.assign(new Error('Runtime close sealed an unsettled agent run'), {\n    code: 'RUNTIME_OPERATION_ABORTED',\n  })\n  void input.ledger.finalize('aborted', false, failure).then(legacy => {\n    const report = withTerminalDelivery(createRunTerminalRecord(legacy), legacy.delivery)\n    const error = new AgentRunError('Agent run did not complete', failure.code, report, { cause: failure })\n    input.report.resolve(report)\n    input.result.reject(error)\n    input.buffer.fail(error)\n  }, error => {\n    input.report.reject(error)\n    input.result.reject(error)\n    input.buffer.fail(error)\n  }).finally(input.release)\n  return input.report.promise\n}\n"],"mappings":"oKAuBA,SAAgB,EAAe,EAAgD,CAC7E,GAAI,EAAM,WAAW,EAAG,OAAO,EAAM,OAAO,QAC5C,EAAM,aAAa,EACnB,EAAM,MAAM,EACZ,EAAM,YAAY,QAAQ,EAAM,mBAAmB,CAAC,EACpD,IAAM,EAAU,OAAO,OAAW,MAAM,6CAA6C,EAAG,CACtF,KAAM,2BACR,CAAC,EAYD,OAXA,EAAW,OAAO,SAAS,UAAW,GAAO,CAAO,CAAC,CAAC,KAAK,GAAU,CACnE,IAAM,EAAS,EAAqB,EAAwB,CAAM,EAAG,EAAO,QAAQ,EAC9E,EAAQ,IAAI,EAAc,6BAA8B,EAAQ,KAAM,EAAQ,CAAE,MAAO,CAAQ,CAAC,EACtG,EAAM,OAAO,QAAQ,CAAM,EAC3B,EAAM,OAAO,OAAO,CAAK,EACzB,EAAM,OAAO,KAAK,CAAK,CACzB,EAAG,GAAS,CACV,EAAM,OAAO,OAAO,CAAK,EACzB,EAAM,OAAO,OAAO,CAAK,EACzB,EAAM,OAAO,KAAK,CAAK,CACzB,CAAC,CAAC,CAAC,QAAQ,EAAM,OAAO,EACjB,EAAM,OAAO,OACtB"}

package/dist/agent/define/session/runtime-binding.js

@@ -0,0 +1,2 @@
+const e=new WeakMap,t=new WeakMap,n=new WeakMap,r=new WeakMap,i=new WeakMap;function a(r,a,o,s,c){e.set(r,a),t.set(r,o),n.set(r,s),i.set(r,c)}function o(e,n){let r=t.get(e);if(r===void 0)throw TypeError(`Runtime session is unavailable`);return r(n)}function s(e,t){let r=n.get(e);if(r===void 0)throw TypeError(`Runtime session is unavailable`);return r(t)}function c(e){return r.get(e)}function l(t,n,r,i){let a=e.get(t);if(a===void 0)throw TypeError(`Runtime session is unavailable`);return a(n,r,i)}function u(e,t){let n=i.get(e);if(n===void 0)throw TypeError(`Runtime session is unavailable`);r.set(e,Object.freeze({...t})),n()}export{a as attachRuntimeSession,s as compactRuntimeSession,u as configureRuntimeSessionModel,c as runtimeSessionConfiguration,o as streamPendingRuntimeSession,l as streamRuntimeSession};
+//# sourceMappingURL=runtime-binding.js.map

package/dist/agent/define/session/runtime-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.js","names":[],"sources":["../../../../src/agent/define/session/runtime-binding.ts"],"sourcesContent":["import type { CallConfig } from '../../../contract/index.ts'\nimport type { CorrelationContext } from '../../../observation/index.ts'\nimport type { SdkLogger } from '../../../logging/types.ts'\nimport type { RuntimeMemoryPersistence } from '../../memory/persistence-types.ts'\nimport type {\n  ToolSourceRunReference, ToolSourceRunSnapshot,\n} from '../../tool/source-types.ts'\nimport type { AgentSession } from '../session.ts'\nimport type { AgentInput, AgentInvocationOptions, AgentRunHandle } from './types.ts'\nimport type { CompactionResult } from '../../memory/compaction.ts'\nimport type { LegacyRunReport } from '../../accounting/report.ts'\n\nexport interface RuntimeSessionConfiguration\n  extends Readonly<Pick<CallConfig, 'provider' | 'model' | 'reasoningEffort' | 'maxTokens'>> {\n  readonly logger?: (correlation: CorrelationContext) => SdkLogger\n  readonly prepareTools?: (\n    signal: AbortSignal,\n    logger: SdkLogger,\n    occupiedNames: readonly string[],\n  ) => ToolSourceRunSnapshot\n  readonly memory?: RuntimeMemoryPersistence\n}\n\nexport type RuntimeSessionRunHandle = AgentRunHandle & {\n  readonly traceId: string\n  readonly toolSourceSnapshots: Promise<readonly ToolSourceRunReference[]>\n  readonly eventsSettled: Promise<void>\n  abort(reason?: unknown): void\n  seal(): AgentRunHandle['report']\n}\n\ntype RuntimeStream = (\n  input: AgentInput,\n  invocation: AgentInvocationOptions,\n  additionalInstructions?: string,\n) => AgentRunHandle\n\ntype RuntimePendingStream = (invocation: AgentInvocationOptions) => AgentRunHandle\n\nexport interface RuntimeCompactionOutcome {\n  readonly result: CompactionResult | null\n  readonly report: LegacyRunReport\n  readonly failure?: unknown\n}\n\ntype RuntimeCompact = (invocation: AgentInvocationOptions) => Promise<RuntimeCompactionOutcome>\n\nconst streams = new WeakMap<AgentSession, RuntimeStream>()\nconst pendingStreams = new WeakMap<AgentSession, RuntimePendingStream>()\nconst compactors = new WeakMap<AgentSession, RuntimeCompact>()\nconst configurations = new WeakMap<AgentSession, RuntimeSessionConfiguration>()\nconst configured = new WeakMap<AgentSession, () => void>()\n\nexport function attachRuntimeSession(\n  session: AgentSession,\n  stream: RuntimeStream,\n  streamPending: RuntimePendingStream,\n  compact: RuntimeCompact,\n  onConfigure: () => void,\n): void {\n  streams.set(session, stream)\n  pendingStreams.set(session, streamPending)\n  compactors.set(session, compact)\n  configured.set(session, onConfigure)\n}\n\nexport function streamPendingRuntimeSession(\n  session: AgentSession,\n  invocation: AgentInvocationOptions,\n): RuntimeSessionRunHandle {\n  const stream = pendingStreams.get(session)\n  if (stream === undefined) throw new TypeError('Runtime session is unavailable')\n  return stream(invocation) as RuntimeSessionRunHandle\n}\n\nexport function compactRuntimeSession(\n  session: AgentSession,\n  invocation: AgentInvocationOptions,\n): Promise<RuntimeCompactionOutcome> {\n  const compact = compactors.get(session)\n  if (compact === undefined) throw new TypeError('Runtime session is unavailable')\n  return compact(invocation)\n}\n\nexport function runtimeSessionConfiguration(\n  session: AgentSession,\n): RuntimeSessionConfiguration | undefined {\n  return configurations.get(session)\n}\n\n/** Internal composition seam; keeps run-only overlays out of preserved legacy options. */\nexport function streamRuntimeSession(\n  session: AgentSession,\n  input: AgentInput,\n  invocation: AgentInvocationOptions,\n  additionalInstructions?: string,\n): RuntimeSessionRunHandle {\n  const stream = streams.get(session)\n  if (stream === undefined) throw new TypeError('Runtime session is unavailable')\n  return stream(input, invocation, additionalInstructions) as RuntimeSessionRunHandle\n}\n\n/** Preserve reasoning-effort omission while binding one high-level runtime session. */\nexport function configureRuntimeSessionModel(\n  session: AgentSession,\n  configuration: RuntimeSessionConfiguration,\n): void {\n  const onConfigure = configured.get(session)\n  if (onConfigure === undefined) throw new TypeError('Runtime session is unavailable')\n  configurations.set(session, Object.freeze({ ...configuration }))\n  onConfigure()\n}\n"],"mappings":"AA+CA,MAAM,EAAU,IAAI,QACd,EAAiB,IAAI,QACrB,EAAa,IAAI,QACjB,EAAiB,IAAI,QACrB,EAAa,IAAI,QAEvB,SAAgB,EACd,EACA,EACA,EACA,EACA,EACM,CACN,EAAQ,IAAI,EAAS,CAAM,EAC3B,EAAe,IAAI,EAAS,CAAa,EACzC,EAAW,IAAI,EAAS,CAAO,EAC/B,EAAW,IAAI,EAAS,CAAW,CACrC,CAEA,SAAgB,EACd,EACA,EACyB,CACzB,IAAM,EAAS,EAAe,IAAI,CAAO,EACzC,GAAI,IAAW,IAAA,GAAW,MAAU,UAAU,gCAAgC,EAC9E,OAAO,EAAO,CAAU,CAC1B,CAEA,SAAgB,EACd,EACA,EACmC,CACnC,IAAM,EAAU,EAAW,IAAI,CAAO,EACtC,GAAI,IAAY,IAAA,GAAW,MAAU,UAAU,gCAAgC,EAC/E,OAAO,EAAQ,CAAU,CAC3B,CAEA,SAAgB,EACd,EACyC,CACzC,OAAO,EAAe,IAAI,CAAO,CACnC,CAGA,SAAgB,EACd,EACA,EACA,EACA,EACyB,CACzB,IAAM,EAAS,EAAQ,IAAI,CAAO,EAClC,GAAI,IAAW,IAAA,GAAW,MAAU,UAAU,gCAAgC,EAC9E,OAAO,EAAO,EAAO,EAAY,CAAsB,CACzD,CAGA,SAAgB,EACd,EACA,EACM,CACN,IAAM,EAAc,EAAW,IAAI,CAAO,EAC1C,GAAI,IAAgB,IAAA,GAAW,MAAU,UAAU,gCAAgC,EACnF,EAAe,IAAI,EAAS,OAAO,OAAO,CAAE,GAAG,CAAc,CAAC,CAAC,EAC/D,EAAY,CACd"}

package/dist/agent/define/session/runtime-compaction.js

@@ -0,0 +1,2 @@
+async function e(e){let{accounting:t,invocation:n}=e,r=null,i,a;try{await e.prepare(),a=t.startOperation(`compaction`,{data:{trigger:`manual`}}),r=await e.compactor?.compactNow(n.signal)??null,t.endOperation(a,`success`),a=void 0}catch(e){i=e,a!==void 0&&t.endOperation(a,n.signal?.aborted===!0?`aborted`:`error`,{error:e})}let o=await t.finalize(n.signal?.aborted===!0?`aborted`:i===void 0?`success`:`error`,i===void 0,i);return Object.freeze({result:r,report:o,...i===void 0?{}:{failure:i}})}export{e as runRuntimeCompaction};
+//# sourceMappingURL=runtime-compaction.js.map

package/dist/agent/define/session/runtime-compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-compaction.js","names":[],"sources":["../../../../src/agent/define/session/runtime-compaction.ts"],"sourcesContent":["import type { RunAccountingPort } from '../../accounting/contracts.ts'\nimport type { LegacyRunReport } from '../../accounting/report.ts'\nimport type { CompactionResult, ContextCompactor } from '../../memory/compaction.ts'\nimport type { AgentInvocationOptions } from './types.ts'\n\nexport interface RuntimeCompactionInput {\n  readonly compactor?: ContextCompactor\n  readonly invocation: AgentInvocationOptions\n  readonly accounting: RunAccountingPort\n  readonly prepare: () => Promise<void>\n}\n\nexport interface RuntimeCompactionOutcome {\n  readonly result: CompactionResult | null\n  readonly report: LegacyRunReport\n  readonly failure?: unknown\n}\n\nexport async function runRuntimeCompaction(input: RuntimeCompactionInput): Promise<RuntimeCompactionOutcome> {\n  const { accounting, invocation } = input\n  let result: CompactionResult | null = null\n  let failure: unknown\n  let operation: string | undefined\n  try {\n    await input.prepare()\n    operation = accounting.startOperation('compaction', { data: { trigger: 'manual' } })\n    result = await input.compactor?.compactNow(invocation.signal) ?? null\n    accounting.endOperation(operation, 'success')\n    operation = undefined\n  } catch (error: unknown) {\n    failure = error\n    if (operation !== undefined) accounting.endOperation(\n      operation,\n      invocation.signal?.aborted === true ? 'aborted' : 'error',\n      { error },\n    )\n  }\n  const report = await accounting.finalize(\n    invocation.signal?.aborted === true ? 'aborted' : failure === undefined ? 'success' : 'error',\n    failure === undefined,\n    failure,\n  )\n  return Object.freeze({ result, report, ...(failure === undefined ? {} : { failure }) })\n}\n"],"mappings":"AAkBA,eAAsB,EAAqB,EAAkE,CAC3G,GAAM,CAAE,aAAY,cAAe,EAC/B,EAAkC,KAClC,EACA,EACJ,GAAI,CACF,MAAM,EAAM,QAAQ,EACpB,EAAY,EAAW,eAAe,aAAc,CAAE,KAAM,CAAE,QAAS,QAAS,CAAE,CAAC,EACnF,EAAS,MAAM,EAAM,WAAW,WAAW,EAAW,MAAM,GAAK,KACjE,EAAW,aAAa,EAAW,SAAS,EAC5C,EAAY,IAAA,EACd,OAAS,EAAgB,CACvB,EAAU,EACN,IAAc,IAAA,IAAW,EAAW,aACtC,EACA,EAAW,QAAQ,UAAY,GAAO,UAAY,QAClD,CAAE,OAAM,CACV,CACF,CACA,IAAM,EAAS,MAAM,EAAW,SAC9B,EAAW,QAAQ,UAAY,GAAO,UAAY,IAAY,IAAA,GAAY,UAAY,QACtF,IAAY,IAAA,GACZ,CACF,EACA,OAAO,OAAO,OAAO,CAAE,SAAQ,SAAQ,GAAI,IAAY,IAAA,GAAY,CAAC,EAAI,CAAE,SAAQ,CAAG,CAAC,CACxF"}

package/dist/agent/define/session/runtime-memory.js

@@ -0,0 +1,2 @@
+import{createUserMessage as e}from"../../../message/message.js";import{AgentMemory as t}from"../../memory/memory.js";import{isUserMessage as n}from"./common.js";async function r(e,n,r,i,a){let o=a.modelInvocation.logger;if(o===void 0)throw Error(`runtime memory logger is unavailable`);let s=a.startOperation(`memory`,{data:{action:`load`}});try{let c=await e.load(n,i,o),l=c.status===`loaded`?t.fromSnapshot(c.snapshot,r):void 0;return a.endOperation(s,c.status===`disabled`?`error`:`success`,c.status===`disabled`?{error:c.error}:{}),Object.freeze({state:c,...l===void 0?{}:{memory:l}})}catch(e){throw a.endOperation(s,i.aborted?`aborted`:`error`),e}}async function i(e,t,n,r,i,a){let o=a.modelInvocation.logger;if(o===void 0)throw Error(`runtime memory logger is unavailable`);let s=a.startOperation(`memory`,{data:{action:`commit`}});try{let c=await e.commit(t,n,r.revision,i,o);a.endOperation(s,c.status===`disabled`?`error`:`success`,c.status===`disabled`?{error:c.error}:{})}catch(e){throw a.endOperation(s,i.aborted?`aborted`:`error`),e}}function a(t,n,r){let i=r?.startOperation(`memory`,{data:{action:`render`}});try{let a=t.render(n);return i!==void 0&&r?.endOperation(i,`success`),a.length===0?[]:[e({source:{kind:`app`,producer:`agent-task-memory`},content:[{type:`text`,text:a}]})]}catch(e){throw i!==void 0&&r?.endOperation(i,`error`,{error:e}),e}}function o(e,t,r){if(!r)return;let i=t.entries().find(e=>e.event.kind===`user`&&e.event.message.role===`user`&&e.event.message.source.kind===`user`);i?.event.kind===`user`&&n(i.event.message)&&e.captureOriginalObjective(i.event.message)}export{o as captureResumedObjective,i as commitRuntimeMemory,r as loadRuntimeMemory,a as renderRuntimeMemory};
+//# sourceMappingURL=runtime-memory.js.map

package/dist/agent/define/session/runtime-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-memory.js","names":[],"sources":["../../../../src/agent/define/session/runtime-memory.ts"],"sourcesContent":["import { AgentMemory, type AgentMemoryConfig, type AgentMemorySnapshot } from '../../memory/memory.ts'\nimport type { RunLedger } from '../../accounting/ledger.ts'\nimport type { RunAccountingPort } from '../../accounting/contracts.ts'\nimport type { MemoryLoadState, RuntimeMemoryPersistence } from '../../memory/persistence-types.ts'\nimport { createUserMessage, type UserMessage } from '../../../message/index.ts'\nimport type { History } from '../../history/history.ts'\nimport { isUserMessage } from './common.ts'\n\nexport interface PreparedRuntimeMemory {\n  readonly state: MemoryLoadState\n  readonly memory?: AgentMemory\n}\n\nexport async function loadRuntimeMemory(\n  persistence: RuntimeMemoryPersistence,\n  conversationId: string,\n  limits: AgentMemoryConfig,\n  signal: AbortSignal,\n  ledger: RunLedger,\n): Promise<PreparedRuntimeMemory> {\n  const logger = ledger.modelInvocation.logger\n  if (logger === undefined) throw new Error('runtime memory logger is unavailable')\n  const operation = ledger.startOperation('memory', { data: { action: 'load' } })\n  try {\n    const state = await persistence.load(conversationId, signal, logger)\n    const memory = state.status === 'loaded'\n      ? AgentMemory.fromSnapshot(state.snapshot, limits)\n      : undefined\n    ledger.endOperation(operation, state.status === 'disabled' ? 'error' : 'success',\n      state.status === 'disabled' ? { error: state.error } : {})\n    return Object.freeze({ state, ...(memory === undefined ? {} : { memory }) })\n  } catch (error) {\n    ledger.endOperation(operation, signal.aborted ? 'aborted' : 'error')\n    throw error\n  }\n}\n\nexport async function commitRuntimeMemory(\n  persistence: RuntimeMemoryPersistence,\n  conversationId: string,\n  snapshot: AgentMemorySnapshot,\n  state: Exclude<MemoryLoadState, { readonly status: 'disabled' }>,\n  signal: AbortSignal,\n  ledger: RunLedger,\n): Promise<void> {\n  const logger = ledger.modelInvocation.logger\n  if (logger === undefined) throw new Error('runtime memory logger is unavailable')\n  const operation = ledger.startOperation('memory', { data: { action: 'commit' } })\n  try {\n    const committed = await persistence.commit(\n      conversationId, snapshot, state.revision, signal, logger,\n    )\n    ledger.endOperation(operation, committed.status === 'disabled' ? 'error' : 'success',\n      committed.status === 'disabled' ? { error: committed.error } : {})\n  } catch (error) {\n    ledger.endOperation(operation, signal.aborted ? 'aborted' : 'error')\n    throw error\n  }\n}\n\nexport function renderRuntimeMemory(\n  memory: AgentMemory,\n  maxInjectedChars: number,\n  accounting?: RunAccountingPort,\n): readonly UserMessage[] {\n  const operation = accounting?.startOperation('memory', { data: { action: 'render' } })\n  try {\n    const content = memory.render(maxInjectedChars)\n    if (operation !== undefined) accounting?.endOperation(operation, 'success')\n    return content.length === 0 ? [] : [createUserMessage({\n      source: { kind: 'app', producer: 'agent-task-memory' },\n      content: [{ type: 'text', text: content }],\n    })]\n  } catch (error) {\n    if (operation !== undefined) accounting?.endOperation(operation, 'error', { error })\n    throw error\n  }\n}\n\nexport function captureResumedObjective(\n  memory: AgentMemory,\n  history: History,\n  enabled: boolean,\n): void {\n  if (!enabled) return\n  const entry = history.entries().find(entry => entry.event.kind === 'user'\n    && entry.event.message.role === 'user' && entry.event.message.source.kind === 'user')\n  if (entry?.event.kind === 'user' && isUserMessage(entry.event.message)) {\n    memory.captureOriginalObjective(entry.event.message)\n  }\n}\n"],"mappings":"iKAaA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EACgC,CAChC,IAAM,EAAS,EAAO,gBAAgB,OACtC,GAAI,IAAW,IAAA,GAAW,MAAU,MAAM,sCAAsC,EAChF,IAAM,EAAY,EAAO,eAAe,SAAU,CAAE,KAAM,CAAE,OAAQ,MAAO,CAAE,CAAC,EAC9E,GAAI,CACF,IAAM,EAAQ,MAAM,EAAY,KAAK,EAAgB,EAAQ,CAAM,EAC7D,EAAS,EAAM,SAAW,SAC5B,EAAY,aAAa,EAAM,SAAU,CAAM,EAC/C,IAAA,GAGJ,OAFA,EAAO,aAAa,EAAW,EAAM,SAAW,WAAa,QAAU,UACrE,EAAM,SAAW,WAAa,CAAE,MAAO,EAAM,KAAM,EAAI,CAAC,CAAC,EACpD,OAAO,OAAO,CAAE,QAAO,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,CAAG,CAAC,CAC7E,OAAS,EAAO,CAEd,MADA,EAAO,aAAa,EAAW,EAAO,QAAU,UAAY,OAAO,EAC7D,CACR,CACF,CAEA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EACA,EACe,CACf,IAAM,EAAS,EAAO,gBAAgB,OACtC,GAAI,IAAW,IAAA,GAAW,MAAU,MAAM,sCAAsC,EAChF,IAAM,EAAY,EAAO,eAAe,SAAU,CAAE,KAAM,CAAE,OAAQ,QAAS,CAAE,CAAC,EAChF,GAAI,CACF,IAAM,EAAY,MAAM,EAAY,OAClC,EAAgB,EAAU,EAAM,SAAU,EAAQ,CACpD,EACA,EAAO,aAAa,EAAW,EAAU,SAAW,WAAa,QAAU,UACzE,EAAU,SAAW,WAAa,CAAE,MAAO,EAAU,KAAM,EAAI,CAAC,CAAC,CACrE,OAAS,EAAO,CAEd,MADA,EAAO,aAAa,EAAW,EAAO,QAAU,UAAY,OAAO,EAC7D,CACR,CACF,CAEA,SAAgB,EACd,EACA,EACA,EACwB,CACxB,IAAM,EAAY,GAAY,eAAe,SAAU,CAAE,KAAM,CAAE,OAAQ,QAAS,CAAE,CAAC,EACrF,GAAI,CACF,IAAM,EAAU,EAAO,OAAO,CAAgB,EAE9C,OADI,IAAc,IAAA,IAAW,GAAY,aAAa,EAAW,SAAS,EACnE,EAAQ,SAAW,EAAI,CAAC,EAAI,CAAC,EAAkB,CACpD,OAAQ,CAAE,KAAM,MAAO,SAAU,mBAAoB,EACrD,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,CAAQ,CAAC,CAC3C,CAAC,CAAC,CACJ,OAAS,EAAO,CAEd,MADI,IAAc,IAAA,IAAW,GAAY,aAAa,EAAW,QAAS,CAAE,OAAM,CAAC,EAC7E,CACR,CACF,CAEA,SAAgB,EACd,EACA,EACA,EACM,CACN,GAAI,CAAC,EAAS,OACd,IAAM,EAAQ,EAAQ,QAAQ,CAAC,CAAC,KAAK,GAAS,EAAM,MAAM,OAAS,QAC9D,EAAM,MAAM,QAAQ,OAAS,QAAU,EAAM,MAAM,QAAQ,OAAO,OAAS,MAAM,EAClF,GAAO,MAAM,OAAS,QAAU,EAAc,EAAM,MAAM,OAAO,GACnE,EAAO,yBAAyB,EAAM,MAAM,OAAO,CAEvD"}

package/dist/agent/define/session/skills.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../../../errors/agent-sdk-error.js";import{captureSkillReference as t}from"../../skill/provider/snapshot.js";function n(n,r){let i=Object.freeze([...n?.activated??[]].map(e=>e.catalogRevision===void 0?Object.freeze({id:e.id,provider:e.provider,source:e.source,...e.resourceBase===void 0?{}:{resourceBase:Object.freeze({...e.resourceBase})}}):t(e)));for(let t of i)if(t.catalogRevision!==void 0){if(r===void 0)throw new e(`Persisted skill reference has no matching provider`,`SKILL_REFERENCE_INVALID`);r.validateReferenceOwner(t)}return i}async function r(e,t,n,r,i,a,o){let s=o?.startOperation(`skill`,{data:{action:`discover-and-restore`}}),c=AbortSignal.any([AbortSignal.timeout(e.skillOptions.operationTimeoutMs),...a===void 0?[]:[a]]);try{if(t===void 0){if(n.length>0)throw Error(`agent '${e.id}' cannot restore activated skills without skill sources`);s!==void 0&&o?.endOperation(s,`success`);return}for(let e of n)e.catalogRevision!==void 0&&t.validateReferenceOwner(e);let a=r(c);if(await t.discover(a),n.length===0){s!==void 0&&o?.endOperation(s,`success`);return}for(let e of n){if(e.catalogRevision!==void 0){await t.restoreReference(e,a);continue}let n=t.summaries().find(t=>t.id===e.id);if(n===void 0)throw Error(`cannot restore activated skill '${e.id}'; it is no longer available`);if(n.provider!==e.provider||n.source!==e.source)throw Error(`cannot restore activated skill '${e.id}'; its provider or source changed`);if(n.resourceBase?.kind!==e.resourceBase?.kind||n.resourceBase?.value!==e.resourceBase?.value)throw Error(`cannot restore activated skill '${e.id}'; its resource location changed`);if(await t.activate(e.id,a)===void 0)throw Error(`cannot restore activated skill '${e.id}'; its definition is unavailable`)}i(),s!==void 0&&o?.endOperation(s,`success`)}catch(e){throw t?.clearActivations(),s!==void 0&&o?.endOperation(s,c.aborted?`aborted`:`error`,{error:e}),e}}export{n as captureResumedSkillActivations,r as prepareSkills};
+//# sourceMappingURL=skills.js.map