instar 0.28.113 → 0.28.115

package/dist/providers/primitives/control/stopGateInterceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopGateInterceptor.js","sourceRoot":"","sources":["../../../../src/providers/primitives/control/stopGateInterceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/providers/primitives/control/timeoutBound.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TimeoutBound — enforce a maximum wall-clock duration on a session.
+ *
+ * Distinct from per-call timeouts (which are part of CancellationOptions
+ * on individual primitive methods). This primitive enforces a session-level
+ * deadline: after N minutes of wall-clock time, the session is hard-killed
+ * regardless of state.
+ *
+ * Used by Instar's existing `maxDurationMinutes` mechanism on jobs and
+ * spawned sessions. Provides a safety ceiling so a runaway agent can't
+ * consume unbounded resources.
+ *
+ * Maps to:
+ *   - Claude: instar enforces externally (no native Claude support today)
+ *   - Codex: per-subagent `job_max_runtime_seconds`; for top-level sessions
+ *     instar enforces externally
+ *
+ * Both providers lack native session-level timeouts today, so most
+ * adapters implement this by tracking session start time and triggering
+ * HardKill at the deadline.
+ */
+import type { CancellationOptions, SessionHandle } from '../../types.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface TimeoutBound {
+    readonly capability: typeof CapabilityFlag.TimeoutBound;
+    /**
+     * Set the session's maximum duration. Adapter records the deadline and
+     * kills the session when reached. Calling again replaces the previous
+     * deadline.
+     */
+    setDeadline(session: SessionHandle, durationMinutes: number, options?: TimeoutBoundOptions): Promise<void>;
+    /**
+     * Get the current deadline for a session, or null if none is set.
+     */
+    getDeadline(session: SessionHandle, options?: CancellationOptions): Promise<{
+        deadlineAt: string;
+        remainingMs: number;
+    } | null>;
+    /**
+     * Cancel a previously-set deadline (the session can now run indefinitely).
+     */
+    clearDeadline(session: SessionHandle, options?: CancellationOptions): Promise<void>;
+}
+export interface TimeoutBoundOptions extends CancellationOptions {
+    /**
+     * Action when the deadline expires. Default: 'hard-kill'.
+     * 'graceful' attempts graceful end first; 'hard-kill' goes straight to
+     * forced termination.
+     */
+    expiryAction?: 'graceful' | 'hard-kill';
+    /** Optional reason recorded in audit logs. */
+    reason?: string;
+}
+//# sourceMappingURL=timeoutBound.d.ts.map

package/dist/providers/primitives/control/timeoutBound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutBound.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/control/timeoutBound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,YAAY,CAAC;IAExD;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,aAAa,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,WAAW,CACT,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE/D;;OAEG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACxC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/providers/primitives/control/timeoutBound.js

@@ -0,0 +1,23 @@
+/**
+ * TimeoutBound — enforce a maximum wall-clock duration on a session.
+ *
+ * Distinct from per-call timeouts (which are part of CancellationOptions
+ * on individual primitive methods). This primitive enforces a session-level
+ * deadline: after N minutes of wall-clock time, the session is hard-killed
+ * regardless of state.
+ *
+ * Used by Instar's existing `maxDurationMinutes` mechanism on jobs and
+ * spawned sessions. Provides a safety ceiling so a runaway agent can't
+ * consume unbounded resources.
+ *
+ * Maps to:
+ *   - Claude: instar enforces externally (no native Claude support today)
+ *   - Codex: per-subagent `job_max_runtime_seconds`; for top-level sessions
+ *     instar enforces externally
+ *
+ * Both providers lack native session-level timeouts today, so most
+ * adapters implement this by tracking session start time and triggering
+ * HardKill at the deadline.
+ */
+export {};
+//# sourceMappingURL=timeoutBound.js.map

package/dist/providers/primitives/control/timeoutBound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutBound.js","sourceRoot":"","sources":["../../../../src/providers/primitives/control/timeoutBound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/providers/primitives/integration/conversationLogProvider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ConversationLogProvider — unified view of a session's log (read + tail).
+ *
+ * Composite primitive that bundles ConversationLogReader (post-hoc finite
+ * read) and ConversationLogTailer (real-time growing tail) into a single
+ * convenience interface. Callers that need both — i.e., "give me what's
+ * already there and then keep delivering new entries" — use this.
+ *
+ * Adapters implementing this primitive MUST also implement both
+ * conversationLogReader and conversationLogTailer; the composite is a
+ * shorthand, not an independent capability.
+ */
+import type { CancellationOptions, SessionHandle } from '../../types.js';
+import type { CanonicalEvent } from '../../events.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface ConversationLogProvider {
+    readonly capability: typeof CapabilityFlag.ConversationLogProvider;
+    /**
+     * Read existing events, then continue tailing new ones. Equivalent to
+     * `conversationLogReader.readStream() then conversationLogTailer.tail()`
+     * but the adapter handles the seamless handoff (no events dropped or
+     * duplicated at the boundary).
+     */
+    readAndTail(session: SessionHandle, options?: ConversationLogProviderOptions): AsyncIterable<CanonicalEvent>;
+}
+export interface ConversationLogProviderOptions extends CancellationOptions {
+    /** Filter by event type. */
+    types?: ReadonlyArray<CanonicalEvent['type']>;
+    /**
+     * If set, skip existing events before this timestamp. Useful when
+     * resuming a tail that previously got partway through.
+     */
+    since?: string;
+}
+//# sourceMappingURL=conversationLogProvider.d.ts.map

package/dist/providers/primitives/integration/conversationLogProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/conversationLogProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,uBAAuB,CAAC;IAEnE;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,8BAA8B,GACvC,aAAa,CAAC,cAAc,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE,4BAA4B;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/providers/primitives/integration/conversationLogProvider.js

@@ -0,0 +1,14 @@
+/**
+ * ConversationLogProvider — unified view of a session's log (read + tail).
+ *
+ * Composite primitive that bundles ConversationLogReader (post-hoc finite
+ * read) and ConversationLogTailer (real-time growing tail) into a single
+ * convenience interface. Callers that need both — i.e., "give me what's
+ * already there and then keep delivering new entries" — use this.
+ *
+ * Adapters implementing this primitive MUST also implement both
+ * conversationLogReader and conversationLogTailer; the composite is a
+ * shorthand, not an independent capability.
+ */
+export {};
+//# sourceMappingURL=conversationLogProvider.js.map

package/dist/providers/primitives/integration/conversationLogProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogProvider.js","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/conversationLogProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/providers/primitives/integration/mcpToolRegistry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * McpToolRegistry — register Instar's MCP tools with the provider's host.
+ *
+ * Maps to:
+ *   - Claude: writes to `~/.claude.json` (project or user scope), declares
+ *     MCP server name, transport, and command
+ *   - Codex: `[mcp_servers.<id>]` TOML tables in `~/.codex/config.toml`;
+ *     requires both server name AND identity (command/url value) to match
+ *     for security
+ *
+ * Asymmetric on the identity check: Codex requires identity match for an
+ * MCP server to be enabled; Claude matches by name only. Including identity
+ * never hurts portability — Claude silently ignores it.
+ *
+ * Used by Threadline's ThreadlineBootstrap to expose `threadline_send`,
+ * `threadline_discover`, etc. as MCP tools that Claude/Codex can invoke.
+ * Phase 3 refactor pulls the bootstrap code through this primitive.
+ */
+import type { CancellationOptions } from '../../types.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface McpToolRegistry {
+    readonly capability: typeof CapabilityFlag.McpToolRegistry;
+    /** Register an MCP server with this provider's host. */
+    register(spec: McpServerSpec, options?: McpRegistryOptions): Promise<void>;
+    /** Unregister an MCP server by name. */
+    unregister(name: string, options?: McpRegistryOptions): Promise<void>;
+    /** List currently-registered MCP servers. */
+    list(options?: CancellationOptions): Promise<ReadonlyArray<McpServerSpec>>;
+    /** Check whether a specific server is registered. */
+    isRegistered(name: string, options?: CancellationOptions): Promise<boolean>;
+}
+export type McpServerSpec = {
+    kind: 'stdio';
+    /** Server name (matched on both providers). */
+    name: string;
+    /** Command to spawn the server. Codex matches this for identity. */
+    command: string;
+    args?: ReadonlyArray<string>;
+    env?: Readonly<Record<string, string>>;
+} | {
+    kind: 'http';
+    name: string;
+    /** URL endpoint. Codex matches this for identity. */
+    url: string;
+    headers?: Readonly<Record<string, string>>;
+};
+export interface McpRegistryOptions extends CancellationOptions {
+    /**
+     * Scope to register in. Default: 'user' (~/.claude.json or ~/.codex/...).
+     * 'project' writes to `.claude/settings.json` or `.codex/config.toml`
+     * in the current project root.
+     */
+    scope?: 'user' | 'project';
+}
+//# sourceMappingURL=mcpToolRegistry.d.ts.map

package/dist/providers/primitives/integration/mcpToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolRegistry.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/mcpToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,eAAe,CAAC;IAE3D,wDAAwD;IACxD,QAAQ,CACN,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,wCAAwC;IACxC,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,6CAA6C;IAC7C,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE3E,qDAAqD;IACrD,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEN,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B"}

package/dist/providers/primitives/integration/mcpToolRegistry.js

@@ -0,0 +1,20 @@
+/**
+ * McpToolRegistry — register Instar's MCP tools with the provider's host.
+ *
+ * Maps to:
+ *   - Claude: writes to `~/.claude.json` (project or user scope), declares
+ *     MCP server name, transport, and command
+ *   - Codex: `[mcp_servers.<id>]` TOML tables in `~/.codex/config.toml`;
+ *     requires both server name AND identity (command/url value) to match
+ *     for security
+ *
+ * Asymmetric on the identity check: Codex requires identity match for an
+ * MCP server to be enabled; Claude matches by name only. Including identity
+ * never hurts portability — Claude silently ignores it.
+ *
+ * Used by Threadline's ThreadlineBootstrap to expose `threadline_send`,
+ * `threadline_discover`, etc. as MCP tools that Claude/Codex can invoke.
+ * Phase 3 refactor pulls the bootstrap code through this primitive.
+ */
+export {};
+//# sourceMappingURL=mcpToolRegistry.js.map

package/dist/providers/primitives/integration/mcpToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolRegistry.js","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/mcpToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/providers/primitives/integration/providerScaffolder.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ProviderScaffolder — install per-provider configuration at agent init time.
+ *
+ * Different providers expect different files in different places:
+ *   - Claude: `.claude/settings.json`, `.claude/scripts/`, `.claude/skills/`,
+ *     CLAUDE.md in project root, hook script registrations
+ *   - Codex: `~/.codex/hooks.json` or `config.toml`, `.codex/agents/*.toml`,
+ *     `.codex/skills/<name>/SKILL.md`, AGENTS.md in project root
+ *
+ * The Instar provider-abstraction project standardizes on `.agent/<provider>/`
+ * for per-provider scaffolding (instead of `.claude/` directly). This
+ * primitive performs the install during agent initialization and during
+ * provider-switching migrations.
+ *
+ * Used by:
+ *   - commands/init.ts (will be refactored in Phase 3 to use this)
+ *   - commands/setup.ts
+ *   - migration script (Phase 7)
+ *
+ * Adapters know what files they need; consumers just ask for "scaffold
+ * for this project root."
+ */
+import type { CancellationOptions } from '../../types.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface ProviderScaffolder {
+    readonly capability: typeof CapabilityFlag.ProviderScaffolder;
+    /**
+     * Install this provider's scaffolding under the given project root.
+     * Idempotent — calling twice is safe; the adapter detects existing
+     * scaffolding and skips or upgrades as appropriate.
+     */
+    install(projectRoot: string, options?: ProviderScaffoldOptions): Promise<ScaffoldResult>;
+    /**
+     * Verify scaffolding is intact under the given project root. Returns
+     * a report of what's present, missing, or modified from expected.
+     */
+    verify(projectRoot: string, options?: CancellationOptions): Promise<ScaffoldVerification>;
+    /**
+     * Remove this provider's scaffolding. Used during provider-switching
+     * (uninstall the old provider before installing the new one).
+     */
+    uninstall(projectRoot: string, options?: ProviderScaffoldOptions): Promise<void>;
+}
+export interface ProviderScaffoldOptions extends CancellationOptions {
+    /** Whether to overwrite existing files without confirmation. Default: false. */
+    force?: boolean;
+    /**
+     * Hooks to install. Subset of the provider's supported event kinds; the
+     * adapter materializes hook scripts that POST events to instar's HTTP
+     * endpoint.
+     */
+    hookEvents?: ReadonlyArray<string>;
+    /**
+     * Skills/agents to install. Adapter materializes them in the provider's
+     * native skill/agent format (Claude's .claude/skills/, Codex's
+     * .codex/agents/).
+     */
+    bundledAssets?: ReadonlyArray<ScaffoldAsset>;
+}
+export interface ScaffoldAsset {
+    kind: 'skill' | 'subagent' | 'hook-script' | 'instruction-file';
+    name: string;
+    /** Contents of the asset. */
+    content: string;
+}
+export interface ScaffoldResult {
+    /** Paths that were created. */
+    created: ReadonlyArray<string>;
+    /** Paths that were updated. */
+    updated: ReadonlyArray<string>;
+    /** Paths that were left as-is (already correct). */
+    unchanged: ReadonlyArray<string>;
+}
+export interface ScaffoldVerification {
+    /** All expected files are present and correct. */
+    intact: boolean;
+    /** Files expected but missing. */
+    missing: ReadonlyArray<string>;
+    /** Files present but modified from expected content. */
+    modified: ReadonlyArray<string>;
+    /** Files present that the scaffolder doesn't know about. */
+    extraneous: ReadonlyArray<string>;
+}
+//# sourceMappingURL=providerScaffolder.d.ts.map

package/dist/providers/primitives/integration/providerScaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/providerScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,kBAAkB,CAAC;IAE9D;;;;OAIG;IACH,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;OAGG;IACH,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,kBAAkB,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,oDAAoD;IACpD,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,4DAA4D;IAC5D,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC"}

package/dist/providers/primitives/integration/providerScaffolder.js

@@ -0,0 +1,24 @@
+/**
+ * ProviderScaffolder — install per-provider configuration at agent init time.
+ *
+ * Different providers expect different files in different places:
+ *   - Claude: `.claude/settings.json`, `.claude/scripts/`, `.claude/skills/`,
+ *     CLAUDE.md in project root, hook script registrations
+ *   - Codex: `~/.codex/hooks.json` or `config.toml`, `.codex/agents/*.toml`,
+ *     `.codex/skills/<name>/SKILL.md`, AGENTS.md in project root
+ *
+ * The Instar provider-abstraction project standardizes on `.agent/<provider>/`
+ * for per-provider scaffolding (instead of `.claude/` directly). This
+ * primitive performs the install during agent initialization and during
+ * provider-switching migrations.
+ *
+ * Used by:
+ *   - commands/init.ts (will be refactored in Phase 3 to use this)
+ *   - commands/setup.ts
+ *   - migration script (Phase 7)
+ *
+ * Adapters know what files they need; consumers just ask for "scaffold
+ * for this project root."
+ */
+export {};
+//# sourceMappingURL=providerScaffolder.js.map

package/dist/providers/primitives/integration/providerScaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerScaffolder.js","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/providerScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/providers/primitives/integration/sessionResumeIndex.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SessionResumeIndex — provider-side index of resumable sessions.
+ *
+ * Maps to:
+ *   - Claude: `~/.claude/projects/<encoded-path>/<uuid>.jsonl` files, flat
+ *     by UUID
+ *   - Codex: `~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl`
+ *     date-partitioned, plus SQLite index at `sqlite_home`. Codex also
+ *     has `codex resume` picker, `--last`, `--all`, and `codex fork`.
+ *
+ * The abstraction surfaces a uniform "find this session and resume it"
+ * interface without exposing the underlying directory layout. Adapters
+ * resolve via their native index.
+ *
+ * Used by Instar's TopicResumeMap (server/routes.ts) and ThreadResumeMap
+ * (threadline/). The fields `claudeSessionId` in those modules become
+ * `providerSessionId` post-migration; the resume index handles the lookup.
+ */
+import type { CancellationOptions, ProviderSpecific, SessionHandle } from '../../types.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface SessionResumeIndex {
+    readonly capability: typeof CapabilityFlag.SessionResumeIndex;
+    /** Find a resumable session by provider-side ID. */
+    findById(providerSessionId: string, options?: CancellationOptions): Promise<ResumableSession | null>;
+    /**
+     * Find the most recent resumable session(s). Optionally scoped to a
+     * project root (Codex's `--last` semantics, when scope provided).
+     */
+    findRecent(options?: FindRecentOptions): Promise<ReadonlyArray<ResumableSession>>;
+    /**
+     * List all resumable sessions in a project scope. Returns metadata only;
+     * use the SessionRpc / AgenticSession* primitives to actually resume.
+     */
+    listByProject(projectRoot: string, options?: CancellationOptions): Promise<ReadonlyArray<ResumableSession>>;
+    /**
+     * Resume a session. Returns a new SessionHandle representing the
+     * resumed session.
+     */
+    resume(providerSessionId: string, options?: ResumeOptions): Promise<SessionHandle>;
+}
+export interface FindRecentOptions extends CancellationOptions {
+    limit?: number;
+    /** Scope to a specific project root. */
+    projectRoot?: string;
+    /** Max age in milliseconds. Older sessions filtered out. */
+    maxAgeMs?: number;
+}
+export interface ResumeOptions extends CancellationOptions {
+    /**
+     * Resume from a specific turn rather than the latest. Codex's
+     * `thread/rollback` and Claude's --resume-from-checkpoint support this;
+     * adapters that don't throw UnsupportedCapabilityError when set.
+     */
+    fromTurnIndex?: number;
+    /**
+     * Optional working-directory override. Defaults to the session's
+     * recorded working directory.
+     */
+    workingDirectory?: string;
+}
+export interface ResumableSession {
+    providerSessionId: string;
+    /** Best-effort project root the session belonged to. */
+    projectRoot?: string;
+    /** ISO 8601 UTC, when the session was last active. */
+    lastActiveAt: string;
+    /** Total turn count, if known. */
+    turnCount?: number;
+    /** Brief summary of what the session was working on, if known. */
+    summary?: string;
+    providerSpecific?: ProviderSpecific;
+}
+//# sourceMappingURL=sessionResumeIndex.d.ts.map

package/dist/providers/primitives/integration/sessionResumeIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionResumeIndex.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/sessionResumeIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,kBAAkB,CAAC;IAE9D,oDAAoD;IACpD,QAAQ,CACN,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAEpC;;;OAGG;IACH,UAAU,CACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE5C;;;OAGG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE5C;;;OAGG;IACH,MAAM,CACJ,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC"}

package/dist/providers/primitives/integration/sessionResumeIndex.js

@@ -0,0 +1,20 @@
+/**
+ * SessionResumeIndex — provider-side index of resumable sessions.
+ *
+ * Maps to:
+ *   - Claude: `~/.claude/projects/<encoded-path>/<uuid>.jsonl` files, flat
+ *     by UUID
+ *   - Codex: `~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl`
+ *     date-partitioned, plus SQLite index at `sqlite_home`. Codex also
+ *     has `codex resume` picker, `--last`, `--all`, and `codex fork`.
+ *
+ * The abstraction surfaces a uniform "find this session and resume it"
+ * interface without exposing the underlying directory layout. Adapters
+ * resolve via their native index.
+ *
+ * Used by Instar's TopicResumeMap (server/routes.ts) and ThreadResumeMap
+ * (threadline/). The fields `claudeSessionId` in those modules become
+ * `providerSessionId` post-migration; the resume index handles the lookup.
+ */
+export {};
+//# sourceMappingURL=sessionResumeIndex.js.map

package/dist/providers/primitives/integration/sessionResumeIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionResumeIndex.js","sourceRoot":"","sources":["../../../../src/providers/primitives/integration/sessionResumeIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/providers/primitives/observability/conversationLogReader.d.ts

@@ -0,0 +1,46 @@
+/**
+ * ConversationLogReader — post-hoc read of a provider's session log.
+ *
+ * Distinct from `LiveOutputStream` (which captures terminal-level output
+ * including UI chrome) and `ConversationLogTailer` (which watches the log
+ * file for new entries in real time). This primitive is for going BACK
+ * into a finished or in-flight session's history — replay, analysis,
+ * inspection.
+ *
+ * Maps to:
+ *   - Claude: read `~/.claude/projects/<encoded-path>/<uuid>.jsonl`
+ *   - Codex: read `~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl`
+ *
+ * The structural format differs between providers (Claude's flat-by-UUID
+ * vs. Codex's date-partitioned with SQLite index), but the abstraction
+ * presents a uniform "give me this session's history as an event sequence"
+ * interface.
+ */
+import type { CancellationOptions, SessionHandle } from '../../types.js';
+import type { CanonicalEvent } from '../../events.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface ConversationLogReader {
+    readonly capability: typeof CapabilityFlag.ConversationLogReader;
+    /**
+     * Read all events from a session's log, in chronological order.
+     * Returns events in the same canonical vocabulary used by live streams,
+     * so the same consumer code can handle both.
+     */
+    read(session: SessionHandle, options?: ConversationLogReadOptions): Promise<ReadonlyArray<CanonicalEvent>>;
+    /**
+     * Read events as an async iterable. Useful for very long sessions where
+     * loading all events into memory is impractical.
+     */
+    readStream(session: SessionHandle, options?: ConversationLogReadOptions): AsyncIterable<CanonicalEvent>;
+}
+export interface ConversationLogReadOptions extends CancellationOptions {
+    /** Skip events before this timestamp (ISO 8601). */
+    since?: string;
+    /** Skip events after this timestamp. */
+    until?: string;
+    /** Filter to specific event types. */
+    types?: ReadonlyArray<CanonicalEvent['type']>;
+    /** Maximum events to return. */
+    limit?: number;
+}
+//# sourceMappingURL=conversationLogReader.d.ts.map

package/dist/providers/primitives/observability/conversationLogReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogReader.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/observability/conversationLogReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,qBAAqB,CAAC;IAEjE;;;;OAIG;IACH,IAAI,CACF,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAE1C;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,0BAA0B,GACnC,aAAa,CAAC,cAAc,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/providers/primitives/observability/conversationLogReader.js

@@ -0,0 +1,20 @@
+/**
+ * ConversationLogReader — post-hoc read of a provider's session log.
+ *
+ * Distinct from `LiveOutputStream` (which captures terminal-level output
+ * including UI chrome) and `ConversationLogTailer` (which watches the log
+ * file for new entries in real time). This primitive is for going BACK
+ * into a finished or in-flight session's history — replay, analysis,
+ * inspection.
+ *
+ * Maps to:
+ *   - Claude: read `~/.claude/projects/<encoded-path>/<uuid>.jsonl`
+ *   - Codex: read `~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl`
+ *
+ * The structural format differs between providers (Claude's flat-by-UUID
+ * vs. Codex's date-partitioned with SQLite index), but the abstraction
+ * presents a uniform "give me this session's history as an event sequence"
+ * interface.
+ */
+export {};
+//# sourceMappingURL=conversationLogReader.js.map

package/dist/providers/primitives/observability/conversationLogReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogReader.js","sourceRoot":"","sources":["../../../../src/providers/primitives/observability/conversationLogReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/providers/primitives/observability/conversationLogTailer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ConversationLogTailer — real-time tail of a provider's session log.
+ *
+ * Watches the provider's session log file (or equivalent) and emits new
+ * events as they're appended. Used for stall detection, crash detection,
+ * activity tracking — instar's stall-detector.ts, crash-detector.ts, and
+ * ActivityPartitioner all use this pattern today.
+ *
+ * Distinct from `ConversationLogReader` (post-hoc, finite read) and from
+ * `LiveOutputStream` (terminal-level output capture). This primitive is
+ * for following a session's structured event log as it grows.
+ *
+ * Maps to:
+ *   - Claude: tail `~/.claude/projects/<path>/<uuid>.jsonl` via polling
+ *     (no inotify hook today)
+ *   - Codex: tail `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` via polling
+ *
+ * Most providers don't offer fsnotify-style change events for their log
+ * files, so adapters typically poll. The abstraction hides the polling
+ * interval as an implementation detail.
+ */
+import type { CancellationOptions, SessionHandle } from '../../types.js';
+import type { CanonicalEvent } from '../../events.js';
+import { CapabilityFlag } from '../../capabilities.js';
+export interface ConversationLogTailer {
+    readonly capability: typeof CapabilityFlag.ConversationLogTailer;
+    /**
+     * Begin tailing a session's log. Returns an async iterable of events
+     * as they're appended. The stream emits events starting from the moment
+     * `tail` is called (or from `fromTimestamp` if specified). It closes
+     * when the session ends, the file is rotated/truncated, or `signal` aborts.
+     */
+    tail(session: SessionHandle, options?: ConversationLogTailOptions): AsyncIterable<CanonicalEvent>;
+}
+export interface ConversationLogTailOptions extends CancellationOptions {
+    /**
+     * Emit existing events from this timestamp onward, then transition to
+     * tailing new events. Default: skip existing, only emit new ones.
+     */
+    fromTimestamp?: string;
+    /**
+     * Filter the tailed stream to specific event types. Reduces the volume
+     * of events delivered when the consumer only cares about a subset.
+     */
+    types?: ReadonlyArray<CanonicalEvent['type']>;
+    /** Polling interval in ms (adapter-default if unspecified, typically 250-1000). */
+    pollIntervalMs?: number;
+}
+//# sourceMappingURL=conversationLogTailer.d.ts.map

package/dist/providers/primitives/observability/conversationLogTailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogTailer.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/observability/conversationLogTailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,qBAAqB,CAAC;IAEjE;;;;;OAKG;IACH,IAAI,CACF,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,0BAA0B,GACnC,aAAa,CAAC,cAAc,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/providers/primitives/observability/conversationLogTailer.js

@@ -0,0 +1,23 @@
+/**
+ * ConversationLogTailer — real-time tail of a provider's session log.
+ *
+ * Watches the provider's session log file (or equivalent) and emits new
+ * events as they're appended. Used for stall detection, crash detection,
+ * activity tracking — instar's stall-detector.ts, crash-detector.ts, and
+ * ActivityPartitioner all use this pattern today.
+ *
+ * Distinct from `ConversationLogReader` (post-hoc, finite read) and from
+ * `LiveOutputStream` (terminal-level output capture). This primitive is
+ * for following a session's structured event log as it grows.
+ *
+ * Maps to:
+ *   - Claude: tail `~/.claude/projects/<path>/<uuid>.jsonl` via polling
+ *     (no inotify hook today)
+ *   - Codex: tail `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` via polling
+ *
+ * Most providers don't offer fsnotify-style change events for their log
+ * files, so adapters typically poll. The abstraction hides the polling
+ * interval as an implementation detail.
+ */
+export {};
+//# sourceMappingURL=conversationLogTailer.js.map

package/dist/providers/primitives/observability/conversationLogTailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogTailer.js","sourceRoot":"","sources":["../../../../src/providers/primitives/observability/conversationLogTailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}