@roj-ai/sdk 0.1.36 → 0.2.1

package/dist/lib/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/lib/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACrD,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACpC,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,MAAM,MAAM,GAAG,GAAG,EAAE;YACnB,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACV,CAAC,CAAA;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACpC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACH,CAAC"}

package/dist/platform/fs-revision.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Filesystem revision adapter.
+ *
+ * One number that moves whenever anything in the host's filesystem changes, so a
+ * caller holding an answer derived from the tree can tell "nothing happened" from
+ * "read it again" without doing the read. A gate, never a source.
+ */
+export interface FsRevision {
+    /**
+     * Current revision, or `undefined` when the host cannot tell — which callers
+     * read as "recompute", the same as a host with no port at all.
+     *
+     * The number is opaque and only comparable for equality. It covers the whole
+     * filesystem the host exposes, so it moves for writes the caller does not care
+     * about: a gate on it recomputes more often than needed, never less.
+     *
+     * Never rejects: a host that cannot answer says so with `undefined`.
+     */
+    current(): Promise<number | undefined>;
+}
+//# sourceMappingURL=fs-revision.d.ts.map

package/dist/platform/fs-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-revision.d.ts","sourceRoot":"","sources":["../../src/platform/fs-revision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IAC1B;;;;;;;;;OASG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACtC"}

package/dist/platform/fs-revision.js

@@ -0,0 +1,9 @@
+/**
+ * Filesystem revision adapter.
+ *
+ * One number that moves whenever anything in the host's filesystem changes, so a
+ * caller holding an answer derived from the tree can tell "nothing happened" from
+ * "read it again" without doing the read. A gate, never a source.
+ */
+export {};
+//# sourceMappingURL=fs-revision.js.map

package/dist/platform/fs-revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-revision.js","sourceRoot":"","sources":["../../src/platform/fs-revision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/platform/fs.d.ts

@@ -7,6 +7,20 @@
 import type { Dirent, Stats } from 'node:fs';
 import type { FileHandle } from 'node:fs/promises';
 export type { Dirent, FileHandle, Stats };
+/**
+ * Positional-read handle — the subset of `node:fs/promises` FileHandle the SDK uses.
+ *
+ * Narrower than `FileHandle` so a platform exposing only raw fds can implement it.
+ * `FileHandle` satisfies it.
+ */
+export interface ReadableFileHandle {
+    stat(): Promise<Stats>;
+    read(buffer: Buffer, offset: number, length: number, position: number): Promise<{
+        bytesRead: number;
+        buffer: Buffer;
+    }>;
+    close(): Promise<void>;
+}
 export interface FileSystem {
     readFile(path: string): Promise<Buffer>;
     readFile(path: string, encoding: 'utf-8' | 'utf8'): Promise<string>;
@@ -20,6 +34,11 @@ export interface FileSystem {
         withFileTypes: true;
     }): Promise<Dirent[]>;
     stat(path: string): Promise<Stats>;
+    /**
+     * Like `stat`, but reports the link itself instead of following it. Answers for
+     * a link whose target is gone, where `realpath` rejects.
+     */
+    lstat(path: string): Promise<Stats>;
     access(path: string, mode?: number): Promise<void>;
     unlink(path: string): Promise<void>;
     rm(path: string, options?: {
@@ -30,10 +49,94 @@ export interface FileSystem {
         recursive?: boolean;
         force?: boolean;
     }): Promise<void>;
-    open(path: string, flags?: string): Promise<FileHandle>;
+    open(path: string, flags?: string): Promise<ReadableFileHandle>;
     /** Returns true if path exists and is accessible; never throws for missing paths. */
     exists(path: string): Promise<boolean>;
     /** Resolves symlinks and returns the canonical pathname. */
     realpath(path: string): Promise<string>;
+    /**
+     * Optional. Every entry under `dir`, with the metadata a stat would return.
+     *
+     * Walking with readdir and stat asks the platform one question per entry and
+     * gives it no way to see that they belong together; asking for the subtree does.
+     * Absent on a plain node:fs platform, where the walk is what it would do anyway.
+     *
+     * `exclude` and `excludeHidden` are passed in so the platform can skip a
+     * subtree rather than return it for the caller to discard.
+     */
+    walk?(dir: string, options?: WalkOptions): Promise<WalkEntry[]>;
+    /**
+     * Optional. Every byte of every path, asked for once.
+     *
+     * Reports per path instead of throwing, because a batch that threw on the first
+     * missing file would send the caller back to asking one at a time. Entries come
+     * back in the order they were asked for.
+     */
+    readFiles?(paths: readonly string[]): Promise<ReadFilesEntry[]>;
+    /** Optional. Write a set of files as one operation. */
+    writeFiles?(entries: readonly WriteFilesEntry[], options?: WriteFilesOptions): Promise<void>;
+    /**
+     * Optional. Remove a set of paths as one operation.
+     *
+     * Raises what `rm` raises, for the same reasons. A failure partway through
+     * leaves the paths before it removed.
+     */
+    rmFiles?(paths: readonly string[], options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Optional. Run `fn` with reads served from a per-operation cache, where the
+     * platform has one.
+     *
+     * A hint and nothing more: the same calls return the same answers with or
+     * without it. Prefer a verb where one fits — a verb cannot be forgotten the way
+     * a wrapper can.
+     */
+    scopeReads?<T>(fn: () => Promise<T>): Promise<T>;
+}
+/** One entry under a walked directory. */
+export interface WalkEntry {
+    /** Absolute path. */
+    path: string;
+    /**
+     * `other` covers what a walk can find but not classify — a FIFO, a socket.
+     * A symlink is reported as one whether or not its target resolves, so a
+     * broken link is still listed rather than silently dropped.
+     */
+    type: 'file' | 'directory' | 'symlink' | 'other';
+    /**
+     * Bytes as `stat` reports them, so a symlink carries its target's size: the
+     * loop this verb replaces follows the link, and a walk that did not would
+     * disagree with it. 0 for a directory, and for a link whose target is gone.
+     */
+    size: number;
+    mtime: number;
+}
+/** One path's answer from `readFiles`, in the order it was asked for. */
+export interface ReadFilesEntry {
+    path: string;
+    /** The bytes, or absent when `error` says why there are none. */
+    content?: Buffer;
+    /** The code `readFile` would have thrown for this path. */
+    error?: string;
+}
+export interface WriteFilesEntry {
+    path: string;
+    content: string | Uint8Array;
+}
+export interface WriteFilesOptions {
+    /** Create the directories the entries need, as `mkdir -p` would. Off by default. */
+    createParents?: boolean;
+}
+export interface WalkOptions {
+    /** Levels to descend. 1 is the directory's own children; unlimited when absent. */
+    depth?: number;
+    /** Entries to return at most, in traversal order. */
+    limit?: number;
+    /** Names never returned and, for a directory, never descended into. */
+    exclude?: readonly string[];
+    /** The same, for every name beginning with a dot. */
+    excludeHidden?: boolean;
 }
 //# sourceMappingURL=fs.d.ts.map

package/dist/platform/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/platform/fs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAEzC,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE1E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnF,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAEvD,qFAAqF;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvC"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/platform/fs.ts"],"names":[],"mappings":"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"}

package/dist/platform/git.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Git adapter interface.
+ *
+ * Deliberately not a git binding: it names the questions `git-status` asks, so a
+ * host can answer them however it can — a `git` process, or a library over a VFS.
+ */
+/** Every operation is scoped to one working tree. */
+export interface GitRepoOptions {
+    /** Working-tree directory of the repository. */
+    dir: string;
+}
+/**
+ * One non-clean path, following git's XY convention: `index` is the staged
+ * delta against HEAD, `worktree` the unstaged delta against the staged version.
+ */
+export interface GitStatusEntry {
+    path: string;
+    index: ' ' | 'A' | 'M' | 'D';
+    worktree: ' ' | 'A' | 'M' | 'D' | '?';
+}
+export interface GitCommit {
+    oid: string;
+    /** Full commit message, subject line first. */
+    message: string;
+    /** Commit time in ms since epoch, like every other SDK timestamp. */
+    committedAt: number;
+}
+export interface GitLogOptions extends GitRepoOptions {
+    /** Ref to walk back from. Defaults to HEAD. */
+    ref?: string;
+    /** Max commits to return. Unbounded when omitted. */
+    depth?: number;
+}
+export interface GitCountAheadOptions extends GitRepoOptions {
+    /** Ref the count is measured from. */
+    base: string;
+    /** Ref being measured. Defaults to HEAD. */
+    ref?: string;
+}
+/**
+ * Read-only git queries over a working tree.
+ *
+ * Every method rejects when `dir` is not inside a repository; callers read that
+ * as "no git state to report", not as a host failure.
+ */
+export interface GitClient {
+    /** Paths that are not clean — `git status --porcelain`. */
+    status(options: GitRepoOptions): Promise<GitStatusEntry[]>;
+    /** Commits reachable from `ref`, newest first — `git log`. */
+    log(options: GitLogOptions): Promise<GitCommit[]>;
+    /** Commits in `ref` but not in `base` — `git rev-list --count <base>..<ref>`. */
+    countAhead(options: GitCountAheadOptions): Promise<number>;
+    /**
+     * Branch new commits are measured against — the remote's HEAD, where the host
+     * can read one. `undefined` means unknown, so the caller applies its own default.
+     */
+    defaultBranch(options: GitRepoOptions): Promise<string | undefined>;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/platform/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/platform/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC9B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC5B,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACpD,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAE1D,8DAA8D;IAC9D,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAEjD,iFAAiF;IACjF,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE1D;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACnE"}

package/dist/platform/git.js

@@ -0,0 +1,8 @@
+/**
+ * Git adapter interface.
+ *
+ * Deliberately not a git binding: it names the questions `git-status` asks, so a
+ * host can answer them however it can — a `git` process, or a library over a VFS.
+ */
+export {};
+//# sourceMappingURL=git.js.map

package/dist/platform/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/platform/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/platform/index.d.ts

@@ -6,15 +6,54 @@
  * runtime packages (e.g. `@roj-ai/sdk/bun-platform`) and wired in at bootstrap time.
  */
 import type { FileSystem } from './fs.js';
+import type { FsRevision } from './fs-revision.js';
+import type { GitClient } from './git.js';
+import type { LLMCallStore } from './llm-call-log.js';
 import type { ProcessRunner } from './process.js';
-export type { Dirent, FileHandle, FileSystem, Stats } from './fs.js';
+import type { Scheduler } from './scheduler.js';
+import type { SessionLogStore } from './session-log.js';
+import type { ShellRunner } from './shell.js';
+export type { Dirent, FileHandle, FileSystem, ReadableFileHandle, ReadFilesEntry, Stats, WalkEntry, WalkOptions, WriteFilesEntry, WriteFilesOptions, } from './fs.js';
+export type { FsRevision } from './fs-revision.js';
+export type { GitClient, GitCommit, GitCountAheadOptions, GitLogOptions, GitRepoOptions, GitStatusEntry } from './git.js';
+export type { LLMCallOutcome, LLMCallPage, LLMCallRow, LLMCallStatus, LLMCallStore } from './llm-call-log.js';
 export type { ChildProcess, ExecFileOptions, ExecFileResult, ProcessRunner, SpawnOptions } from './process.js';
+export { createTimerScheduler, isLiveScheduler } from './scheduler.js';
+export type { LiveScheduler, Scheduler, WakeHandler } from './scheduler.js';
+export type { SessionLogPage, SessionLogStore } from './session-log.js';
+export type { ShellConfinement, ShellGrant, ShellLimits, ShellRunner, ShellRunOptions, ShellRunResult } from './shell.js';
 /**
  * Aggregate platform capabilities passed through the system at bootstrap.
+ *
+ * `fs`, `process` and `scheduler` are required — every host has them, even if a
+ * process table is only a stub. The rest are optional: a host that omits one is
+ * not degraded, it is a host whose callers take the path they took before the
+ * port existed.
  */
 export interface Platform {
     fs: FileSystem;
     process: ProcessRunner;
+    /** Delayed re-entry into the agent loop. Required: every host can schedule. */
+    scheduler: Scheduler;
+    /** Runs the shell tool's command lines. Absent on a host with no shell at all. */
+    shell?: ShellRunner;
+    /** Git over the host's repositories. Absent on hosts that cannot run git. */
+    git?: GitClient;
+    /**
+     * Cheap "has the filesystem changed" counter. Absent on hosts that cannot
+     * answer it, which then recompute whatever they would have gated on.
+     */
+    fsRevision?: FsRevision;
+    /**
+     * Rows for the per-session log. Absent on hosts with real files, which keep
+     * writing `sessions/<id>/session.log` and cursoring it by byte offset.
+     */
+    sessionLog?: SessionLogStore;
+    /**
+     * Rows for the LLM call log. Absent on hosts with real files, which keep
+     * writing `sessions/<id>/calls/<callId>.json` and listing that directory.
+     */
+    llmCallLog?: LLMCallStore;
     /** Absolute path to the OS temp directory (equivalent to `os.tmpdir()` on Node/Bun). */
     tmpDir: string;
 }

package/dist/platform/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE9G;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;IACtB,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAA;CACd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,YAAY,EACX,MAAM,EACN,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,KAAK,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,iBAAiB,GACjB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC7G,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACtE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC3E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEzH;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;IACtB,+EAA+E;IAC/E,SAAS,EAAE,SAAS,CAAA;IACpB,kFAAkF;IAClF,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAA;CACd"}

package/dist/platform/index.js

@@ -5,5 +5,5 @@
  * it goes through these adapters. Concrete implementations are provided by
  * runtime packages (e.g. `@roj-ai/sdk/bun-platform`) and wired in at bootstrap time.
  */
-export {};
+export { createTimerScheduler, isLiveScheduler } from './scheduler.js';
 //# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/platform/llm-call-log.d.ts

@@ -0,0 +1,80 @@
+/**
+ * LLM call-log store adapter.
+ *
+ * `LLMLogger` keeps the complete request and response of every inference. As
+ * files that is one JSON blob per call, written twice and read back in between.
+ * On a host whose filesystem is itself SQLite, rows are cheaper.
+ *
+ * The row is split rather than held as one blob so `complete` is a bounded
+ * `UPDATE` that never re-reads or re-writes the request it belongs to.
+ */
+/** The three states a logged call can be in. */
+export type LLMCallStatus = 'running' | 'success' | 'error';
+/**
+ * One logged call, as columns. Scalars are what a listing filters, orders and
+ * pages on; the rest is JSON the store carries without reading.
+ */
+export interface LLMCallRow {
+    /** UUIDv7. Sortable, so it is both the identity and the order — see `list`. */
+    callId: string;
+    agentId: string;
+    createdAt: number;
+    status: LLMCallStatus;
+    /** Copied out of `request` so a listing can show it without parsing the blob. */
+    model: string;
+    /** Serialized `LLMCallRequest`. Written once and never rewritten. */
+    request: string;
+    completedAt?: number;
+    durationMs?: number;
+    providerRequestId?: string;
+    /** Serialized `LLMCallResponse`. Absent while the call is still running. */
+    response?: string;
+    /** Serialized `LLMCallMetrics`. Absent until the call succeeds. */
+    metrics?: string;
+    /** Serialized `LLMCallError`. Absent unless the call failed. */
+    error?: string;
+}
+/** Everything a finished call adds to its row. The request is never part of it. */
+export interface LLMCallOutcome {
+    status: 'success' | 'error';
+    completedAt: number;
+    durationMs: number;
+    providerRequestId?: string;
+    response?: string;
+    metrics?: string;
+    error?: string;
+}
+export interface LLMCallPage {
+    calls: LLMCallRow[];
+    /** Calls the session holds, before `limit`/`offset` — what the UI shows as the count. */
+    total: number;
+}
+export interface LLMCallStore {
+    /**
+     * Largest value one column can hold, where the host has a ceiling. The caller
+     * clamps `request` to it rather than letting an oversized prompt turn a logged
+     * call into a failed inference. Absent means no ceiling and no clamping.
+     */
+    readonly maxBlobBytes?: number;
+    /** Record a call that has just started. */
+    create(sessionId: string, row: LLMCallRow): Promise<void>;
+    /**
+     * Attach the outcome to a call already recorded. A call id the store does not
+     * hold is not an error — a reap between the two halves of one inference is
+     * exactly that case.
+     */
+    complete(sessionId: string, callId: string, outcome: LLMCallOutcome): Promise<void>;
+    get(sessionId: string, callId: string): Promise<LLMCallRow | null>;
+    /**
+     * One page of a session's calls, newest first, ordered by `callId` descending.
+     * UUIDv7 is time-ordered and fixed width, so that order is chronological and
+     * total — two calls in the same millisecond still page without overlapping.
+     */
+    list(sessionId: string, options: {
+        limit: number;
+        offset: number;
+    }): Promise<LLMCallPage>;
+    /** Drop every call held for one session, and report how many went. */
+    delete(sessionId: string): Promise<number>;
+}
+//# sourceMappingURL=llm-call-log.d.ts.map

package/dist/platform/llm-call-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-call-log.d.ts","sourceRoot":"","sources":["../../src/platform/llm-call-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE3D;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;IACrB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAE9B,2CAA2C;IAC3C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnF,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAElE;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAEzF,sEAAsE;IACtE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1C"}

package/dist/platform/llm-call-log.js

@@ -0,0 +1,12 @@
+/**
+ * LLM call-log store adapter.
+ *
+ * `LLMLogger` keeps the complete request and response of every inference. As
+ * files that is one JSON blob per call, written twice and read back in between.
+ * On a host whose filesystem is itself SQLite, rows are cheaper.
+ *
+ * The row is split rather than held as one blob so `complete` is a bounded
+ * `UPDATE` that never re-reads or re-writes the request it belongs to.
+ */
+export {};
+//# sourceMappingURL=llm-call-log.js.map

package/dist/platform/llm-call-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-call-log.js","sourceRoot":"","sources":["../../src/platform/llm-call-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/platform/scheduler.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Scheduler adapter interface.
+ *
+ * The agent loop re-enters through this port instead of a bare `setTimeout`, so
+ * a host with no live process between wakes can drive it — on Cloudflare,
+ * `ctx.storage.setAlarm()` then `alarm()`.
+ */
+/** Called when a wake armed for `key` comes due. */
+export type WakeHandler = (key: string) => void | Promise<void>;
+export interface Scheduler {
+    /** Wake `key` after `delayMs`. Replaces any pending wake for the same key. */
+    wake(key: string, delayMs: number): Promise<void>;
+    cancel(key: string): Promise<void>;
+}
+/**
+ * A scheduler that delivers its own wakes, because the process that armed them
+ * is still alive. Hosts that deliver out-of-band implement plain {@link Scheduler}
+ * and call `SessionManager.dispatchWake` from their own handler.
+ */
+export interface LiveScheduler extends Scheduler {
+    /** Register where due wakes are delivered. Replaces any previous handler. */
+    onWake(handler: WakeHandler): void;
+}
+export declare function isLiveScheduler(scheduler: Scheduler): scheduler is LiveScheduler;
+/**
+ * `setTimeout`-backed scheduler for hosts with a live process.
+ *
+ * Arms and clears synchronously, so the cancel-then-wake sequence callers issue
+ * without awaiting cannot land out of order.
+ */
+export declare function createTimerScheduler(): LiveScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/platform/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/platform/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/D,MAAM,WAAW,SAAS;IACzB,8EAA8E;IAC9E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC/C,6EAA6E;IAC7E,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAClC;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,IAAI,aAAa,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAiCpD"}

package/dist/platform/scheduler.js

@@ -0,0 +1,46 @@
+/**
+ * Scheduler adapter interface.
+ *
+ * The agent loop re-enters through this port instead of a bare `setTimeout`, so
+ * a host with no live process between wakes can drive it — on Cloudflare,
+ * `ctx.storage.setAlarm()` then `alarm()`.
+ */
+export function isLiveScheduler(scheduler) {
+    return 'onWake' in scheduler && typeof scheduler.onWake === 'function';
+}
+/**
+ * `setTimeout`-backed scheduler for hosts with a live process.
+ *
+ * Arms and clears synchronously, so the cancel-then-wake sequence callers issue
+ * without awaiting cannot land out of order.
+ */
+export function createTimerScheduler() {
+    const timers = new Map();
+    let handler;
+    const clear = (key) => {
+        const timer = timers.get(key);
+        if (timer === undefined)
+            return;
+        clearTimeout(timer);
+        timers.delete(key);
+    };
+    return {
+        onWake(next) {
+            handler = next;
+        },
+        async wake(key, delayMs) {
+            clear(key);
+            timers.set(key, setTimeout(() => {
+                timers.delete(key);
+                const dispatched = handler?.(key);
+                // The handler owns its own error reporting; there is nothing a timer can do.
+                if (dispatched)
+                    void dispatched.catch(() => { });
+            }, delayMs));
+        },
+        async cancel(key) {
+            clear(key);
+        },
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/platform/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/platform/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,UAAU,eAAe,CAAC,SAAoB;IACnD,OAAO,QAAQ,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU,CAAA;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAA;IAC/D,IAAI,OAAgC,CAAA;IAEpC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAM;QAC/B,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC,CAAA;IAED,OAAO;QACN,MAAM,CAAC,IAAiB;YACvB,OAAO,GAAG,IAAI,CAAA;QACf,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAe;YACtC,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,CAAC,GAAG,CACT,GAAG,EACH,UAAU,CAAC,GAAG,EAAE;gBACf,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAClB,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;gBACjC,6EAA6E;gBAC7E,IAAI,UAAU;oBAAE,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAChD,CAAC,EAAE,OAAO,CAAC,CACX,CAAA;QACF,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAW;YACvB,KAAK,CAAC,GAAG,CAAC,CAAA;QACX,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/platform/session-log.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Session-log store adapter.
+ *
+ * `session.log` is the detailed record of one session. On a host with real files
+ * it is a JSONL file appended to, which is the right shape there. On a host whose
+ * filesystem is itself SQLite it is not, so this port lets it spend rows instead.
+ *
+ * Optional: a host without a table is unchanged — `SessionManager` writes the file
+ * it always wrote and `logs.tail` cursors it by byte offset.
+ */
+export interface SessionLogPage {
+    /** One serialized JSON object per entry, without the trailing newline. */
+    lines: string[];
+    /**
+     * Cursor to hand back as `since` on the next read.
+     *
+     * Opaque and only comparable with itself: a file-backed log counts bytes and a
+     * store-backed one counts entries, and no caller may assume which.
+     */
+    offset: number;
+}
+export interface SessionLogStore {
+    /**
+     * Record one already-serialized line.
+     *
+     * Returns nothing rather than a promise, and must never throw: logging sits on
+     * the agent loop's path and nothing there awaits it. A store that cannot write
+     * drops the line, exactly as a failed file append is swallowed.
+     */
+    append(sessionId: string, line: string): void;
+    /** Entries recorded after `since`, and the cursor that follows them. */
+    read(sessionId: string, since: number): Promise<SessionLogPage>;
+    /** Drop every entry held for one session, and report how many went. */
+    delete(sessionId: string): Promise<number>;
+}
+//# sourceMappingURL=session-log.d.ts.map

package/dist/platform/session-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.d.ts","sourceRoot":"","sources":["../../src/platform/session-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7C,wEAAwE;IACxE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAE/D,uEAAuE;IACvE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1C"}

package/dist/platform/session-log.js

@@ -0,0 +1,12 @@
+/**
+ * Session-log store adapter.
+ *
+ * `session.log` is the detailed record of one session. On a host with real files
+ * it is a JSONL file appended to, which is the right shape there. On a host whose
+ * filesystem is itself SQLite it is not, so this port lets it spend rows instead.
+ *
+ * Optional: a host without a table is unchanged — `SessionManager` writes the file
+ * it always wrote and `logs.tail` cursors it by byte offset.
+ */
+export {};
+//# sourceMappingURL=session-log.js.map

package/dist/platform/session-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.js","sourceRoot":"","sources":["../../src/platform/session-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}