@signetai/core 0.140.1

package/dist/package-manager.d.ts

@@ -0,0 +1,33 @@
+export type PackageManagerFamily = "bun" | "npm" | "pnpm" | "yarn";
+export interface PackageManagerResolution {
+    family: PackageManagerFamily;
+    source: "config" | "user-agent" | "fallback";
+    reason: string;
+    available: Record<PackageManagerFamily, boolean>;
+    configuredFamily?: PackageManagerFamily;
+    userAgentFamily?: PackageManagerFamily;
+}
+export interface PackageManagerCommand {
+    command: string;
+    args: string[];
+}
+interface ResolvePackageManagerOptions {
+    agentsDir?: string;
+    env?: Record<string, string | undefined>;
+    userAgent?: string;
+    fallbackOrder?: PackageManagerFamily[];
+    commandExists?: (command: string) => boolean;
+    execPath?: string;
+}
+export declare function parsePackageManagerUserAgent(userAgent: string | undefined): PackageManagerFamily | null;
+export declare function detectAvailablePackageManagers(commandExists?: (command: string) => boolean): Record<PackageManagerFamily, boolean>;
+export declare function resolvePrimaryPackageManager(options?: ResolvePackageManagerOptions): PackageManagerResolution;
+export declare function getSkillsRunnerCommand(family: PackageManagerFamily, skillsArgs: string[]): PackageManagerCommand;
+/**
+ * Resolve the filesystem path where a globally-installed package lives.
+ * Returns undefined if the path cannot be determined or does not exist.
+ */
+export declare function resolveGlobalPackagePath(family: PackageManagerFamily, packageName: string): string | undefined;
+export declare function getGlobalInstallCommand(family: PackageManagerFamily, packageName: string): PackageManagerCommand;
+export {};
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,UAAU,4BAA4B;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAwBD,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,IAAI,CAKvG;AAWD,wBAAgB,8BAA8B,CAC7C,aAAa,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAA8B,GAChE,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAOvC;AA0DD,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,4BAAiC,GAAG,wBAAwB,CAsFjH;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAchH;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+E9G;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAWhH"}

package/dist/pi.d.ts

@@ -0,0 +1,15 @@
+export declare function getPiConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function readConfiguredPiAgentDir(env?: NodeJS.ProcessEnv): string | null;
+/**
+ * Resolve the Pi agent directory.
+ *
+ * Mirrors the logic of Pi SDK's `getAgentDir()` (env → default) but adds
+ * a persistence layer via `~/.config/signet/pi.json` so the CLI remembers
+ * the path across sessions even when the env var is unset.
+ */
+export declare function resolvePiAgentDir(env?: NodeJS.ProcessEnv): string;
+export declare function resolvePiExtensionsDir(env?: NodeJS.ProcessEnv): string;
+export declare function listPiAgentDirCandidates(env?: NodeJS.ProcessEnv): readonly string[];
+export declare function writeConfiguredPiAgentDir(pathValue: string, env?: NodeJS.ProcessEnv): string;
+export declare function clearConfiguredPiAgentDir(env?: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=pi.d.ts.map

package/dist/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../src/pi.ts"],"names":[],"mappings":"AAkCA,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAY5F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI9E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEnF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,MAAM,EAAE,CAQhG;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAczG;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAQpF"}

package/dist/pipeline-pause.d.ts

@@ -0,0 +1,18 @@
+export declare const PIPELINE_CONFIG_FILES: readonly ["agent.yaml", "AGENT.yaml", "config.yaml"];
+export interface PipelinePauseState {
+    readonly file: string | null;
+    readonly exists: boolean;
+    readonly enabled: boolean;
+    readonly paused: boolean;
+}
+export interface PipelineConfigData {
+    readonly file: string | null;
+    readonly root: Record<string, unknown> | null;
+    readonly memory: Record<string, unknown> | null;
+    readonly pipeline: Record<string, unknown> | null;
+}
+export declare function findPipelineConfigFile(dir: string): string | null;
+export declare function readPipelineConfigData(dir: string): PipelineConfigData;
+export declare function readPipelinePauseState(dir: string): PipelinePauseState;
+export declare function setPipelinePaused(dir: string, paused: boolean): PipelinePauseState;
+//# sourceMappingURL=pipeline-pause.d.ts.map

package/dist/pipeline-pause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-pause.d.ts","sourceRoot":"","sources":["../src/pipeline-pause.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,sDAAuD,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjE;AAoBD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAatE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAYtE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAkBlF"}

package/dist/pipeline-providers.d.ts

@@ -0,0 +1,11 @@
+export declare const OPENCODE_PIPELINE_AGENT = "signet-pipeline";
+export declare const OPENCODE_PIPELINE_SYSTEM_PROMPT = "You are a structured data extraction system. Return ONLY valid JSON matching the requested schema. No explanations, no markdown, no code fences.";
+export declare const PIPELINE_PROVIDER_CHOICES: readonly ["none", "acpx", "llama-cpp", "ollama", "claude-code", "codex", "opencode", "anthropic", "openrouter", "openai-compatible", "command"];
+export type PipelineProviderChoice = (typeof PIPELINE_PROVIDER_CHOICES)[number];
+export type SynthesisProviderChoice = Exclude<PipelineProviderChoice, "command">;
+export declare const SYNTHESIS_PROVIDER_CHOICES: SynthesisProviderChoice[];
+export declare const DEFAULT_PIPELINE_TIMEOUT_MS = 90000;
+export declare function isPipelineProvider(value: unknown): value is PipelineProviderChoice;
+export declare function isSynthesisProvider(value: unknown): value is SynthesisProviderChoice;
+export declare function defaultPipelineModel(provider: PipelineProviderChoice): string;
+//# sourceMappingURL=pipeline-providers.d.ts.map

package/dist/pipeline-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-providers.d.ts","sourceRoot":"","sources":["../src/pipeline-providers.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD,eAAO,MAAM,+BAA+B,qJACuG,CAAC;AAEpJ,eAAO,MAAM,yBAAyB,iJAY5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;AAEjF,eAAO,MAAM,0BAA0B,2BAEtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAKjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAElF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAEpF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAE7E"}

package/dist/pipeline-providers.js

@@ -0,0 +1,144 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/llm-model-catalog.ts
+var PIPELINE_MODEL_CATALOG = {
+  none: [],
+  command: [],
+  acpx: [
+    { value: "haiku", label: "Claude Code · haiku", tier: "low", source: "harness" },
+    { value: "gpt-5.4-mini", label: "Codex CLI · gpt-5.4-mini", tier: "low", source: "harness" },
+    { value: "google/gemini-2.5-flash", label: "OpenCode · google/gemini-2.5-flash", tier: "low", source: "harness" }
+  ],
+  "llama-cpp": [
+    { value: "qwen3:4b", label: "qwen3:4b", tier: "low", source: "local" },
+    { value: "qwen3:8b", label: "qwen3:8b", tier: "low", source: "local" }
+  ],
+  ollama: [
+    { value: "qwen3:4b", label: "qwen3:4b", tier: "low", source: "local" },
+    { value: "llama3", label: "llama3", tier: "low", source: "local" }
+  ],
+  "claude-code": [
+    { value: "haiku", label: "Haiku", tier: "low", source: "harness" },
+    { value: "sonnet", label: "Sonnet", tier: "mid", source: "harness" },
+    { value: "opus", label: "Opus", tier: "high", source: "harness" }
+  ],
+  codex: [
+    { value: "gpt-5.4-mini", label: "gpt-5.4-mini", tier: "low", source: "harness" },
+    { value: "gpt-5.4", label: "gpt-5.4", tier: "mid", source: "harness" },
+    { value: "gpt-5.5", label: "gpt-5.5", tier: "high", source: "harness" },
+    { value: "gpt-5.3-codex", label: "gpt-5.3-codex", tier: "mid", source: "harness" },
+    { value: "gpt-5.3-codex-spark", label: "gpt-5.3-codex-spark", tier: "low", source: "harness" },
+    { value: "gpt-5.2", label: "gpt-5.2", tier: "mid", source: "harness" }
+  ],
+  opencode: [
+    { value: "google/gemini-2.5-flash", label: "google/gemini-2.5-flash", tier: "low", source: "harness" },
+    { value: "openai/gpt-5.4-mini", label: "openai/gpt-5.4-mini", tier: "low", source: "harness" },
+    { value: "openai/gpt-5.4", label: "openai/gpt-5.4", tier: "mid", source: "harness" }
+  ],
+  anthropic: [
+    { value: "claude-3-5-haiku-20241022", label: "Claude 3.5 Haiku", tier: "low", source: "provider" },
+    { value: "claude-sonnet-4-20250514", label: "Claude Sonnet 4", tier: "mid", source: "provider" }
+  ],
+  openrouter: [
+    { value: "openai/gpt-4o-mini", label: "openai/gpt-4o-mini", tier: "low", source: "provider" },
+    { value: "openai/gpt-5.4-mini", label: "openai/gpt-5.4-mini", tier: "low", source: "provider" },
+    { value: "anthropic/claude-3.5-haiku", label: "anthropic/claude-3.5-haiku", tier: "low", source: "provider" },
+    { value: "google/gemini-2.5-flash", label: "google/gemini-2.5-flash", tier: "low", source: "provider" }
+  ],
+  "openai-compatible": [
+    { value: "gpt-4o-mini", label: "gpt-4o-mini", tier: "low", source: "provider" },
+    { value: "gpt-4.1-mini", label: "gpt-4.1-mini", tier: "low", source: "provider" },
+    { value: "local-model", label: "local-model", tier: "low", source: "provider" }
+  ]
+};
+var MODEL_DEFAULTS = {
+  none: "",
+  acpx: "haiku",
+  "llama-cpp": "qwen3:4b",
+  ollama: "qwen3:4b",
+  "claude-code": "haiku",
+  codex: "gpt-5.4-mini",
+  opencode: "google/gemini-2.5-flash",
+  anthropic: "claude-3-5-haiku-20241022",
+  openrouter: "openai/gpt-4o-mini",
+  "openai-compatible": "gpt-4o-mini",
+  command: ""
+};
+function modelPresetsForProvider(provider) {
+  return Object.prototype.hasOwnProperty.call(PIPELINE_MODEL_CATALOG, provider) ? PIPELINE_MODEL_CATALOG[provider] : [];
+}
+function modelDefaultForProvider(provider) {
+  return MODEL_DEFAULTS[provider];
+}
+
+// src/pipeline-providers.ts
+var OPENCODE_PIPELINE_AGENT = "signet-pipeline";
+var OPENCODE_PIPELINE_SYSTEM_PROMPT = "You are a structured data extraction system. Return ONLY valid JSON matching the requested schema. No explanations, no markdown, no code fences.";
+var PIPELINE_PROVIDER_CHOICES = [
+  "none",
+  "acpx",
+  "llama-cpp",
+  "ollama",
+  "claude-code",
+  "codex",
+  "opencode",
+  "anthropic",
+  "openrouter",
+  "openai-compatible",
+  "command"
+];
+var SYNTHESIS_PROVIDER_CHOICES = PIPELINE_PROVIDER_CHOICES.filter((provider) => provider !== "command");
+var DEFAULT_PIPELINE_TIMEOUT_MS = 90000;
+var PIPELINE_PROVIDER_SET = new Set(PIPELINE_PROVIDER_CHOICES);
+var SYNTHESIS_PROVIDER_SET = new Set(SYNTHESIS_PROVIDER_CHOICES);
+function isPipelineProvider(value) {
+  return typeof value === "string" && PIPELINE_PROVIDER_SET.has(value);
+}
+function isSynthesisProvider(value) {
+  return typeof value === "string" && SYNTHESIS_PROVIDER_SET.has(value);
+}
+function defaultPipelineModel(provider) {
+  return modelDefaultForProvider(provider);
+}
+export {
+  isSynthesisProvider,
+  isPipelineProvider,
+  defaultPipelineModel,
+  SYNTHESIS_PROVIDER_CHOICES,
+  PIPELINE_PROVIDER_CHOICES,
+  OPENCODE_PIPELINE_SYSTEM_PROMPT,
+  OPENCODE_PIPELINE_AGENT,
+  DEFAULT_PIPELINE_TIMEOUT_MS
+};

package/dist/plugins.d.ts

@@ -0,0 +1,6 @@
+export declare const SIGNET_SECRETS_PLUGIN_ID = "signet.secrets";
+export declare const SIGNET_GRAPHIQ_PLUGIN_ID = "signet.graphiq";
+export declare const SIGNET_PLUGIN_REGISTRY_DIR = ".daemon/plugins";
+export declare const SIGNET_PLUGIN_REGISTRY_FILE = "registry-v1.json";
+export declare const SIGNET_PLUGIN_REGISTRY_VERSION = 1;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAC5D,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAC9D,eAAO,MAAM,8BAA8B,IAAI,CAAC"}

package/dist/recall.d.ts

@@ -0,0 +1,188 @@
+export interface RecallScoreFilterRow {
+    readonly score?: number;
+    readonly supplementary?: boolean;
+}
+export interface RecallPartitionableRow {
+    readonly supplementary?: boolean;
+}
+export interface RecallRow extends RecallPartitionableRow {
+    readonly id?: string;
+    readonly content?: string;
+    readonly created_at?: string;
+    readonly score?: number;
+    readonly source?: string;
+    readonly source_id?: string;
+    readonly source_path?: string;
+    readonly who?: string;
+    readonly type?: string;
+    readonly tags?: string | null;
+    readonly pinned?: boolean | number;
+    readonly project?: string | null;
+    readonly importance?: number;
+    readonly already_recalled?: boolean;
+    readonly temporal_facet?: TemporalFacet;
+    readonly temporal_start_at?: string;
+    readonly temporal_end_at?: string | null;
+    readonly subject_type?: string;
+    readonly subject_id?: string;
+}
+export interface RecallMeta {
+    readonly totalReturned: number;
+    readonly hasSupplementary: boolean;
+    readonly noHits: boolean;
+    readonly temporal?: RecallTemporalMeta;
+    readonly dedupe?: {
+        readonly enabled: boolean;
+        readonly contextEpoch?: number;
+        readonly suppressed: number;
+        readonly repeatedReturned: number;
+    };
+}
+export type AggregateRecallBudget = "small" | "medium" | "large";
+export type TemporalFacet = "captured" | "session" | "source" | "observed" | "occurred" | "valid";
+export interface RecallTimeOptions {
+    readonly start?: string;
+    readonly end?: string;
+    readonly facets?: readonly TemporalFacet[];
+    readonly mode?: "auto" | "timeline" | "filter";
+}
+export interface RecallTemporalMeta {
+    readonly mode: "timeline" | "filter";
+    readonly source: "query" | "request";
+    readonly originalQuery: string;
+    readonly contentQuery: string;
+    readonly start: string;
+    readonly end: string;
+    readonly facets: readonly TemporalFacet[];
+}
+export interface AggregateRecallMeta {
+    readonly savedMemoryId: string | null;
+    readonly saved: boolean;
+    readonly deduped: boolean;
+    readonly budget: AggregateRecallBudget;
+    readonly queries: readonly string[];
+    readonly sourceMemoryIds: readonly string[];
+    readonly stoppedReason: "complete" | "no_evidence" | "router_unavailable" | "synthesis_failed";
+    readonly usage?: AggregateRecallUsage;
+}
+export interface AggregateRecallUsage {
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly cacheReadTokens: number | null;
+    readonly cacheCreationTokens: number | null;
+    readonly totalCost: number | null;
+    readonly totalDurationMs: number | null;
+    readonly stages: readonly AggregateRecallUsageStage[];
+}
+export interface AggregateRecallUsageStage {
+    readonly name: "planning" | "synthesis";
+    readonly targetRef: string | null;
+    readonly attemptCount: number;
+    readonly fallbackCount: number;
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly cacheReadTokens: number | null;
+    readonly cacheCreationTokens: number | null;
+    readonly totalCost: number | null;
+    readonly totalDurationMs: number | null;
+}
+export interface RecallPayload {
+    readonly query?: string;
+    readonly method?: string;
+    readonly results?: ReadonlyArray<RecallRow>;
+    readonly meta?: Partial<RecallMeta>;
+    readonly aggregate?: AggregateRecallMeta;
+    readonly memories?: ReadonlyArray<RecallRow>;
+    readonly count?: number;
+    readonly message?: string;
+}
+export interface RecallRequestOptions {
+    readonly keywordQuery?: string;
+    readonly keyword_query?: string;
+    readonly limit?: number;
+    readonly project?: string;
+    readonly type?: string;
+    readonly tags?: string;
+    readonly who?: string;
+    readonly pinned?: boolean;
+    readonly importance_min?: number;
+    readonly since?: string;
+    readonly until?: string;
+    readonly time?: RecallTimeOptions;
+    readonly expand?: boolean;
+    readonly agentId?: string;
+    readonly sessionKey?: string;
+    readonly includeRecalled?: boolean;
+    readonly scope?: "global" | "agent" | "session";
+    readonly sourceOnly?: boolean;
+    readonly aggregate?: boolean;
+    readonly aggregateBudget?: AggregateRecallBudget;
+    readonly aggregate_budget?: AggregateRecallBudget;
+    readonly saveAggregate?: boolean;
+    readonly save_aggregate?: boolean;
+}
+export interface RememberRequestOptions {
+    readonly type?: string;
+    readonly importance?: number;
+    readonly tags?: string | readonly string[];
+    readonly who?: string;
+    readonly pinned?: boolean;
+    readonly sourceType?: string;
+    readonly sourceId?: string;
+    readonly sourcePath?: string;
+    readonly createdAt?: string;
+    readonly occurredAt?: string;
+    readonly observedAt?: string;
+    readonly validFrom?: string;
+    readonly validUntil?: string;
+    readonly sourceCreatedAt?: string;
+    readonly hints?: readonly string[];
+    readonly transcript?: string;
+    readonly structured?: unknown;
+    readonly agentId?: string;
+    readonly visibility?: "global" | "private" | "archived";
+    readonly mode?: "auto" | "sync" | "async";
+    readonly idempotencyKey?: string;
+    readonly runtimePath?: string;
+    readonly harness?: string;
+    readonly source?: string;
+}
+export declare function partitionRecallRows<T extends RecallPartitionableRow>(rows: ReadonlyArray<T>): {
+    readonly primary: T[];
+    readonly supporting: T[];
+};
+export declare function parseRecallMeta(raw: unknown, fallbackCount: number): RecallMeta;
+export declare function parseRecallPayload(raw: unknown): {
+    readonly query?: string;
+    readonly method?: string;
+    readonly rows: RecallRow[];
+    readonly meta: RecallMeta;
+    readonly message?: string;
+};
+export declare function applyRecallScoreThreshold(raw: unknown, minScore?: number): unknown;
+export declare function formatRecallText(raw: unknown): string;
+export declare function buildRecallRequestBody(query: string, options?: RecallRequestOptions): Record<string, unknown>;
+export declare function normalizeStructuredMemoryPayload(value: unknown): unknown;
+export declare function buildRememberRequestBody(content: string, options?: RememberRequestOptions): Record<string, unknown>;
+export declare function withHookRecallCompat<T extends {
+    readonly results: ReadonlyArray<unknown>;
+}>(result: T): T & {
+    readonly memories: T["results"];
+    readonly count: number;
+    readonly message: string;
+};
+export declare function emptyHookRecallResponse(query: string, extras?: {
+    readonly bypassed?: boolean;
+    readonly internal?: boolean;
+}): {
+    readonly results: [];
+    readonly memories: [];
+    readonly count: 0;
+    readonly query: string;
+    readonly method: "hybrid";
+    readonly meta: RecallMeta;
+    readonly message: string;
+    readonly bypassed?: boolean;
+    readonly internal?: boolean;
+};
+//# sourceMappingURL=recall.d.ts.map

package/dist/recall.d.ts.map

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