@deepagents/context 0.38.1 → 1.0.0

package/dist/lib/sandbox/installers/installer.d.ts

@@ -0,0 +1,44 @@
+import { type CommandResult } from 'bash-tool';
+export type PackageManager = 'apk' | 'apt-get';
+/**
+ * Shared state passed to every installer's `install()` call.
+ *
+ * The context owns one container's installation lifecycle:
+ * - memoised architecture (one `uname -m` per sandbox)
+ * - resolved package manager
+ * - `apt-get update` runs at most once
+ * - idempotent `ensureTool` (cache keyed on install name)
+ */
+export interface InstallerContext {
+    readonly containerId: string;
+    readonly image: string;
+    readonly packageManager: PackageManager;
+    arch(): Promise<string>;
+    exec(command: string): Promise<CommandResult>;
+    /**
+     * Install OS packages via the container's package manager.
+     * `apt-get update` runs at most once per container, then subsequent calls
+     * issue install only.
+     */
+    installPackages(packages: string[]): Promise<void>;
+    /**
+     * Ensure a tool is callable.
+     *
+     * @param checkName Binary name probed via `which` (e.g. `'node'`).
+     * @param installName Package to install when missing (e.g. `'nodejs'`).
+     *   Defaults to `checkName` when binary name == package name.
+     */
+    ensureTool(checkName: string, installName?: string): Promise<void>;
+}
+export declare abstract class Installer {
+    abstract readonly kind: string;
+    abstract install(ctx: InstallerContext): Promise<void>;
+}
+export declare function isDebianBased(image: string): boolean;
+/**
+ * POSIX shell single-quote escape: wrap in `'...'`, replace any embedded
+ * `'` with `'\''`. Safe for arbitrary content inside `sh -c`.
+ */
+export declare function shellQuote(s: string): string;
+export declare function createInstallerContext(containerId: string, image: string): InstallerContext;
+//# sourceMappingURL=installer.d.ts.map

package/dist/lib/sandbox/installers/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/installers/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAQ/C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CACvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAyGlB"}

package/dist/lib/sandbox/installers/npm.d.ts

@@ -0,0 +1,32 @@
+import { Installer, type InstallerContext } from './installer.ts';
+export interface NpmInstallerOptions {
+    /**
+     * Auto-install `nodejs` + `npm` via the container's package manager when
+     * they're missing. Defaults to `false` — fail loudly with `MissingRuntimeError`.
+     */
+    ensureRuntime?: boolean;
+    /** Optional version specifier (e.g. `'5.4.5'`). */
+    version?: string;
+}
+export declare class NpmInstaller extends Installer {
+    readonly kind: string;
+    readonly packageName: string;
+    readonly options: NpmInstallerOptions;
+    constructor(packageName: string, options?: NpmInstallerOptions);
+    install(ctx: InstallerContext): Promise<void>;
+}
+/**
+ * Install a globally-available CLI from the npm registry.
+ *
+ * Default: fails loudly if `node`/`npm` are missing. Pass
+ * `{ ensureRuntime: true }` to auto-install them.
+ *
+ * @example
+ * ```ts
+ * npm('prettier');                              // requires node+npm preinstalled
+ * npm('prettier', { ensureRuntime: true });     // auto-installs node+npm
+ * npm('typescript', { version: '5.4.5' });      // pinned version
+ * ```
+ */
+export declare function npm(packageName: string, options?: NpmInstallerOptions): NpmInstaller;
+//# sourceMappingURL=npm.d.ts.map

package/dist/lib/sandbox/installers/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/installers/npm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAO5D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}

package/dist/lib/sandbox/installers/package-manager.d.ts

@@ -0,0 +1,19 @@
+import { Installer, type InstallerContext } from './installer.ts';
+export declare class PackageInstaller extends Installer {
+    readonly kind: string;
+    readonly packages: readonly string[];
+    constructor(packages: readonly string[]);
+    install(ctx: InstallerContext): Promise<void>;
+}
+/**
+ * Install OS packages via the container's native package manager.
+ *
+ * Auto-detects `apk` (Alpine) vs `apt-get` (Debian/Ubuntu/Node/Python images).
+ *
+ * @example
+ * ```ts
+ * createDockerSandbox({ installers: [pkg(['curl', 'jq'])] });
+ * ```
+ */
+export declare function pkg(packages: readonly string[]): PackageInstaller;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/lib/sandbox/installers/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/installers/package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEzB,QAAQ,EAAE,SAAS,MAAM,EAAE;IAOjC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAIpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAEjE"}

package/dist/lib/sandbox/installers/pip.d.ts

@@ -0,0 +1,37 @@
+import { Installer, type InstallerContext } from './installer.ts';
+export interface PipInstallerOptions {
+    /**
+     * Auto-install `python3` + pip when missing. Defaults to `false` — fail
+     * loudly with `MissingRuntimeError`.
+     */
+    ensureRuntime?: boolean;
+    /** Version specifier (e.g. `'2.31.0'` or `'>=2.0,<3'`). */
+    version?: string;
+    /**
+     * Pass `--break-system-packages` for PEP 668-protected images
+     * (recent Debian/Ubuntu). Default `true` since this runs in an ephemeral
+     * container where the protection adds no value.
+     */
+    breakSystemPackages?: boolean;
+}
+export declare class PipInstaller extends Installer {
+    readonly kind: string;
+    readonly packageName: string;
+    readonly options: PipInstallerOptions;
+    constructor(packageName: string, options?: PipInstallerOptions);
+    install(ctx: InstallerContext): Promise<void>;
+}
+/**
+ * Install a Python package via `pip3`.
+ *
+ * Default: fails loudly if `python3`/`pip3` are missing. Pass
+ * `{ ensureRuntime: true }` to auto-install them.
+ *
+ * @example
+ * ```ts
+ * pip('requests');
+ * pip('requests', { version: '2.31.0', ensureRuntime: true });
+ * ```
+ */
+export declare function pip(packageName: string, options?: PipInstallerOptions): PipInstaller;
+//# sourceMappingURL=pip.d.ts.map

package/dist/lib/sandbox/installers/pip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pip.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/installers/pip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAID,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAO5D,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}

package/dist/lib/sandbox/installers/url-binary.d.ts

@@ -0,0 +1,41 @@
+import { Installer, type InstallerContext } from './installer.ts';
+export interface ArchitectureUrls {
+    x86_64?: string;
+    aarch64?: string;
+    armv7l?: string;
+}
+export interface UrlBinaryOptions {
+    /** Final executable name installed under `/usr/local/bin`. */
+    name: string;
+    /** Single URL or arch-keyed map (selected via container's `uname -m`). */
+    url: string | ArchitectureUrls;
+    /** Path inside an extracted archive, when it differs from `name`. */
+    binaryPath?: string;
+}
+export declare class UrlBinaryInstaller extends Installer {
+    readonly kind: string;
+    readonly options: UrlBinaryOptions;
+    constructor(options: UrlBinaryOptions);
+    install(ctx: InstallerContext): Promise<void>;
+}
+/**
+ * Install a pre-built binary from a URL into `/usr/local/bin`.
+ *
+ * Supports raw binaries and `.tar.gz`/`.tgz` archives. Picks the correct
+ * URL per container architecture when a map is provided. Auto-installs `curl`
+ * if needed.
+ *
+ * @example
+ * ```ts
+ * urlBinary({
+ *   name: 'presenterm',
+ *   url: {
+ *     x86_64: 'https://.../presenterm-x86_64.tar.gz',
+ *     aarch64: 'https://.../presenterm-aarch64.tar.gz',
+ *   },
+ * });
+ * ```
+ */
+export declare function urlBinary(options: UrlBinaryOptions): UrlBinaryInstaller;
+export declare function downloadAndInstall(ctx: InstallerContext, name: string, url: string, binaryPath?: string, source?: 'url' | 'github-release'): Promise<void>;
+//# sourceMappingURL=url-binary.d.ts.map

package/dist/lib/sandbox/installers/url-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-binary.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/installers/url-binary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAc,MAAM,gBAAgB,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,gBAAgB;IAM/B,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CASpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAEvE;AAqBD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,KAAK,GAAG,gBAAwB,GACvC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/lib/sandbox/subcommand.d.ts

@@ -1,5 +1,4 @@
-import type { CommandResult } from 'bash-tool';
-import type { ExtensionCommand, ExtensionCommandContext } from './extension.ts';
+import { type Command, type CommandContext, type ExecResult } from 'just-bash';
 /**
  * Describes one subcommand inside a subcommand group (e.g. `sql run`,
  * `sql validate`). Each subcommand has usage/description strings used to
@@ -14,21 +13,23 @@ export interface SubcommandDefinition {
      * the shell parser sees it. Return `null` to leave the raw args unchanged.
      */
     repair?: (rawArgs: string) => string | null;
-    handler: (args: string[], ctx: ExtensionCommandContext) => CommandResult | Promise<CommandResult>;
+    handler: (args: string[], ctx: CommandContext) => ExecResult | Promise<ExecResult>;
 }
 /**
- * Creates an {@link ExtensionCommand} that dispatches to one of several
- * subcommand handlers based on the first positional arg. Unknown or missing
- * subcommands print an auto-generated usage message to stderr with exit
- * code 1.
+ * Builds a `Command` for just-bash that dispatches to one of several
+ * subcommand handlers based on the first positional arg. Plug it into a
+ * `Bash` instance via `customCommands` (or feed it to any sandbox that
+ * accepts just-bash custom commands). Unknown or missing subcommands
+ * print an auto-generated usage message to stderr with exit code 1.
  *
  * @example
  * const sqlCommand = defineSubcommandGroup('sql', {
  *   run:      { usage: 'run "SELECT ..."',      description: 'Execute query',  handler: ... },
  *   validate: { usage: 'validate "SELECT ..."', description: 'Validate only', handler: ... },
  * });
+ * new Bash({ fs, customCommands: [sqlCommand] });
  */
-export declare function defineSubcommandGroup(name: string, subcommands: Record<string, SubcommandDefinition>): ExtensionCommand;
+export declare function defineSubcommandGroup(name: string, subcommands: Record<string, SubcommandDefinition>): Command;
 /**
  * Strips a single layer of matching outer `"` or `'` quotes from a string,
  * trimming surrounding whitespace. If the input is not wrapped in a matching
@@ -36,9 +37,8 @@ export declare function defineSubcommandGroup(name: string, subcommands: Record<
  */
 export declare function stripQuoteArtifacts(raw: string): string;
 /**
- * Pre-parse repair for a subcommand's raw arg string. Fires when the
- * surrounding command fails to parse (via `buildSubcommandRepair`). Strips
- * any leading/trailing quote, escapes inner single quotes with the POSIX
+ * Pre-parse repair for a subcommand's raw arg string. Strips any
+ * leading/trailing quote, escapes inner single quotes with the POSIX
  * `'\''` idiom, and wraps the result in single quotes so the shell parser
  * will treat the payload as an opaque literal on the next pass.
  *

package/dist/lib/sandbox/subcommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subcommand.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/subcommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,uBAAuB,KACzB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,gBAAgB,CAsBlB;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,IAO1B,KAAK,MAAM,KAAG,MAAM,CA2B5C"}
+{"version":3,"file":"subcommand.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/subcommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,EAGhB,MAAM,WAAW,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,cAAc,KAChB,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,OAAO,CAmBT;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,IAO1B,KAAK,MAAM,KAAG,MAAM,CA2B5C"}

package/dist/lib/sandbox/upload-skills.d.ts

@@ -1,6 +1,12 @@
 import type { Sandbox } from 'bash-tool';
 import type { SkillPathMapping } from '../skills/types.ts';
 import type { SkillUploadInput } from './types.ts';
+/**
+ * Discover skill metadata and map each host SKILL.md path to its sandbox path
+ * without uploading any files. Later inputs override earlier ones when the same
+ * skill name appears twice.
+ */
+export declare function discoverSkillMappings(inputs: SkillUploadInput[]): SkillPathMapping[];
 /**
  * Discover skills under each host directory, write all non-dotfile, non-symlink
  * files into the sandbox under the mapped path, and return the discovered

package/dist/lib/sandbox/upload-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-skills.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/upload-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAenD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqC7B"}
+{"version":3,"file":"upload-skills.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/upload-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAenD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EAAE,GACzB,gBAAgB,EAAE,CAwBpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqB7B"}

package/dist/lib/sandbox/virtual-sandbox.d.ts

@@ -0,0 +1,10 @@
+import type { Sandbox } from 'bash-tool';
+import { type CustomCommand, type IFileSystem } from 'just-bash';
+export interface CreateVirtualSandboxOptions {
+    fs: IFileSystem;
+    cwd?: string;
+    env?: Record<string, string>;
+    customCommands?: CustomCommand[];
+}
+export declare function createVirtualSandbox(options: CreateVirtualSandboxOptions): Promise<Sandbox>;
+//# sourceMappingURL=virtual-sandbox.d.ts.map

package/dist/lib/sandbox/virtual-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/virtual-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAiClB"}

package/dist/lib/save/reminder-target-handler.d.ts

@@ -0,0 +1,36 @@
+import type { UIMessage } from 'ai';
+import type { ChainSummary } from '../chain-summary.ts';
+import type { ContextFragment } from '../fragments.ts';
+import type { ConditionalReminder, ReminderResolution, ReminderTarget, WhenContext } from '../fragments/message/user.ts';
+export type BaseWhenCtx = Omit<WhenContext, 'content' | 'currentMessage' | 'lastAssistantMessage' | 'lastAssistantMessages'>;
+export interface PreparedCarrier {
+    message: UIMessage;
+    fragmentIndex: number;
+}
+export interface ReminderHandlerInput {
+    pending: ContextFragment[];
+    base: BaseWhenCtx;
+    chain: ChainSummary;
+    sharedUserMessage?: UIMessage & {
+        role: 'user';
+    };
+}
+export interface ReminderApplyInput {
+    pending: ContextFragment[];
+    carrier: PreparedCarrier;
+    fired: ConditionalReminder[];
+    resolved: ReminderResolution[];
+}
+export interface PreparedHandler {
+    whenCtx: WhenContext;
+    carrier: PreparedCarrier;
+    sharedUserMessage?: UIMessage & {
+        role: 'user';
+    };
+}
+export interface ReminderTargetHandler {
+    readonly target: ReminderTarget;
+    prepare(input: ReminderHandlerInput): PreparedHandler | null;
+    apply(input: ReminderApplyInput): void;
+}
+//# sourceMappingURL=reminder-target-handler.d.ts.map

package/dist/lib/save/reminder-target-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-target-handler.d.ts","sourceRoot":"","sources":["../../../src/lib/save/reminder-target-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,WAAW,EACT,SAAS,GACT,gBAAgB,GAChB,sBAAsB,GACtB,uBAAuB,CAC1B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,iBAAiB,CAAC,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACxC"}

package/dist/lib/save/save-pipeline.d.ts

@@ -0,0 +1,28 @@
+import type { ChainSummary } from '../chain-summary.ts';
+import type { ContextFragment } from '../fragments.ts';
+import type { ContextStore } from '../store/store.ts';
+import type { BaseWhenCtx, ReminderTargetHandler } from './reminder-target-handler.ts';
+export interface SavePipelineEngine {
+    readonly store: ContextStore;
+    readonly chatId: string;
+    readonly branchName: string;
+    getActiveBranch(): {
+        id: string;
+        headMessageId: string | null;
+    };
+    commitHead(headMessageId: string): Promise<void>;
+    rewindForUpdate(parentId: string): Promise<void>;
+    getChainSummary(): Promise<ChainSummary>;
+    buildBaseWhenCtx(chain: ChainSummary): BaseWhenCtx;
+}
+export interface SaveResult {
+    headMessageId: string | undefined;
+}
+export declare class SavePipeline {
+    #private;
+    constructor(engine: SavePipelineEngine, pending: ContextFragment[], fragments: ContextFragment[]);
+    applyUpdateBranching(shouldBranch: boolean): Promise<this>;
+    evaluateReminders(handlers: ReminderTargetHandler[]): Promise<this>;
+    persist(): Promise<SaveResult>;
+}
+//# sourceMappingURL=save-pipeline.d.ts.map

package/dist/lib/save/save-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-pipeline.d.ts","sourceRoot":"","sources":["../../../src/lib/save/save-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQvD,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,eAAe,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAChE,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC;CACpD;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,qBAAa,YAAY;;gBAOrB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,eAAe,EAAE;IAOxB,oBAAoB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1D,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyEnE,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;CAuCrC"}

package/dist/lib/save/tool-output-target-handler.d.ts

@@ -0,0 +1,7 @@
+import type { PreparedHandler, ReminderApplyInput, ReminderHandlerInput, ReminderTargetHandler } from './reminder-target-handler.ts';
+export declare class ToolOutputTargetHandler implements ReminderTargetHandler {
+    readonly target: 'tool-output';
+    prepare({ pending, base, chain, sharedUserMessage, }: ReminderHandlerInput): PreparedHandler | null;
+    apply({ pending, carrier, resolved }: ReminderApplyInput): void;
+}
+//# sourceMappingURL=tool-output-target-handler.d.ts.map

package/dist/lib/save/tool-output-target-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-target-handler.d.ts","sourceRoot":"","sources":["../../../src/lib/save/tool-output-target-handler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,qBAAa,uBAAwB,YAAW,qBAAqB;IACnE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAA0B;IAExD,OAAO,CAAC,EACN,OAAO,EACP,IAAI,EACJ,KAAK,EACL,iBAAiB,GAClB,EAAE,oBAAoB,GAAG,eAAe,GAAG,IAAI;IAkChD,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,IAAI;CAmBhE"}

package/dist/lib/save/user-target-handler.d.ts

@@ -0,0 +1,7 @@
+import type { PreparedHandler, ReminderApplyInput, ReminderHandlerInput, ReminderTargetHandler } from './reminder-target-handler.ts';
+export declare class UserTargetHandler implements ReminderTargetHandler {
+    readonly target: 'user';
+    prepare({ pending, base, chain, }: ReminderHandlerInput): PreparedHandler | null;
+    apply({ pending, carrier, fired, resolved }: ReminderApplyInput): void;
+}
+//# sourceMappingURL=user-target-handler.d.ts.map

package/dist/lib/save/user-target-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-target-handler.d.ts","sourceRoot":"","sources":["../../../src/lib/save/user-target-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAmB;IAE1C,OAAO,CAAC,EACN,OAAO,EACP,IAAI,EACJ,KAAK,GACN,EAAE,oBAAoB,GAAG,eAAe,GAAG,IAAI;IA2BhD,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,IAAI;CAiBvE"}

package/dist/lib/stream/change-source.d.ts

@@ -0,0 +1,11 @@
+export type StreamChange = {
+    kind: 'chunks';
+} | {
+    kind: 'status';
+} | {
+    kind: 'tick';
+};
+export interface StreamChangeSource {
+    subscribe(streamId: string, signal: AbortSignal): AsyncIterable<StreamChange>;
+}
+//# sourceMappingURL=change-source.d.ts.map

package/dist/lib/stream/change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/change-source.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;CAC/E"}

package/dist/lib/stream/ddl.stream.postgres-notify.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_POSTGRES_STREAM_CHANGES_CHANNEL = "deepagents_stream_changes";
+export declare function postgresStreamNotifyDDL(schema: string, channel?: string): string;
+//# sourceMappingURL=ddl.stream.postgres-notify.d.ts.map

package/dist/lib/stream/ddl.stream.postgres-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.stream.postgres-notify.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/ddl.stream.postgres-notify.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,8BACvB,CAAC;AAE9B,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,SAA0C,GAChD,MAAM,CAqDR"}

package/dist/lib/stream/ddl.stream.postgres.d.ts

@@ -0,0 +1,2 @@
+export declare function postgresStreamDDL(schema: string): string;
+//# sourceMappingURL=ddl.stream.postgres.d.ts.map

package/dist/lib/stream/ddl.stream.postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.stream.postgres.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/ddl.stream.postgres.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA8BxD"}

package/dist/lib/stream/polling-change-source.d.ts

@@ -0,0 +1,27 @@
+import type { StreamChange, StreamChangeSource } from './change-source.ts';
+import { type WatchPollingConfig } from './polling-policy.ts';
+import type { StreamStatus } from './stream-store.ts';
+export type PollingTelemetryEvent = {
+    type: 'poll';
+    streamId: string;
+    delayMs: number;
+    status: StreamStatus | 'missing';
+} | {
+    type: 'idle';
+    streamId: string;
+    delayMs: number;
+};
+export interface PollingChangeSourceReads {
+    getStreamStatus(streamId: string): Promise<StreamStatus | undefined>;
+}
+export interface PollingChangeSourceOptions {
+    reads: PollingChangeSourceReads;
+    config?: Partial<WatchPollingConfig>;
+    onPoll?: (event: PollingTelemetryEvent) => void;
+}
+export declare class PollingChangeSource implements StreamChangeSource {
+    #private;
+    constructor(options: PollingChangeSourceOptions);
+    subscribe(streamId: string, signal: AbortSignal): AsyncIterable<StreamChange>;
+}
+//# sourceMappingURL=polling-change-source.d.ts.map

package/dist/lib/stream/polling-change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-change-source.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/polling-change-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAEL,KAAK,kBAAkB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAClC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,wBAAwB,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACjD;AAED,qBAAa,mBAAoB,YAAW,kBAAkB;;gBAKhD,OAAO,EAAE,0BAA0B;IAMxC,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,YAAY,CAAC;CAiE/B"}

package/dist/lib/stream/polling-policy.d.ts

@@ -6,7 +6,6 @@ export interface AdaptivePollingConfig {
 }
 export interface WatchPollingConfig extends AdaptivePollingConfig {
     statusCheckEvery: number;
-    chunkPageSize: number;
 }
 export type CancelPollingConfig = AdaptivePollingConfig;
 export interface AdaptivePollingState {

package/dist/lib/stream/polling-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polling-policy.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/polling-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,kBAOnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,mBAKpC,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,EAChD,QAAQ,GAAE,kBAA0C,GACnD,kBAAkB,CAWpB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,EACjD,QAAQ,GAAE,mBAA4C,GACrD,mBAAmB,CAErB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,GAC5B,oBAAoB,CAKtB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAkB5E"}
+{"version":3,"file":"polling-policy.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/polling-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,kBAMnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,mBAKpC,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,EAChD,QAAQ,GAAE,kBAA0C,GACnD,kBAAkB,CAUpB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,EACjD,QAAQ,GAAE,mBAA4C,GACrD,mBAAmB,CAErB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,GAC5B,oBAAoB,CAKtB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAkB5E"}

package/dist/lib/stream/postgres-notify-change-source.d.ts

@@ -0,0 +1,15 @@
+import type { Pool, PoolConfig } from 'pg';
+import type { StreamChange, StreamChangeSource } from './change-source.ts';
+export interface PostgresNotifyChangeSourceOptions {
+    pool: Pool | PoolConfig | string;
+    schema?: string;
+    channel?: string;
+}
+export declare class PostgresNotifyChangeSource implements StreamChangeSource {
+    #private;
+    constructor(options: PostgresNotifyChangeSourceOptions);
+    initialize(): Promise<void>;
+    subscribe(streamId: string, signal: AbortSignal): AsyncIterable<StreamChange>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgres-notify-change-source.d.ts.map

package/dist/lib/stream/postgres-notify-change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-notify-change-source.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/postgres-notify-change-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,IAAI,EAAc,UAAU,EAAE,MAAM,IAAI,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAM3E,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,0BAA2B,YAAW,kBAAkB;;gBA4BvD,OAAO,EAAE,iCAAiC;IAgChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1B,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,YAAY,CAAC;IA6BxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkJ7B"}

package/dist/lib/stream/postgres.stream-store.d.ts

@@ -0,0 +1,29 @@
+import type { Pool, PoolConfig } from 'pg';
+import type { ListStreamIdsOptions, StreamChunkData, StreamData, StreamStatus } from './stream-store.ts';
+import { StreamStore } from './stream-store.ts';
+export interface PostgresStreamStoreOptions {
+    pool: Pool | PoolConfig | string;
+    schema?: string;
+}
+export declare class PostgresStreamStore extends StreamStore {
+    #private;
+    constructor(options: PostgresStreamStoreOptions);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    createStream(stream: StreamData): Promise<void>;
+    upsertStream(stream: StreamData): Promise<{
+        stream: StreamData;
+        created: boolean;
+    }>;
+    getStream(streamId: string): Promise<StreamData | undefined>;
+    getStreamStatus(streamId: string): Promise<StreamStatus | undefined>;
+    listStreamIds(options?: ListStreamIdsOptions): Promise<string[]>;
+    updateStreamStatus(streamId: string, status: StreamStatus, options?: {
+        error?: string;
+    }): Promise<void>;
+    appendChunks(chunks: StreamChunkData[]): Promise<void>;
+    getChunks(streamId: string, fromSeq?: number, limit?: number): Promise<StreamChunkData[]>;
+    deleteStream(streamId: string): Promise<void>;
+    reopenStream(streamId: string): Promise<StreamData>;
+}
+//# sourceMappingURL=postgres.stream-store.d.ts.map

package/dist/lib/stream/postgres.stream-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.stream-store.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/postgres.stream-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,UAAU,EAAE,MAAM,IAAI,CAAC;AAGvD,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmBD,qBAAa,mBAAoB,SAAQ,WAAW;;gBAOtC,OAAO,EAAE,0BAA0B;IAkCzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCtB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,YAAY,CAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAuB9C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQ5D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAQpE,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAehE,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IA6CV,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtD,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC;IAyBvB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAyC1D"}

package/dist/lib/stream/stream-manager.d.ts

@@ -1,28 +1,14 @@
 import type { StreamPart } from '../guardrail.ts';
 import { type PersistedWriterOptions } from '../stream-buffer.ts';
-import { type CancelPollingConfig, type WatchPollingConfig } from './polling-policy.ts';
-import type { ListStreamIdsOptions, StreamData, StreamStatus, StreamStore } from './stream-store.ts';
-export type WatchStreamOptions = Partial<WatchPollingConfig>;
-export type PersistCancelPollingOptions = Partial<CancelPollingConfig>;
+import type { StreamChangeSource } from './change-source.ts';
+import type { ListStreamIdsOptions, StreamData, StreamStore } from './stream-store.ts';
 export interface PersistStreamOptions extends Pick<PersistedWriterOptions, 'strategy' | 'flushSize'> {
-    cancelPolling?: PersistCancelPollingOptions;
     onCancelDetected?: (info: {
         streamId: string;
         latencyMs: number | null;
     }) => void | Promise<void>;
 }
-export type StreamPollingTelemetryEvent = {
-    type: 'watch:poll';
-    streamId: string;
-    fromSeq: number;
-    chunkCount: number;
-    statusChecked: boolean;
-} | {
-    type: 'watch:empty';
-    streamId: string;
-    fromSeq: number;
-    delayMs: number;
-} | {
+export type StreamWatchTelemetryEvent = {
     type: 'watch:chunks';
     streamId: string;
     delivered: number;
@@ -30,16 +16,11 @@ export type StreamPollingTelemetryEvent = {
 } | {
     type: 'watch:closed';
     streamId: string;
-    reason: 'terminal' | 'missing';
+    reason: 'terminal' | 'missing' | 'source-ended';
 } | {
     type: 'watch:error-emitted';
     streamId: string;
     errorTextLength: number;
-} | {
-    type: 'persist:cancel-poll';
-    streamId: string;
-    delayMs: number;
-    status: StreamStatus | 'missing';
 } | {
     type: 'persist:cancel-detected';
     streamId: string;
@@ -47,9 +28,9 @@ export type StreamPollingTelemetryEvent = {
 };
 export interface StreamManagerOptions {
     store: StreamStore;
-    watchPolling?: WatchStreamOptions;
-    cancelPolling?: PersistCancelPollingOptions;
-    onPollingEvent?: (event: StreamPollingTelemetryEvent) => void;
+    changeSource: StreamChangeSource;
+    chunkPageSize?: number;
+    onWatchEvent?: (event: StreamWatchTelemetryEvent) => void;
 }
 export declare class StreamManager {
     #private;
@@ -64,7 +45,7 @@ export declare class StreamManager {
     persist(stream: ReadableStream, streamId: string, options?: PersistStreamOptions): Promise<{
         streamId: string;
     }>;
-    watch(streamId: string, options?: WatchStreamOptions): ReadableStream<StreamPart>;
+    watch(streamId: string): ReadableStream<StreamPart>;
     reopen(streamId: string): Promise<{
         stream: StreamData;
         created: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"stream-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/stream-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,mBAAmB,EAGxB,KAAK,kBAAkB,EAMxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,oBAAoB,EAEpB,UAAU,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAM3B,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC7D,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEvE,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,sBAAsB,EACtB,UAAU,GAAG,WAAW,CACzB;IACC,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;CAChC,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAClC,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC/D;AAED,qBAAa,aAAa;;gBAMZ,OAAO,EAAE,oBAAoB;IAazC,IAAI,KAAK,IAAI,WAAW,CAEvB;IAEK,QAAQ,CACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAY9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhE,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA6GhC,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,CAAC,UAAU,CAAC;IAmJvB,MAAM,CACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY/C"}
+{"version":3,"file":"stream-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/stream-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EAEV,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,sBAAsB,EACtB,UAAU,GAAG,WAAW,CACzB;IACC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,MAAM,yBAAyB,GACjC;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;CACjD,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,kBAAkB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;CAC3D;AAID,qBAAa,aAAa;;gBAMZ,OAAO,EAAE,oBAAoB;IAOzC,IAAI,KAAK,IAAI,WAAW,CAEvB;IAEK,QAAQ,CACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAY9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhE,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAuGhC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IA4G7C,MAAM,CACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY/C"}