@warlock.js/core 4.8.0 → 4.8.1

package/esm/ai/src/image/image.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"image.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/image/image.ts"],"sourcesContent":["import type {\n  GeneratedImage,\n  ImageModelContract,\n} from \"../contracts/image-model.contract\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\nimport type { ExecuteResult } from \"../contracts/result/execute-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { AIError } from \"../errors/ai-error\";\nimport { ProviderError } from \"../errors/provider-error\";\nimport type { FlowObserveOption } from \"../observe/resolve-observers\";\nimport { notifyObservers } from \"../observe/resolve-observers\";\nimport { generateRunId } from \"../utils/generate-run-id\";\nimport { stampReportLineage } from \"../utils/stamp-report-lineage\";\nimport { computeImageCost } from \"./image-cost\";\n\n/**\n * Parameters for {@link image}. `model` comes from an adapter's\n * `image()` factory (`openai.image({ name })` / `google.image({ name })`);\n * the rest are provider-neutral generation knobs plus the standard\n * observability seam every verb shares.\n */\nexport type ImageParams = {\n  /** The image model to generate from (`sdk.image({ name })`). */\n  model: ImageModelContract;\n  /** Text description of the image(s) to generate. */\n  prompt: string;\n  /** How many images to generate. Adapters clamp to the provider max. */\n  count?: number;\n  /** Requested pixel size as `\"WxH\"` (e.g. `\"1024x1024\"`). */\n  size?: string;\n  /** Quality tier (e.g. `\"standard\"` / `\"hd\"`). */\n  quality?: string;\n  /** Aspect ratio (e.g. `\"1:1\"`, `\"16:9\"`) — ratio-based providers (Imagen). */\n  aspectRatio?: string;\n  /** Concepts to steer away from (Imagen `negativePrompt`). */\n  negativePrompt?: string;\n  /** Output container hint (`\"png\"` / `\"jpeg\"` / `\"webp\"`). */\n  format?: string;\n  /** Cancellation handle, wired into the provider request where supported. */\n  signal?: AbortSignal;\n  /**\n   * Observability routing for this call — same `observe` seam as\n   * agents / workflows. `true` routes to the globally registered\n   * observers; an `Observer` object routes flow-locally; `false` opts\n   * out; omitted follows the global observe-all flag.\n   */\n  observe?: FlowObserveOption;\n  /** Groups this call into a session for flat cost/trace queries. */\n  sessionId?: string;\n  /** Report node name (defaults to `\"image\"`). */\n  name?: string;\n  /** Provider-specific options forwarded verbatim to the adapter. */\n  options?: Record<string, unknown>;\n};\n\n/** Success payload of an {@link image} run. */\nexport type ImageData = {\n  /** The generated images, normalized to the discriminated shape. */\n  images: GeneratedImage[];\n};\n\n/**\n * The report node an {@link image} run produces — a {@link BaseReport}\n * (`type: \"image\"`) plus which model ran and how many images came back,\n * so panoptic and any flat-row consumer attribute the cost/latency\n * without special-casing.\n */\nexport type ImageReport = BaseReport & {\n  type: \"image\";\n  /** Identity of the image model this run used. */\n  model: { name: string; provider: string };\n  /** Number of images returned (0 on failure). */\n  imageCount: number;\n};\n\n/**\n * Result envelope of {@link image} — the same uniform\n * `{ data, error, usage, report }` every executable returns, narrowed\n * with the `\"image\"` discriminant.\n */\nexport type ImageResult = ExecuteResult<ImageData> & {\n  type: \"image\";\n  report: ImageReport;\n};\n\n/**\n * Generate one or more images from a text prompt — the image-output\n * counterpart to `ai.agent`, and the first verb of the output-modality\n * track (Theme I). Wraps an {@link ImageModelContract} (from\n * `openai.image(...)` / `google.image(...)`) in the framework's uniform\n * result contract:\n *\n * - **Never throws.** Provider failures (auth, rate-limit,\n *   content-filter, invalid request) surface as a typed `AIError` on\n *   `result.error`; `result.data` is then `undefined`.\n * - **Cost-truth.** When the model carries pricing, `result.usage.cost`\n *   is filled in — per-token for gpt-image-1, per-image for\n *   DALL·E / Imagen — folding into the same `Usage.cost` rollup as text.\n * - **Observable.** The completed {@link ImageReport} routes to any\n *   registered `Observer` (panoptic, OTel, …) via the shared `observe`\n *   seam, exactly like an agent run.\n *\n * @example\n * const openai = new OpenAISDK({ apiKey });\n * const { data, error, usage } = await ai.image({\n *   model: openai.image({ name: \"gpt-image-1\" }),\n *   prompt: \"an isometric office desk, soft studio lighting\",\n *   size: \"1024x1024\",\n * });\n *\n * if (error) console.warn(error.code);\n * else for (const img of data.images) save(img); // { type: \"base64\" | \"url\", ... }\n */\nexport async function image(params: ImageParams): Promise<ImageResult> {\n  const { model, prompt } = params;\n\n  const runId = generateRunId(\"image\");\n  const startedAt = new Date().toISOString();\n  const startPerf = performance.now();\n\n  const usage: Usage = { input: 0, output: 0, total: 0 };\n  let data: ImageData | undefined;\n  let error: AIError | undefined;\n  let status: ImageReport[\"status\"] = \"completed\";\n  let imageCount = 0;\n\n  try {\n    const response = await model.generate(prompt, {\n      count: params.count,\n      size: params.size,\n      quality: params.quality,\n      aspectRatio: params.aspectRatio,\n      negativePrompt: params.negativePrompt,\n      format: params.format,\n      signal: params.signal,\n      ...params.options,\n    });\n\n    // Preserve every usage channel the adapter reported (cached /\n    // reasoning / cache-write, and any adapter-supplied `cost`), mirroring\n    // how the agent path routes provider usage. Then honor a pre-priced\n    // response or compute image cost — `usage.cost ??= …` precedence, same\n    // as the agent path.\n    Object.assign(usage, response.usage);\n\n    if (usage.cost === undefined) {\n      const cost = computeImageCost(usage, response.images.length, params.size, model.pricing);\n      if (cost !== undefined) {\n        usage.cost = cost;\n      }\n    }\n\n    data = { images: response.images };\n    imageCount = response.images.length;\n  } catch (thrown) {\n    error = thrown instanceof AIError ? thrown : new ProviderError(toMessage(thrown), { cause: thrown });\n    // A caller-aborted run is \"cancelled\", not \"failed\" — keep the typed\n    // cause but distinguish the terminal status for dashboards/retry policy.\n    status = params.signal?.aborted ? \"cancelled\" : \"failed\";\n  }\n\n  const report: ImageReport = {\n    runId,\n    rootRunId: runId,\n    name: params.name ?? \"image\",\n    type: \"image\",\n    status,\n    error,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    usage,\n    children: [],\n    model: { name: model.name, provider: model.provider },\n    imageCount,\n    reportSchemaVersion: REPORT_SCHEMA_VERSION,\n  };\n\n  stampReportLineage(report, { rootRunId: runId, sessionId: params.sessionId });\n\n  await notifyObservers(params.observe, report);\n\n  return { type: \"image\", data, error, usage, report };\n}\n\n/** Best-effort message for a non-`AIError` thrown value. */\nfunction toMessage(thrown: unknown): string {\n  return thrown instanceof Error ? thrown.message : String(thrown);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkHA,eAAsB,MAAM,QAA2C;CACrE,MAAM,EAAE,OAAO,WAAW;CAE1B,MAAM,QAAQ,cAAc,OAAO;CACnC,MAAM,6BAAY,IAAI,KAAK,EAAC,CAAC,YAAY;CACzC,MAAM,YAAY,YAAY,IAAI;CAElC,MAAM,QAAe;EAAE,OAAO;EAAG,QAAQ;EAAG,OAAO;CAAE;CACrD,IAAI;CACJ,IAAI;CACJ,IAAI,SAAgC;CACpC,IAAI,aAAa;CAEjB,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,SAAS,QAAQ;GAC5C,OAAO,OAAO;GACd,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,aAAa,OAAO;GACpB,gBAAgB,OAAO;GACvB,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf,GAAG,OAAO;EACZ,CAAC;EAOD,OAAO,OAAO,OAAO,SAAS,KAAK;EAEnC,IAAI,MAAM,SAAS,QAAW;GAC5B,MAAM,OAAO,iBAAiB,OAAO,SAAS,OAAO,QAAQ,OAAO,MAAM,MAAM,OAAO;GACvF,IAAI,SAAS,QACX,MAAM,OAAO;EAEjB;EAEA,OAAO,EAAE,QAAQ,SAAS,OAAO;EACjC,aAAa,SAAS,OAAO;CAC/B,SAAS,QAAQ;EACf,QAAQ,kBAAkB,UAAU,SAAS,IAAI,cAAc,UAAU,MAAM,GAAG,EAAE,OAAO,OAAO,CAAC;EAGnG,SAAS,OAAO,QAAQ,UAAU,cAAc;CAClD;CAEA,MAAM,SAAsB;EAC1B;EACA,WAAW;EACX,MAAM,OAAO,QAAQ;EACrB,MAAM;EACN;EACA;EACA;EACA,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;EAChC,UAAU,YAAY,IAAI,IAAI;EAC9B;EACA,UAAU,CAAC;EACX,OAAO;GAAE,MAAM,MAAM;GAAM,UAAU,MAAM;EAAS;EACpD;EACA;CACF;CAEA,mBAAmB,QAAQ;EAAE,WAAW;EAAO,WAAW,OAAO;CAAU,CAAC;CAE5E,MAAM,gBAAgB,OAAO,SAAS,MAAM;CAE5C,OAAO;EAAE,MAAM;EAAS;EAAM;EAAO;EAAO;CAAO;AACrD;;AAGA,SAAS,UAAU,QAAyB;CAC1C,OAAO,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM;AACjE"}

package/esm/ai/src/image/index.mjs

@@ -1,4 +0,0 @@
-import { computeImageCost } from "./image-cost.mjs";
-import { image } from "./image.mjs";
-
-export {  };

package/esm/ai/src/index.mjs

@@ -1,196 +0,0 @@
-import { AIError } from "./errors/ai-error.mjs";
-import { AgentExecutionError } from "./errors/agent-execution-error.mjs";
-import { AgentCancelledError } from "./errors/agent-cancelled-error.mjs";
-import { AgentDriftError } from "./errors/agent-drift-error.mjs";
-import { AgentMaxTripsError } from "./errors/agent-max-trips-error.mjs";
-import { BudgetExceededError } from "./errors/budget-exceeded-error.mjs";
-import { ProviderError } from "./errors/provider-error.mjs";
-import { GuardrailViolationError } from "./errors/guardrail-violation-error.mjs";
-import { InvalidRequestError } from "./errors/invalid-request-error.mjs";
-import { SupervisorFailedError } from "./errors/supervisor-failed-error.mjs";
-import { MaxIterationsError } from "./errors/max-iterations-error.mjs";
-import { WorkflowError } from "./errors/workflow-error.mjs";
-import { MaxStepsExceededError } from "./errors/max-steps-exceeded-error.mjs";
-import { OrchestratorFailedError } from "./errors/orchestrator-failed-error.mjs";
-import { OrchestratorConfigError } from "./errors/orchestrator-config-error.mjs";
-import { OrchestratorDriftError } from "./errors/orchestrator-drift-error.mjs";
-import { OutboundPolicyError } from "./errors/outbound-policy-error.mjs";
-import { PlannerFailedError } from "./errors/planner-failed-error.mjs";
-import { PlannerCancelledError } from "./errors/planner-cancelled-error.mjs";
-import { PlannerDriftError } from "./errors/planner-drift-error.mjs";
-import { PlannerPlanInvalidError } from "./errors/planner-plan-invalid-error.mjs";
-import { PromptRefinementError } from "./errors/prompt-refinement-error.mjs";
-import { RoutingError } from "./errors/routing-error.mjs";
-import { SchemaValidationError } from "./errors/schema-validation-error.mjs";
-import { StepFailedError } from "./errors/step-failed-error.mjs";
-import { SupervisorCancelledError } from "./errors/supervisor-cancelled-error.mjs";
-import { SupervisorDriftError } from "./errors/supervisor-drift-error.mjs";
-import { SupervisorRoutingError } from "./errors/supervisor-routing-error.mjs";
-import { ToolExecutionError } from "./errors/tool-execution-error.mjs";
-import { WorkflowCancelledError } from "./errors/workflow-cancelled-error.mjs";
-import { WorkflowDriftError } from "./errors/workflow-drift-error.mjs";
-import "./errors/index.mjs";
-import { accumulateCost, computeCost, mergeUsage } from "./utils/compute-cost.mjs";
-import { extractJsonPayload } from "./utils/extract-json-payload.mjs";
-import { extractJsonLenient } from "./utils/extract-json-lenient.mjs";
-import { generateRunId } from "./utils/generate-run-id.mjs";
-import { extractJsonSchema } from "./utils/json-schema.mjs";
-import { isPrivateOrReservedIp } from "./security/private-ip.mjs";
-import { assertUrlAllowed, fetchTextWithPolicy, guardedFetch, readTextCapped, resolveOutboundPolicy } from "./security/outbound-policy.mjs";
-import { resolveAttachment } from "./utils/resolve-attachment.mjs";
-import { prepareAttachmentPart } from "./utils/prepare-attachment-part.mjs";
-import { captureChildReport, withRunFrame, withoutRunFrame } from "./utils/run-context.mjs";
-import { safeJsonParse } from "./utils/safe-json-parse.mjs";
-import { stampReportLineage } from "./utils/stamp-report-lineage.mjs";
-import "./utils/index.mjs";
-import { judge } from "./eval/judge-scorer.mjs";
-import { diff } from "./eval/regression.mjs";
-import { runEval } from "./eval/eval-runner.mjs";
-import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
-import { namespacedState } from "./middleware/utils/namespaced-state.mjs";
-import { budget, readBudgetFallbackSignal } from "./middleware/builtins/budget.mjs";
-import { resolveDefaultCheckpointStore, resolveDefaultSnapshotStore, resolveDefaultStore, setAIConfig } from "./config.mjs";
-import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
-import { composeMiddleware } from "./middleware/helpers/compose.mjs";
-import { forTool } from "./middleware/helpers/for-tool.mjs";
-import { runPipeline } from "./middleware/pipeline.mjs";
-import "./middleware/index.mjs";
-import { getObservers, isObserveAll } from "./observe/observer-registry.mjs";
-import { resolveObservers } from "./observe/resolve-observers.mjs";
-import { buildCatalog, loadRecord, renderCatalogPrompt, semanticPreselect } from "./skills/catalog.mjs";
-import { tool } from "./tool/tool.mjs";
-import { loadSkillTool } from "./skills/load-skill-tool.mjs";
-import { saveSkillTool } from "./skills/save-skill-tool.mjs";
-import { parseFrontmatter, parseTags } from "./skills/sources/parse-frontmatter.mjs";
-import { directorySource } from "./skills/sources/directory-source.mjs";
-import { storeSource } from "./skills/sources/store-source.mjs";
-import { urlSource } from "./skills/sources/url-source.mjs";
-import { resolveSource } from "./skills/sources/index.mjs";
-import { skills } from "./skills/skills.mjs";
-import { memory } from "./memory/memory.mjs";
-import "./skills/index.mjs";
-import { executableToTool, isExecutableTool, normalizeAgentTools } from "./tool/executable-as-tool.mjs";
-import { createAgentStream } from "./agent/agent-stream.mjs";
-import { agent } from "./agent/agent.mjs";
-import { spawnSubAgent } from "./agent/spawn-sub-agent.mjs";
-import "./agent/index.mjs";
-import { batch } from "./batch/batch.mjs";
-import "./batch/index.mjs";
-import { parsePartialJson } from "./object-stream/parse-partial-json.mjs";
-import { streamObject } from "./object-stream/stream-object.mjs";
-import "./object-stream/index.mjs";
-import { SSE_DONE, encodeSSE } from "./serve/sse.mjs";
-import { streamToSSE } from "./serve/stream-to-sse.mjs";
-import { serve } from "./serve/serve.mjs";
-import { memory as memory$1 } from "./checkpoint/memory.mjs";
-import { pg } from "./checkpoint/pg.mjs";
-import { redis } from "./checkpoint/redis.mjs";
-import { fromJSON, toJSON } from "./eval/report-json.mjs";
-import { toJUnit } from "./eval/report-junit.mjs";
-import { contains, exact, predicate } from "./eval/scorers.mjs";
-import { dataset } from "./eval/dataset.mjs";
-import { evalScorers } from "./eval/index.mjs";
-import { ApprovalRejectedError, InterruptSuspendedError } from "./human/errors.mjs";
-import { evaluatePolicy } from "./human/policy.mjs";
-import { humanApproval } from "./human/human-approval.mjs";
-import { resume } from "./human/resume.mjs";
-import { memory as memory$2 } from "./human/stores/memory.mjs";
-import { pg as pg$1 } from "./human/stores/pg.mjs";
-import { redis as redis$1 } from "./human/stores/redis.mjs";
-import "./human/stores/index.mjs";
-import { computeImageCost } from "./image/image-cost.mjs";
-import { image } from "./image/image.mjs";
-import "./image/index.mjs";
-import { speech } from "./speech/speech.mjs";
-import "./speech/index.mjs";
-import { audioFromBuffer, audioFromFile, audioMediaTypeForFilename } from "./transcribe/audio-input.mjs";
-import { transcribe } from "./transcribe/transcribe.mjs";
-import "./transcribe/index.mjs";
-import { injection } from "./guard/detectors/injection.mjs";
-import { pii } from "./guard/detectors/pii.mjs";
-import { topic } from "./guard/detectors/topic.mjs";
-import { OPENAI_INSTALL_INSTRUCTIONS } from "./guard/errors.mjs";
-import { moderation } from "./guard/detectors/moderation.mjs";
-import "./guard/detectors/index.mjs";
-import { guard } from "./guard/guard.mjs";
-import { guardrail } from "./guard/guardrail.mjs";
-import { END } from "./contracts/end.type.mjs";
-import { mockRouter } from "./mock/mock-router.mjs";
-import "./mock/index.mjs";
-import { fallbackModel } from "./model/fallback-model.mjs";
-import "./model/index.mjs";
-import { asTool } from "./orchestrator/as-tool.mjs";
-import { createCommandDispatcher } from "./orchestrator/commands.mjs";
-import { OrchestratorEmitter } from "./orchestrator/emitter.mjs";
-import { injectMemories, memoryQueryFromInput, outcomeTextFromTurn, recallForTurn, rememberTurnOutcome, resolveOrchestratorMemory } from "./orchestrator/memory.mjs";
-import { asTool as asTool$1 } from "./supervisor/as-tool.mjs";
-import { SupervisorEmitter } from "./supervisor/emitter.mjs";
-import { resolveIntentEntries } from "./supervisor/entries.mjs";
-import { createCancelledError } from "./supervisor/cancellation.mjs";
-import { buildRouterContextMessage } from "./supervisor/router-prompt.mjs";
-import { loadSnapshotForResume, persistSupervisorSnapshot } from "./supervisor/snapshot.mjs";
-import { SupervisorExecution } from "./supervisor/execution.mjs";
-import { computeSignature } from "./supervisor/signature.mjs";
-import { createSupervisorStream } from "./supervisor/supervisor-stream.mjs";
-import { supervisor } from "./supervisor/supervisor.mjs";
-import { OrchestratorExecution, runResume, runTurn } from "./orchestrator/execution.mjs";
-import { createOrchestratorStream } from "./orchestrator/orchestrator-stream.mjs";
-import { inProcessSessionLock, noopSessionLock } from "./orchestrator/session-lock.mjs";
-import { computeOrchestratorSignature } from "./orchestrator/signature.mjs";
-import { orchestrator } from "./orchestrator/orchestrator.mjs";
-import "./orchestrator/index.mjs";
-import { buildPlanSystemPrompt } from "./planner/plan-prompt.mjs";
-import { planSchema } from "./planner/plan-schema.mjs";
-import { computeSignature as computeSignature$1 } from "./planner/signature.mjs";
-import { planner } from "./planner/planner.mjs";
-import "./planner/index.mjs";
-import { renderPlaceholders } from "./system-prompt/render-placeholders.mjs";
-import { Instruction, instruction } from "./system-prompt/instruction.mjs";
-import { Persona, persona } from "./system-prompt/persona.mjs";
-import { RefinedSystemPrompt } from "./system-prompt/refined-system-prompt.mjs";
-import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
-import { defaultPromptsManager, promptKey, prompts } from "./prompts/prompts-manager.mjs";
-import { chunk } from "./rag/chunk/chunk.mjs";
-import { cacheVectorStore } from "./rag/store/cache-vector-store.mjs";
-import { rag } from "./rag/rag.mjs";
-import { pgVectorStore, vectorLiteral } from "./rag/store/pg-vector-store.mjs";
-import { loadText } from "./rag/loaders/load-text.mjs";
-import { loadHtml } from "./rag/loaders/load-html.mjs";
-import { loadWeb } from "./rag/loaders/load-web.mjs";
-import { PDF_PARSE_INSTALL_INSTRUCTIONS } from "./rag/loaders/errors.mjs";
-import { loadPdf } from "./rag/loaders/load-pdf.mjs";
-import { keywordReranker } from "./rag/rerank/keyword-reranker.mjs";
-import { llmReranker } from "./rag/rerank/llm-reranker.mjs";
-import { reciprocalRankFusion } from "./rag/hybrid/rrf.mjs";
-import { bm25Rank } from "./rag/hybrid/bm25.mjs";
-import { hybridRank } from "./rag/hybrid/hybrid-rank.mjs";
-import { multiQuery } from "./rag/transforms/multi-query.mjs";
-import "./rag/index.mjs";
-import { PromptNotFoundError, PromptValidationError } from "./prompt/errors.mjs";
-import { prompt } from "./prompt/prompt.mjs";
-import "./prompt/index.mjs";
-import { DEFAULT_SENSITIVE_KEYS, redact } from "./security/redact.mjs";
-import { VcrCassetteMissError } from "./vcr/errors.mjs";
-import { DEFAULT_HASH_OPTIONS, hashRequest } from "./vcr/hash-request.mjs";
-import { vcr } from "./vcr/vcr.mjs";
-import "./vcr/index.mjs";
-import { memory as memory$3 } from "./snapshot/memory.mjs";
-import { pg as pg$2 } from "./snapshot/pg.mjs";
-import { redis as redis$2 } from "./snapshot/redis.mjs";
-import { fanOut } from "./supervisor/fan-out.mjs";
-import { router } from "./supervisor/router-factory.mjs";
-import "./supervisor/index.mjs";
-import { team } from "./team/team.mjs";
-import { step } from "./workflow/step.mjs";
-import { computeSignature as computeSignature$2 } from "./workflow/signature.mjs";
-import { workflow } from "./workflow/workflow.mjs";
-import { ai } from "./ai.mjs";
-import "./observe/index.mjs";
-import "./prompts/index.mjs";
-import "./security/index.mjs";
-import "./team/index.mjs";
-import "./system-prompt/index.mjs";
-import "./tool/index.mjs";
-import "./workflow/index.mjs";
-
-export { ai };

package/esm/ai/src/memory/derive-id.mjs

@@ -1,24 +0,0 @@
-//#region ../@warlock.js/ai/src/memory/derive-id.ts
-/**
-* Derive a stable memory id from its text when the caller didn't supply
-* one. Re-remembering identical text therefore lands on the same id and
-* overwrites in place rather than duplicating.
-*
-* FNV-1a variant — cheap, dependency-free, collision-resistant enough
-* for de-duplicating memory entries. NOT cryptographic: a collision
-* would merge two distinct memories, not breach security in the current
-* trust model. Mirrors the prompt hash in
-* `middleware/builtins/semantic-cache.ts`.
-*/
-function deriveMemoryId(text) {
-	let hash = 2166136261;
-	for (let index = 0; index < text.length; index++) {
-		hash ^= text.charCodeAt(index);
-		hash = Math.imul(hash, 16777619);
-	}
-	return (hash >>> 0).toString(16);
-}
-
-//#endregion
-export { deriveMemoryId };
-//# sourceMappingURL=derive-id.mjs.map

package/esm/ai/src/memory/derive-id.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive-id.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/memory/derive-id.ts"],"sourcesContent":["/**\n * Derive a stable memory id from its text when the caller didn't supply\n * one. Re-remembering identical text therefore lands on the same id and\n * overwrites in place rather than duplicating.\n *\n * FNV-1a variant — cheap, dependency-free, collision-resistant enough\n * for de-duplicating memory entries. NOT cryptographic: a collision\n * would merge two distinct memories, not breach security in the current\n * trust model. Mirrors the prompt hash in\n * `middleware/builtins/semantic-cache.ts`.\n */\nexport function deriveMemoryId(text: string): string {\n  let hash = 0x811c9dc5;\n\n  for (let index = 0; index < text.length; index++) {\n    hash ^= text.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n\n  return (hash >>> 0).toString(16);\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,eAAe,MAAsB;CACnD,IAAI,OAAO;CAEX,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;EAChD,QAAQ,KAAK,WAAW,KAAK;EAC7B,OAAO,KAAK,KAAK,MAAM,QAAU;CACnC;CAEA,QAAQ,SAAS,EAAC,CAAE,SAAS,EAAE;AACjC"}

package/esm/ai/src/memory/episodic-memory.mjs

@@ -1,106 +0,0 @@
-import { deriveMemoryId } from "./derive-id.mjs";
-
-//#region ../@warlock.js/ai/src/memory/episodic-memory.ts
-/**
-* How many extra candidates to pull from `similar()` before re-ranking by
-* the recency-blended score and slicing to `k`. Recency can promote a
-* slightly-less-similar-but-recent episode past a stale exact match, so
-* the raw top-`k` by similarity alone would miss it — overscan, then
-* re-rank.
-*/
-const RECALL_OVERSCAN = 5;
-/**
-* Episodic recall tier (memory core M2).
-*
-* Holds a durable, timestamped log of *what happened* — events/episodes —
-* and retrieves the ones most relevant to a query, **blended with
-* recency** so recent episodes outrank stale ones at equal similarity.
-* That recency weighting is the whole difference from the {@link
-* import("./semantic-memory").SemanticMemory} tier (pure similarity over
-* timeless facts): episodic memory is time-anchored.
-*
-* Like the semantic tier it delegates the similarity search to the
-* `@warlock.js/cache` driver's `similar()` and never implements ANN
-* itself; it adds a stored `ts` per entry and a decay curve at recall.
-* The blended `score` stays in `[0, 1]` so a consumer can merge episodic
-* hits with the other tiers and sort on one field.
-*
-* Internal to the `memory()` factory — never exported on the package
-* surface.
-*/
-var EpisodicMemory = class {
-	constructor(embedder, store, namespace, recencyWeight, halfLifeMs, now) {
-		this.embedder = embedder;
-		this.store = store;
-		this.namespace = namespace;
-		this.recencyWeight = recencyWeight;
-		this.halfLifeMs = halfLifeMs;
-		this.now = now;
-	}
-	/**
-	* Embed the episode text and index it under a namespaced, id-derived
-	* key, stamping the current time. Re-remembering the same id overwrites
-	* the prior entry (and refreshes its timestamp).
-	*/
-	async remember(item) {
-		const id = item.id ?? deriveMemoryId(item.text);
-		const { vector } = await this.embedder.embed(item.text);
-		const value = {
-			id,
-			text: item.text,
-			ts: this.now(),
-			metadata: item.metadata
-		};
-		await this.store.set(this.keyFor(id), value, { vector });
-	}
-	/**
-	* Embed `query`, pull the nearest episodes clearing the similarity
-	* `threshold`, then re-rank each by a recency-blended score before
-	* returning the top `k`. The similarity floor still gates relevance —
-	* recency only reorders episodes that already cleared it, it never
-	* surfaces an irrelevant-but-recent one.
-	*/
-	async recall(query, k, threshold) {
-		const { vector } = await this.embedder.embed(query);
-		const hits = await this.store.similar(vector, {
-			topK: Math.max(k * RECALL_OVERSCAN, k),
-			threshold
-		});
-		const prefix = `${this.namespace}.`;
-		const now = this.now();
-		return hits.filter((hit) => hit.key.startsWith(prefix)).map((hit) => ({
-			id: hit.value.id,
-			text: hit.value.text,
-			tier: "episodic",
-			score: this.blend(hit.score, hit.value.ts, now),
-			metadata: hit.value.metadata
-		})).sort((first, second) => second.score - first.score).slice(0, k);
-	}
-	/** Drop every episode written under this instance's namespace. */
-	async clear() {
-		await this.store.removeNamespace(this.namespace);
-	}
-	/**
-	* Combine raw similarity with an exponential recency decay:
-	* `(1 - w)·similarity + w·0.5^(age / halfLife)`. A just-remembered
-	* episode contributes a recency of `1`; one `halfLife` old, `0.5`;
-	* older trends toward `0`. With `recencyWeight` 0 the score is pure
-	* similarity (an opt-out back to semantic-style ranking).
-	*/
-	blend(similarity, ts, now) {
-		const recency = .5 ** (Math.max(0, now - ts) / this.halfLifeMs);
-		return (1 - this.recencyWeight) * similarity + this.recencyWeight * recency;
-	}
-	/**
-	* Namespaced key for an entry. Mirrors the semantic tier's dot
-	* separator so the prefix used here matches the `hit.key` the driver
-	* returns from `similar()`.
-	*/
-	keyFor(id) {
-		return `${this.namespace}.${id}`;
-	}
-};
-
-//#endregion
-export { EpisodicMemory };
-//# sourceMappingURL=episodic-memory.mjs.map

package/esm/ai/src/memory/episodic-memory.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"episodic-memory.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/memory/episodic-memory.ts"],"sourcesContent":["import type { CacheDriver, CacheSimilarHit } from \"@warlock.js/cache\";\nimport type { EmbedderContract } from \"../contracts/embedder.contract\";\nimport type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport { deriveMemoryId } from \"./derive-id\";\n\n/**\n * Shape persisted per episode. `ts` is the wall-clock time the episode\n * was remembered — the basis for the recency half of the blended recall\n * score. The vector lives in the driver's index (via `set({ vector })`),\n * so it is not duplicated here.\n */\ntype StoredEpisode = {\n  id: string;\n  text: string;\n  ts: number;\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * How many extra candidates to pull from `similar()` before re-ranking by\n * the recency-blended score and slicing to `k`. Recency can promote a\n * slightly-less-similar-but-recent episode past a stale exact match, so\n * the raw top-`k` by similarity alone would miss it — overscan, then\n * re-rank.\n */\nconst RECALL_OVERSCAN = 5;\n\n/**\n * Episodic recall tier (memory core M2).\n *\n * Holds a durable, timestamped log of *what happened* — events/episodes —\n * and retrieves the ones most relevant to a query, **blended with\n * recency** so recent episodes outrank stale ones at equal similarity.\n * That recency weighting is the whole difference from the {@link\n * import(\"./semantic-memory\").SemanticMemory} tier (pure similarity over\n * timeless facts): episodic memory is time-anchored.\n *\n * Like the semantic tier it delegates the similarity search to the\n * `@warlock.js/cache` driver's `similar()` and never implements ANN\n * itself; it adds a stored `ts` per entry and a decay curve at recall.\n * The blended `score` stays in `[0, 1]` so a consumer can merge episodic\n * hits with the other tiers and sort on one field.\n *\n * Internal to the `memory()` factory — never exported on the package\n * surface.\n */\nexport class EpisodicMemory {\n  public constructor(\n    private readonly embedder: EmbedderContract,\n    private readonly store: CacheDriver<any, any>,\n    private readonly namespace: string,\n    private readonly recencyWeight: number,\n    private readonly halfLifeMs: number,\n    private readonly now: () => number,\n  ) {}\n\n  /**\n   * Embed the episode text and index it under a namespaced, id-derived\n   * key, stamping the current time. Re-remembering the same id overwrites\n   * the prior entry (and refreshes its timestamp).\n   */\n  public async remember(item: MemoryItem): Promise<void> {\n    const id = item.id ?? deriveMemoryId(item.text);\n    const { vector } = await this.embedder.embed(item.text);\n\n    const value: StoredEpisode = {\n      id,\n      text: item.text,\n      ts: this.now(),\n      metadata: item.metadata,\n    };\n\n    await this.store.set(this.keyFor(id), value, { vector });\n  }\n\n  /**\n   * Embed `query`, pull the nearest episodes clearing the similarity\n   * `threshold`, then re-rank each by a recency-blended score before\n   * returning the top `k`. The similarity floor still gates relevance —\n   * recency only reorders episodes that already cleared it, it never\n   * surfaces an irrelevant-but-recent one.\n   */\n  public async recall(\n    query: string,\n    k: number,\n    threshold: number,\n  ): Promise<RecalledMemory[]> {\n    const { vector } = await this.embedder.embed(query);\n\n    const hits = await this.store.similar<StoredEpisode>(vector, {\n      topK: Math.max(k * RECALL_OVERSCAN, k),\n      threshold,\n    });\n\n    const prefix = `${this.namespace}.`;\n    const now = this.now();\n\n    return hits\n      .filter((hit: CacheSimilarHit<StoredEpisode>) =>\n        hit.key.startsWith(prefix),\n      )\n      .map((hit: CacheSimilarHit<StoredEpisode>) => ({\n        id: hit.value.id,\n        text: hit.value.text,\n        tier: \"episodic\" as const,\n        score: this.blend(hit.score, hit.value.ts, now),\n        metadata: hit.value.metadata,\n      }))\n      .sort((first, second) => second.score - first.score)\n      .slice(0, k);\n  }\n\n  /** Drop every episode written under this instance's namespace. */\n  public async clear(): Promise<void> {\n    await this.store.removeNamespace(this.namespace);\n  }\n\n  /**\n   * Combine raw similarity with an exponential recency decay:\n   * `(1 - w)·similarity + w·0.5^(age / halfLife)`. A just-remembered\n   * episode contributes a recency of `1`; one `halfLife` old, `0.5`;\n   * older trends toward `0`. With `recencyWeight` 0 the score is pure\n   * similarity (an opt-out back to semantic-style ranking).\n   */\n  private blend(similarity: number, ts: number, now: number): number {\n    const ageMs = Math.max(0, now - ts);\n    const recency = 0.5 ** (ageMs / this.halfLifeMs);\n\n    return (1 - this.recencyWeight) * similarity + this.recencyWeight * recency;\n  }\n\n  /**\n   * Namespaced key for an entry. Mirrors the semantic tier's dot\n   * separator so the prefix used here matches the `hit.key` the driver\n   * returns from `similar()`.\n   */\n  private keyFor(id: string): string {\n    return `${this.namespace}.${id}`;\n  }\n}\n"],"mappings":";;;;;;;;;;AA4BA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;AAqBxB,IAAa,iBAAb,MAA4B;CAC1B,AAAO,YACL,AAAiB,UACjB,AAAiB,OACjB,AAAiB,WACjB,AAAiB,eACjB,AAAiB,YACjB,AAAiB,KACjB;EANiB;EACA;EACA;EACA;EACA;EACA;CAChB;;;;;;CAOH,MAAa,SAAS,MAAiC;EACrD,MAAM,KAAK,KAAK,MAAM,eAAe,KAAK,IAAI;EAC9C,MAAM,EAAE,WAAW,MAAM,KAAK,SAAS,MAAM,KAAK,IAAI;EAEtD,MAAM,QAAuB;GAC3B;GACA,MAAM,KAAK;GACX,IAAI,KAAK,IAAI;GACb,UAAU,KAAK;EACjB;EAEA,MAAM,KAAK,MAAM,IAAI,KAAK,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,CAAC;CACzD;;;;;;;;CASA,MAAa,OACX,OACA,GACA,WAC2B;EAC3B,MAAM,EAAE,WAAW,MAAM,KAAK,SAAS,MAAM,KAAK;EAElD,MAAM,OAAO,MAAM,KAAK,MAAM,QAAuB,QAAQ;GAC3D,MAAM,KAAK,IAAI,IAAI,iBAAiB,CAAC;GACrC;EACF,CAAC;EAED,MAAM,SAAS,GAAG,KAAK,UAAU;EACjC,MAAM,MAAM,KAAK,IAAI;EAErB,OAAO,KACJ,QAAQ,QACP,IAAI,IAAI,WAAW,MAAM,CAC3B,CAAC,CACA,KAAK,SAAyC;GAC7C,IAAI,IAAI,MAAM;GACd,MAAM,IAAI,MAAM;GAChB,MAAM;GACN,OAAO,KAAK,MAAM,IAAI,OAAO,IAAI,MAAM,IAAI,GAAG;GAC9C,UAAU,IAAI,MAAM;EACtB,EAAE,CAAC,CACF,MAAM,OAAO,WAAW,OAAO,QAAQ,MAAM,KAAK,CAAC,CACnD,MAAM,GAAG,CAAC;CACf;;CAGA,MAAa,QAAuB;EAClC,MAAM,KAAK,MAAM,gBAAgB,KAAK,SAAS;CACjD;;;;;;;;CASA,AAAQ,MAAM,YAAoB,IAAY,KAAqB;EAEjE,MAAM,UAAU,OADF,KAAK,IAAI,GAAG,MAAM,EACJ,IAAI,KAAK;EAErC,QAAQ,IAAI,KAAK,iBAAiB,aAAa,KAAK,gBAAgB;CACtE;;;;;;CAOA,AAAQ,OAAO,IAAoB;EACjC,OAAO,GAAG,KAAK,UAAU,GAAG;CAC9B;AACF"}

package/esm/ai/src/memory/memory.mjs

@@ -1,166 +0,0 @@
-import { resolveDefaultStore } from "../config.mjs";
-import { EpisodicMemory } from "./episodic-memory.mjs";
-import { ProceduralMemory } from "./procedural-memory.mjs";
-import { SemanticMemory } from "./semantic-memory.mjs";
-import { WorkingMemory } from "./working-memory.mjs";
-
-//#region ../@warlock.js/ai/src/memory/memory.ts
-const DEFAULT_NAME = "memory";
-const DEFAULT_SEMANTIC_NAMESPACE = "ai.memory.semantic";
-const DEFAULT_EPISODIC_NAMESPACE = "ai.memory.episodic";
-const DEFAULT_PROCEDURAL_NAMESPACE = "ai.memory.procedural";
-const DEFAULT_K = 5;
-const DEFAULT_THRESHOLD = .7;
-const DEFAULT_RECENCY_WEIGHT = .3;
-const DEFAULT_HALF_LIFE_MS = 10080 * 60 * 1e3;
-const DEFAULT_REINFORCEMENT_WEIGHT = .3;
-/**
-* Create an agent memory store (memory core M2).
-*
-* Wires up to four tiers behind the {@link MemoryContract}: **working**
-* (in-run scratch, recency), **semantic** (durable facts by cosine
-* similarity), **episodic** (durable events, similarity blended with
-* recency), and **procedural** (durable how-tos, similarity blended with
-* reinforcement). The working tier is on by default; the other three each
-* activate only when their config is supplied. The three vector tiers
-* mirror how `semanticCache` delegates similarity to the cache driver's
-* `.similar()`.
-*
-* Resolution happens once here, at construction (loud), rather than per
-* call (silent until first use): a vector-tier config with no `store` and
-* no `ai.config({ defaultStore })` throws now; enabling no tier at all
-* throws now.
-*
-* Decay / forgetting (TTL-based falloff, eviction) remains deferred.
-*
-* @example
-* import { ai } from "@warlock.js/ai";
-* import { MemoryCacheDriver } from "@warlock.js/cache";
-*
-* const store = new MemoryCacheDriver();
-* store.setOptions({});
-*
-* const mem = ai.memory({
-*   semantic: { embedder, store },
-*   defaultTier: "semantic",
-* });
-*
-* await mem.remember({ text: "User prefers concise answers." });
-* const hits = await mem.recall("how should I respond?", { k: 3 });
-*/
-function memory(config = {}) {
-	const name = config.name ?? DEFAULT_NAME;
-	const workingEnabled = config.working ?? true;
-	const defaultK = config.k ?? DEFAULT_K;
-	const defaultThreshold = config.threshold ?? DEFAULT_THRESHOLD;
-	const working = workingEnabled ? new WorkingMemory() : void 0;
-	const semantic = config.semantic ? buildSemanticTier(config.semantic, name) : void 0;
-	const episodic = config.episodic ? buildEpisodicTier(config.episodic, name) : void 0;
-	const procedural = config.procedural ? buildProceduralTier(config.procedural, name) : void 0;
-	const tiers = {
-		working,
-		semantic,
-		episodic,
-		procedural
-	};
-	if (!working && !semantic && !episodic && !procedural) throw new Error(`memory("${name}"): no tier enabled — enable \`working\` (default) or pass a \`semantic\` / \`episodic\` / \`procedural\` config; a memory with no tiers can neither store nor recall`);
-	const defaultTier = config.defaultTier ?? "working";
-	assertTierEnabled(defaultTier, tiers, name);
-	return {
-		name,
-		async remember(items) {
-			const list = Array.isArray(items) ? items : [items];
-			const writes = [];
-			for (const item of list) {
-				const tier = item.tier ?? defaultTier;
-				assertTierEnabled(tier, tiers, name);
-				if (tier === "working") {
-					working.remember(item);
-					continue;
-				}
-				if (tier === "semantic") {
-					writes.push(semantic.remember(item));
-					continue;
-				}
-				if (tier === "episodic") {
-					writes.push(episodic.remember(item));
-					continue;
-				}
-				writes.push(procedural.remember(item));
-			}
-			await Promise.all(writes);
-		},
-		async recall(query, options = {}) {
-			const k = options.k ?? defaultK;
-			const threshold = options.threshold ?? defaultThreshold;
-			if (options.tier) assertTierEnabled(options.tier, tiers, name);
-			const wants = (tier) => !options.tier || options.tier === tier;
-			const [workingHits, semanticHits, episodicHits, proceduralHits] = await Promise.all([
-				working && wants("working") ? Promise.resolve(working.recall(k)) : Promise.resolve([]),
-				semantic && wants("semantic") ? semantic.recall(query, k, threshold) : Promise.resolve([]),
-				episodic && wants("episodic") ? episodic.recall(query, k, threshold) : Promise.resolve([]),
-				procedural && wants("procedural") ? procedural.recall(query, k, threshold) : Promise.resolve([])
-			]);
-			return [
-				...workingHits,
-				...semanticHits,
-				...episodicHits,
-				...proceduralHits
-			].sort((first, second) => second.score - first.score).slice(0, k);
-		},
-		async clear(tier) {
-			const clears = [];
-			if (working && (!tier || tier === "working")) working.clear();
-			if (semantic && (!tier || tier === "semantic")) clears.push(semantic.clear());
-			if (episodic && (!tier || tier === "episodic")) clears.push(episodic.clear());
-			if (procedural && (!tier || tier === "procedural")) clears.push(procedural.clear());
-			await Promise.all(clears);
-		}
-	};
-}
-/**
-* Resolve the semantic tier's store (explicit `store` wins, else the
-* global `ai.config({ defaultStore })`) and build the tier. Throws at
-* construction when neither is available — the same loud-now contract
-* `semanticCache` follows.
-*/
-function buildSemanticTier(semanticConfig, name) {
-	const store = semanticConfig.store ?? resolveDefaultStore();
-	if (!store) throw new Error(`memory("${name}"): semantic tier has no store — pass \`semantic.store\` or call \`ai.config({ defaultStore })\` at app boot before constructing the memory`);
-	return new SemanticMemory(semanticConfig.embedder, store, semanticConfig.namespace ?? DEFAULT_SEMANTIC_NAMESPACE);
-}
-/**
-* Resolve the episodic tier's store (explicit `store` wins, else the
-* global default) and build the tier with its recency knobs. Throws at
-* construction when neither store is available — the same loud-now
-* contract the semantic tier follows.
-*/
-function buildEpisodicTier(episodicConfig, name) {
-	const store = episodicConfig.store ?? resolveDefaultStore();
-	if (!store) throw new Error(`memory("${name}"): episodic tier has no store — pass \`episodic.store\` or call \`ai.config({ defaultStore })\` at app boot before constructing the memory`);
-	return new EpisodicMemory(episodicConfig.embedder, store, episodicConfig.namespace ?? DEFAULT_EPISODIC_NAMESPACE, episodicConfig.recencyWeight ?? DEFAULT_RECENCY_WEIGHT, episodicConfig.halfLifeMs ?? DEFAULT_HALF_LIFE_MS, episodicConfig.now ?? (() => Date.now()));
-}
-/**
-* Resolve the procedural tier's store and build the tier with its
-* reinforcement knob. Throws at construction when no store is available.
-*/
-function buildProceduralTier(proceduralConfig, name) {
-	const store = proceduralConfig.store ?? resolveDefaultStore();
-	if (!store) throw new Error(`memory("${name}"): procedural tier has no store — pass \`procedural.store\` or call \`ai.config({ defaultStore })\` at app boot before constructing the memory`);
-	return new ProceduralMemory(proceduralConfig.embedder, store, proceduralConfig.namespace ?? DEFAULT_PROCEDURAL_NAMESPACE, proceduralConfig.reinforcementWeight ?? DEFAULT_REINFORCEMENT_WEIGHT);
-}
-/**
-* Guard that a tier referenced by config / a call is actually enabled,
-* failing fast with an actionable message instead of a downstream
-* `undefined` dereference.
-*/
-function assertTierEnabled(tier, tiers, name) {
-	if (tier === "working" && !tiers.working) throw new Error(`memory("${name}"): working tier is disabled — set \`working: true\` (the default) to use it`);
-	if (tier === "semantic" && !tiers.semantic) throw new Error(`memory("${name}"): semantic tier is not configured — pass \`semantic\` config to use it`);
-	if (tier === "episodic" && !tiers.episodic) throw new Error(`memory("${name}"): episodic tier is not configured — pass \`episodic\` config to use it`);
-	if (tier === "procedural" && !tiers.procedural) throw new Error(`memory("${name}"): procedural tier is not configured — pass \`procedural\` config to use it`);
-}
-
-//#endregion
-export { memory };
-//# sourceMappingURL=memory.mjs.map

package/esm/ai/src/memory/memory.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/memory/memory.ts"],"sourcesContent":["import { resolveDefaultStore } from \"../config\";\nimport type { MemoryConfig } from \"../contracts/memory/memory-config.type\";\nimport type {\n  MemoryItem,\n  MemoryTier,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport type { MemoryContract } from \"../contracts/memory/memory.contract\";\nimport type { RecallOptions } from \"../contracts/memory/recall-options.type\";\nimport { EpisodicMemory } from \"./episodic-memory\";\nimport { ProceduralMemory } from \"./procedural-memory\";\nimport { SemanticMemory } from \"./semantic-memory\";\nimport { WorkingMemory } from \"./working-memory\";\n\nconst DEFAULT_NAME = \"memory\";\nconst DEFAULT_SEMANTIC_NAMESPACE = \"ai.memory.semantic\";\nconst DEFAULT_EPISODIC_NAMESPACE = \"ai.memory.episodic\";\nconst DEFAULT_PROCEDURAL_NAMESPACE = \"ai.memory.procedural\";\nconst DEFAULT_K = 5;\nconst DEFAULT_THRESHOLD = 0.7;\nconst DEFAULT_RECENCY_WEIGHT = 0.3;\nconst DEFAULT_HALF_LIFE_MS = 7 * 24 * 60 * 60 * 1000;\nconst DEFAULT_REINFORCEMENT_WEIGHT = 0.3;\n\n/**\n * Create an agent memory store (memory core M2).\n *\n * Wires up to four tiers behind the {@link MemoryContract}: **working**\n * (in-run scratch, recency), **semantic** (durable facts by cosine\n * similarity), **episodic** (durable events, similarity blended with\n * recency), and **procedural** (durable how-tos, similarity blended with\n * reinforcement). The working tier is on by default; the other three each\n * activate only when their config is supplied. The three vector tiers\n * mirror how `semanticCache` delegates similarity to the cache driver's\n * `.similar()`.\n *\n * Resolution happens once here, at construction (loud), rather than per\n * call (silent until first use): a vector-tier config with no `store` and\n * no `ai.config({ defaultStore })` throws now; enabling no tier at all\n * throws now.\n *\n * Decay / forgetting (TTL-based falloff, eviction) remains deferred.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n * import { MemoryCacheDriver } from \"@warlock.js/cache\";\n *\n * const store = new MemoryCacheDriver();\n * store.setOptions({});\n *\n * const mem = ai.memory({\n *   semantic: { embedder, store },\n *   defaultTier: \"semantic\",\n * });\n *\n * await mem.remember({ text: \"User prefers concise answers.\" });\n * const hits = await mem.recall(\"how should I respond?\", { k: 3 });\n */\nexport function memory(config: MemoryConfig = {}): MemoryContract {\n  const name = config.name ?? DEFAULT_NAME;\n  const workingEnabled = config.working ?? true;\n  const defaultK = config.k ?? DEFAULT_K;\n  const defaultThreshold = config.threshold ?? DEFAULT_THRESHOLD;\n\n  const working = workingEnabled ? new WorkingMemory() : undefined;\n\n  const semantic = config.semantic\n    ? buildSemanticTier(config.semantic, name)\n    : undefined;\n\n  const episodic = config.episodic\n    ? buildEpisodicTier(config.episodic, name)\n    : undefined;\n\n  const procedural = config.procedural\n    ? buildProceduralTier(config.procedural, name)\n    : undefined;\n\n  const tiers: Tiers = { working, semantic, episodic, procedural };\n\n  if (!working && !semantic && !episodic && !procedural) {\n    throw new Error(\n      `memory(\"${name}\"): no tier enabled — enable \\`working\\` (default) or pass a \\`semantic\\` / \\`episodic\\` / \\`procedural\\` config; a memory with no tiers can neither store nor recall`,\n    );\n  }\n\n  const defaultTier: MemoryTier = config.defaultTier ?? \"working\";\n\n  assertTierEnabled(defaultTier, tiers, name);\n\n  return {\n    name,\n    async remember(items: MemoryItem | MemoryItem[]): Promise<void> {\n      const list = Array.isArray(items) ? items : [items];\n\n      const writes: Promise<void>[] = [];\n\n      for (const item of list) {\n        const tier = item.tier ?? defaultTier;\n\n        assertTierEnabled(tier, tiers, name);\n\n        if (tier === \"working\") {\n          working!.remember(item);\n\n          continue;\n        }\n\n        if (tier === \"semantic\") {\n          writes.push(semantic!.remember(item));\n\n          continue;\n        }\n\n        if (tier === \"episodic\") {\n          writes.push(episodic!.remember(item));\n\n          continue;\n        }\n\n        writes.push(procedural!.remember(item));\n      }\n\n      await Promise.all(writes);\n    },\n    async recall(\n      query: string,\n      options: RecallOptions = {},\n    ): Promise<RecalledMemory[]> {\n      const k = options.k ?? defaultK;\n      const threshold = options.threshold ?? defaultThreshold;\n\n      if (options.tier) {\n        assertTierEnabled(options.tier, tiers, name);\n      }\n\n      const wants = (tier: MemoryTier): boolean =>\n        !options.tier || options.tier === tier;\n\n      const [workingHits, semanticHits, episodicHits, proceduralHits] =\n        await Promise.all([\n          working && wants(\"working\")\n            ? Promise.resolve(working.recall(k))\n            : Promise.resolve([] as RecalledMemory[]),\n          semantic && wants(\"semantic\")\n            ? semantic.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n          episodic && wants(\"episodic\")\n            ? episodic.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n          procedural && wants(\"procedural\")\n            ? procedural.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n        ]);\n\n      return [\n        ...workingHits,\n        ...semanticHits,\n        ...episodicHits,\n        ...proceduralHits,\n      ]\n        .sort((first, second) => second.score - first.score)\n        .slice(0, k);\n    },\n    async clear(tier?: MemoryTier): Promise<void> {\n      const clears: Promise<void>[] = [];\n\n      if (working && (!tier || tier === \"working\")) {\n        working.clear();\n      }\n\n      if (semantic && (!tier || tier === \"semantic\")) {\n        clears.push(semantic.clear());\n      }\n\n      if (episodic && (!tier || tier === \"episodic\")) {\n        clears.push(episodic.clear());\n      }\n\n      if (procedural && (!tier || tier === \"procedural\")) {\n        clears.push(procedural.clear());\n      }\n\n      await Promise.all(clears);\n    },\n  };\n}\n\n/** The four tier instances a `memory()` composes; `undefined` when off. */\ntype Tiers = {\n  working: WorkingMemory | undefined;\n  semantic: SemanticMemory | undefined;\n  episodic: EpisodicMemory | undefined;\n  procedural: ProceduralMemory | undefined;\n};\n\n/**\n * Resolve the semantic tier's store (explicit `store` wins, else the\n * global `ai.config({ defaultStore })`) and build the tier. Throws at\n * construction when neither is available — the same loud-now contract\n * `semanticCache` follows.\n */\nfunction buildSemanticTier(\n  semanticConfig: NonNullable<MemoryConfig[\"semantic\"]>,\n  name: string,\n): SemanticMemory {\n  const store = semanticConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): semantic tier has no store — pass \\`semantic.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new SemanticMemory(\n    semanticConfig.embedder,\n    store,\n    semanticConfig.namespace ?? DEFAULT_SEMANTIC_NAMESPACE,\n  );\n}\n\n/**\n * Resolve the episodic tier's store (explicit `store` wins, else the\n * global default) and build the tier with its recency knobs. Throws at\n * construction when neither store is available — the same loud-now\n * contract the semantic tier follows.\n */\nfunction buildEpisodicTier(\n  episodicConfig: NonNullable<MemoryConfig[\"episodic\"]>,\n  name: string,\n): EpisodicMemory {\n  const store = episodicConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): episodic tier has no store — pass \\`episodic.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new EpisodicMemory(\n    episodicConfig.embedder,\n    store,\n    episodicConfig.namespace ?? DEFAULT_EPISODIC_NAMESPACE,\n    episodicConfig.recencyWeight ?? DEFAULT_RECENCY_WEIGHT,\n    episodicConfig.halfLifeMs ?? DEFAULT_HALF_LIFE_MS,\n    episodicConfig.now ?? (() => Date.now()),\n  );\n}\n\n/**\n * Resolve the procedural tier's store and build the tier with its\n * reinforcement knob. Throws at construction when no store is available.\n */\nfunction buildProceduralTier(\n  proceduralConfig: NonNullable<MemoryConfig[\"procedural\"]>,\n  name: string,\n): ProceduralMemory {\n  const store = proceduralConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): procedural tier has no store — pass \\`procedural.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new ProceduralMemory(\n    proceduralConfig.embedder,\n    store,\n    proceduralConfig.namespace ?? DEFAULT_PROCEDURAL_NAMESPACE,\n    proceduralConfig.reinforcementWeight ?? DEFAULT_REINFORCEMENT_WEIGHT,\n  );\n}\n\n/**\n * Guard that a tier referenced by config / a call is actually enabled,\n * failing fast with an actionable message instead of a downstream\n * `undefined` dereference.\n */\nfunction assertTierEnabled(tier: MemoryTier, tiers: Tiers, name: string): void {\n  if (tier === \"working\" && !tiers.working) {\n    throw new Error(\n      `memory(\"${name}\"): working tier is disabled — set \\`working: true\\` (the default) to use it`,\n    );\n  }\n\n  if (tier === \"semantic\" && !tiers.semantic) {\n    throw new Error(\n      `memory(\"${name}\"): semantic tier is not configured — pass \\`semantic\\` config to use it`,\n    );\n  }\n\n  if (tier === \"episodic\" && !tiers.episodic) {\n    throw new Error(\n      `memory(\"${name}\"): episodic tier is not configured — pass \\`episodic\\` config to use it`,\n    );\n  }\n\n  if (tier === \"procedural\" && !tiers.procedural) {\n    throw new Error(\n      `memory(\"${name}\"): procedural tier is not configured — pass \\`procedural\\` config to use it`,\n    );\n  }\n}\n"],"mappings":";;;;;;;AAcA,MAAM,eAAe;AACrB,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,+BAA+B;AACrC,MAAM,YAAY;AAClB,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAC/B,MAAM,uBAAuB,QAAc,KAAK;AAChD,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCrC,SAAgB,OAAO,SAAuB,CAAC,GAAmB;CAChE,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,iBAAiB,OAAO,WAAW;CACzC,MAAM,WAAW,OAAO,KAAK;CAC7B,MAAM,mBAAmB,OAAO,aAAa;CAE7C,MAAM,UAAU,iBAAiB,IAAI,cAAc,IAAI;CAEvD,MAAM,WAAW,OAAO,WACpB,kBAAkB,OAAO,UAAU,IAAI,IACvC;CAEJ,MAAM,WAAW,OAAO,WACpB,kBAAkB,OAAO,UAAU,IAAI,IACvC;CAEJ,MAAM,aAAa,OAAO,aACtB,oBAAoB,OAAO,YAAY,IAAI,IAC3C;CAEJ,MAAM,QAAe;EAAE;EAAS;EAAU;EAAU;CAAW;CAE/D,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,YACzC,MAAM,IAAI,MACR,WAAW,KAAK,sKAClB;CAGF,MAAM,cAA0B,OAAO,eAAe;CAEtD,kBAAkB,aAAa,OAAO,IAAI;CAE1C,OAAO;EACL;EACA,MAAM,SAAS,OAAiD;GAC9D,MAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;GAElD,MAAM,SAA0B,CAAC;GAEjC,KAAK,MAAM,QAAQ,MAAM;IACvB,MAAM,OAAO,KAAK,QAAQ;IAE1B,kBAAkB,MAAM,OAAO,IAAI;IAEnC,IAAI,SAAS,WAAW;KACtB,QAAS,SAAS,IAAI;KAEtB;IACF;IAEA,IAAI,SAAS,YAAY;KACvB,OAAO,KAAK,SAAU,SAAS,IAAI,CAAC;KAEpC;IACF;IAEA,IAAI,SAAS,YAAY;KACvB,OAAO,KAAK,SAAU,SAAS,IAAI,CAAC;KAEpC;IACF;IAEA,OAAO,KAAK,WAAY,SAAS,IAAI,CAAC;GACxC;GAEA,MAAM,QAAQ,IAAI,MAAM;EAC1B;EACA,MAAM,OACJ,OACA,UAAyB,CAAC,GACC;GAC3B,MAAM,IAAI,QAAQ,KAAK;GACvB,MAAM,YAAY,QAAQ,aAAa;GAEvC,IAAI,QAAQ,MACV,kBAAkB,QAAQ,MAAM,OAAO,IAAI;GAG7C,MAAM,SAAS,SACb,CAAC,QAAQ,QAAQ,QAAQ,SAAS;GAEpC,MAAM,CAAC,aAAa,cAAc,cAAc,kBAC9C,MAAM,QAAQ,IAAI;IAChB,WAAW,MAAM,SAAS,IACtB,QAAQ,QAAQ,QAAQ,OAAO,CAAC,CAAC,IACjC,QAAQ,QAAQ,CAAC,CAAqB;IAC1C,YAAY,MAAM,UAAU,IACxB,SAAS,OAAO,OAAO,GAAG,SAAS,IACnC,QAAQ,QAAQ,CAAC,CAAqB;IAC1C,YAAY,MAAM,UAAU,IACxB,SAAS,OAAO,OAAO,GAAG,SAAS,IACnC,QAAQ,QAAQ,CAAC,CAAqB;IAC1C,cAAc,MAAM,YAAY,IAC5B,WAAW,OAAO,OAAO,GAAG,SAAS,IACrC,QAAQ,QAAQ,CAAC,CAAqB;GAC5C,CAAC;GAEH,OAAO;IACL,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;GACL,CAAC,CACE,MAAM,OAAO,WAAW,OAAO,QAAQ,MAAM,KAAK,CAAC,CACnD,MAAM,GAAG,CAAC;EACf;EACA,MAAM,MAAM,MAAkC;GAC5C,MAAM,SAA0B,CAAC;GAEjC,IAAI,YAAY,CAAC,QAAQ,SAAS,YAChC,QAAQ,MAAM;GAGhB,IAAI,aAAa,CAAC,QAAQ,SAAS,aACjC,OAAO,KAAK,SAAS,MAAM,CAAC;GAG9B,IAAI,aAAa,CAAC,QAAQ,SAAS,aACjC,OAAO,KAAK,SAAS,MAAM,CAAC;GAG9B,IAAI,eAAe,CAAC,QAAQ,SAAS,eACnC,OAAO,KAAK,WAAW,MAAM,CAAC;GAGhC,MAAM,QAAQ,IAAI,MAAM;EAC1B;CACF;AACF;;;;;;;AAgBA,SAAS,kBACP,gBACA,MACgB;CAChB,MAAM,QAAQ,eAAe,SAAS,oBAAoB;CAE1D,IAAI,CAAC,OACH,MAAM,IAAI,MACR,WAAW,KAAK,4IAClB;CAGF,OAAO,IAAI,eACT,eAAe,UACf,OACA,eAAe,aAAa,0BAC9B;AACF;;;;;;;AAQA,SAAS,kBACP,gBACA,MACgB;CAChB,MAAM,QAAQ,eAAe,SAAS,oBAAoB;CAE1D,IAAI,CAAC,OACH,MAAM,IAAI,MACR,WAAW,KAAK,4IAClB;CAGF,OAAO,IAAI,eACT,eAAe,UACf,OACA,eAAe,aAAa,4BAC5B,eAAe,iBAAiB,wBAChC,eAAe,cAAc,sBAC7B,eAAe,cAAc,KAAK,IAAI,EACxC;AACF;;;;;AAMA,SAAS,oBACP,kBACA,MACkB;CAClB,MAAM,QAAQ,iBAAiB,SAAS,oBAAoB;CAE5D,IAAI,CAAC,OACH,MAAM,IAAI,MACR,WAAW,KAAK,gJAClB;CAGF,OAAO,IAAI,iBACT,iBAAiB,UACjB,OACA,iBAAiB,aAAa,8BAC9B,iBAAiB,uBAAuB,4BAC1C;AACF;;;;;;AAOA,SAAS,kBAAkB,MAAkB,OAAc,MAAoB;CAC7E,IAAI,SAAS,aAAa,CAAC,MAAM,SAC/B,MAAM,IAAI,MACR,WAAW,KAAK,6EAClB;CAGF,IAAI,SAAS,cAAc,CAAC,MAAM,UAChC,MAAM,IAAI,MACR,WAAW,KAAK,yEAClB;CAGF,IAAI,SAAS,cAAc,CAAC,MAAM,UAChC,MAAM,IAAI,MACR,WAAW,KAAK,yEAClB;CAGF,IAAI,SAAS,gBAAgB,CAAC,MAAM,YAClC,MAAM,IAAI,MACR,WAAW,KAAK,6EAClB;AAEJ"}