@roj-ai/sdk 0.0.2

package/dist/plugins/services/schema.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Service domain types
+ *
+ * Services are session-scoped background processes (e.g., dev servers)
+ * that agents can observe and control. Unlike workers, services are
+ * long-running, one instance per type, and shared across agents.
+ */
+/**
+ * Service lifecycle status.
+ */
+export type ServiceStatus = 'stopped' | 'starting' | 'ready' | 'stopping' | 'failed' | 'paused';
+/**
+ * Arguments passed to command callback for dynamic command construction.
+ */
+export interface ServiceCommandArgs {
+    port: number;
+}
+/**
+ * Service configuration declared inline in presets.
+ * Defines how to spawn and monitor a background process.
+ */
+export interface ServiceConfig {
+    /** Unique service type within preset, e.g. 'astro-dev' */
+    type: string;
+    /** Human-readable description */
+    description: string;
+    /** Shell command to run, or a callback receiving allocated port */
+    command: string | ((args: ServiceCommandArgs) => string);
+    /** Working directory (defaults to workspace dir) */
+    cwd?: string;
+    /** Additional environment variables */
+    env?: Record<string, string>;
+    /** Start automatically with session (default: false) */
+    autoStart?: boolean;
+    /** Regex pattern to detect "ready" in stdout */
+    readyPattern?: string;
+    /** SIGTERM→SIGKILL timeout in ms (default: 5000) */
+    gracefulStopMs?: number;
+    /** Ring buffer size for log lines (default: 200) */
+    logBufferSize?: number;
+    /** Startup timeout in ms — service marked as failed if not ready within this time (default: 30000) */
+    startupTimeoutMs?: number;
+    /** Auto-pause configuration (interface prepared, not yet implemented) */
+    autoPause?: {
+        inactivityMs: number;
+    };
+}
+/**
+ * Service entry tracked in session state.
+ * Updated via service_status_changed events.
+ */
+export interface ServiceEntry {
+    serviceType: string;
+    status: ServiceStatus;
+    port?: number;
+    error?: string;
+    startedAt?: number;
+    readyAt?: number;
+    stoppedAt?: number;
+    /** Process group PID (tracked for orphan cleanup after restart) */
+    pid?: number;
+    /**
+     * Process start time in clock ticks since boot, read from /proc/<pid>/stat field 22.
+     * Used to detect PID reuse during orphan reconcile: before SIGKILL, we re-read the
+     * current start time and compare — mismatch means the PID was recycled by an
+     * unrelated process and must NOT be killed. Linux-only; undefined on macOS/Windows.
+     */
+    pidStartTime?: number;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/plugins/services/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAM/F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,KAAK,MAAM,CAAC,CAAA;IACxD,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yEAAyE;IACzE,SAAS,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CACpC;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,aAAa,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB"}

package/dist/plugins/services/service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ServiceExecutor - Manages child processes for session services.
+ *
+ * Each service type has at most one running instance per session.
+ * Services are long-running background processes (e.g., dev servers).
+ * Ports are allocated from a global PortPool and injected via PORT env var.
+ */
+import type { SessionId } from '../../core/sessions/schema.js';
+import type { Result } from '../../lib/utils/result.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { ProcessRunner } from '../../platform/process.js';
+import type { PortPool } from '../../plugins/services/port-pool.js';
+import type { ServiceConfig, ServiceStatus } from '../../plugins/services/schema.js';
+import type { ToolError } from '../../core/tools/executor.js';
+import type { Logger } from '../../lib/logger/logger.js';
+/**
+ * Read a process's start time from /proc/<pid>/stat field 22 (starttime in clock
+ * ticks since boot). Used to detect PID reuse: a captured value paired with a PID
+ * uniquely identifies a process, since the kernel guarantees start time is
+ * monotonic within a boot. Returns undefined on non-Linux, if the process is
+ * gone, or on parse failure — callers must treat undefined as "unknown, don't
+ * rely on it" rather than "process is dead".
+ */
+export declare function getProcessStartTime(fs: FileSystem, pid: number): Promise<number | undefined>;
+export interface ServiceExecutorDeps {
+    fs: FileSystem;
+    process: ProcessRunner;
+}
+export declare class ServiceExecutor {
+    private readonly services;
+    private readonly allocatedPorts;
+    private readonly waiters;
+    private readonly logger;
+    private readonly portPool;
+    private readonly fs;
+    private readonly processRunner;
+    /** Optional callback invoked on every service status change */
+    onStatusChanged?: (sessionId: string, serviceType: string, status: ServiceStatus, port?: number, error?: string, pid?: number, pidStartTime?: number) => void;
+    constructor(logger: Logger, portPool: PortPool, deps: ServiceExecutorDeps);
+    private notifyStatusChanged;
+    private resolveWaiters;
+    /**
+     * Wait for a service to reach a terminal status (ready, failed, or stopped).
+     * Returns immediately if the service is already in a terminal status.
+     */
+    waitForReady(serviceType: string, timeoutMs?: number): Promise<Result<void, ToolError>>;
+    /**
+     * Start a service. Idempotent — returns Ok if already running or starting.
+     */
+    start(config: ServiceConfig, sessionId: SessionId, workspaceDir?: string, preferredPort?: number): Promise<Result<void, ToolError>>;
+    /**
+     * Stop a running service gracefully.
+     * Port is NOT released — kept for session-level stability across restarts.
+     */
+    stop(serviceType: string, sessionId: SessionId): Promise<Result<void, ToolError>>;
+    /**
+     * Restart a service (stop + start).
+     */
+    restart(config: ServiceConfig, sessionId: SessionId, workspaceDir?: string, preferredPort?: number): Promise<Result<void, ToolError>>;
+    /**
+     * Pause a running service (SIGSTOP).
+     */
+    pause(serviceType: string, sessionId: SessionId): Promise<Result<void, ToolError>>;
+    /**
+     * Resume a paused service (SIGCONT).
+     */
+    resume(config: ServiceConfig, sessionId: SessionId, _workspaceDir?: string): Promise<Result<void, ToolError>>;
+    /**
+     * Get recent log lines for a service.
+     */
+    getLogs(serviceType: string, lines?: number): Result<string[], ToolError>;
+    /**
+     * Get the current status of a service.
+     */
+    getStatus(serviceType: string): ServiceStatus | null;
+    /**
+     * Check if a service is running (starting or ready).
+     */
+    isRunning(serviceType: string): boolean;
+    /**
+     * Shutdown all services and release all ports back to pool.
+     * Called on session close.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/plugins/services/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAOxD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAelG;AAmBD,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACtB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyH;IACjJ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,KACjB,IAAI,CAAA;gBAEG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB;IAOzE,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,cAAc;IAetB;;;OAGG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IA2BvF;;OAEG;IACG,KAAK,CACV,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAiMnC;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAqDvF;;OAEG;IACG,OAAO,CACZ,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAUnC;;OAEG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAsBxF;;OAEG;IACG,MAAM,CACX,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,EACpB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAsBnC;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC;IAQzE;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIpD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKvC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA2D/B"}

package/dist/plugins/services/services.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=services.integration.test.d.ts.map

package/dist/plugins/services/services.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/services.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/session-lifecycle/index.d.ts

@@ -0,0 +1,2 @@
+export { presetsPlugin, sessionLifecyclePlugin } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/session-lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugins/session-lifecycle/plugin.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Session Lifecycle Plugin
+ *
+ * Manager methods: create, list, fork.
+ * Session methods: get, close, reopen, getEvents.
+ * Preset listing is a separate presetsPlugin.
+ */
+import z4 from 'zod/v4';
+export declare const presetsPlugin: import("../../core/plugins/index.js").PluginDefinition<"presets", void, void, Record<"list", {
+    input: Record<string, never>;
+    output: {
+        presets: {
+            id: string;
+            name: string;
+            description?: string;
+            defaultResourceSlugs?: string[];
+        }[];
+    };
+}> & Record<"getAgents", {
+    input: {
+        sessionId: string & z4.core.$brand<"SessionId">;
+    };
+    output: {
+        agents: {
+            name: string;
+            spawnableBy: string[];
+            hasInputSchema: boolean;
+        }[];
+    };
+}>, {}>;
+export declare const sessionLifecyclePlugin: import("../../core/plugins/index.js").PluginDefinition<"sessions", void, void, Record<"create", {
+    input: {
+        presetId: string;
+        workspaceDir?: string | undefined;
+        sessionId?: string | undefined;
+    };
+    output: {
+        sessionId: string & z4.core.$brand<"SessionId">;
+    };
+}> & Record<"list", {
+    input: {
+        status?: "active" | "closed" | "errored" | undefined;
+        tags?: string[] | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        orderBy?: "createdAt" | "lastActivityAt" | undefined;
+        order?: "asc" | "desc" | undefined;
+    };
+    output: {
+        sessions: unknown[];
+        total: number;
+    };
+}> & Record<"fork", {
+    input: {
+        sessionId: string & z4.core.$brand<"SessionId">;
+        eventIndex: number;
+    };
+    output: {
+        sessionId: string & z4.core.$brand<"SessionId">;
+    };
+}>, Record<"get", {
+    input: Record<string, never>;
+    output: {
+        sessionId: string & z4.core.$brand<"SessionId">;
+        presetId: string;
+        status: string;
+        createdAt: number;
+        agentCount: number;
+        entryAgentId: (string & z4.core.$brand<"AgentId">) | null;
+        closedAt?: number | undefined;
+    };
+}> & Record<"close", {
+    input: Record<string, never>;
+    output: {};
+}> & Record<"reopen", {
+    input: Record<string, never>;
+    output: {};
+}> & Record<"updateMetadata", {
+    input: {
+        name?: string | undefined;
+    };
+    output: {};
+}> & Record<"getEvents", {
+    input: {
+        since?: number | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        type?: string | undefined;
+        agentId?: string | undefined;
+    };
+    output: {
+        events: unknown[];
+        total: number;
+        lastIndex: number;
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/session-lifecycle/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-lifecycle/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,QAAQ,CAAA;AAavB,eAAO,MAAM,aAAa;;;;gBAYI,MAAM;kBAAQ,MAAM;0BAAgB,MAAM;mCAAyB,MAAM,EAAE;;;;;;;;;kBAwC1E,MAAM;yBAAe,MAAM,EAAE;4BAAkB,OAAO;;;OAgC5E,CAAA;AAMT,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8L1B,CAAA"}

package/dist/plugins/session-lifecycle/session-lifecycle.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-lifecycle.integration.test.d.ts.map

package/dist/plugins/session-lifecycle/session-lifecycle.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-lifecycle/session-lifecycle.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/session-state/plugin.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Session State Plugin
+ *
+ * Provides a typed, persistent state object per session that can be updated by:
+ * - Agent (via tool)
+ * - Client/SPA (via RPC method)
+ * - Backend/system (via RPC method with system caller context)
+ *
+ * State changes are broadcast as notifications and can trigger agent dequeue.
+ * A preset-defined validate function controls write permissions per caller.
+ */
+import z from 'zod/v4';
+import type { CallerContext } from '../../core/plugins/plugin-builder.js';
+export declare const sessionStateEvents: import("../../core/events/types.js").EventsFactory<{
+    session_state_updated: z.ZodObject<{
+        state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        callerSource: z.ZodEnum<{
+            system: "system";
+            agent: "agent";
+            client: "client";
+        }>;
+    }, z.core.$strip>;
+    session_state_external_consumed: z.ZodObject<{}, z.core.$strip>;
+}>;
+export interface SessionStatePluginConfig {
+    schema: z.ZodType;
+    initial: Record<string, unknown>;
+    validate?: (current: Record<string, unknown>, proposed: Record<string, unknown>, caller: CallerContext) => true | string;
+}
+export declare const sessionStatePlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"sessionState", SessionStatePluginConfig, void, {}, Record<"get", {
+    input: {
+        sessionId: string;
+    };
+    output: {
+        state: Record<string, unknown>;
+    };
+}> & Record<"update", {
+    input: {
+        sessionId: string;
+        updates: Record<string, unknown>;
+    };
+    output: {
+        state: {
+            [x: string]: unknown;
+        };
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/session-state/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-state/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAOrE,eAAO,MAAM,kBAAkB;;;;;;;;;;EAQ7B,CAAA;AAEF,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAAA;CACxH;AAOD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;GA0ItB,CAAA"}

package/dist/plugins/session-stats/index.d.ts

@@ -0,0 +1,4 @@
+export { sessionStatsPlugin } from './plugin.js';
+export type { SessionStatsState } from './plugin.js';
+export { selectSessionStats } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/session-stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-stats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugins/session-stats/plugin.d.ts

@@ -0,0 +1,29 @@
+import type { SessionState } from '../../core/sessions/state.js';
+export interface ProviderStats {
+    llmCalls: number;
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalCost: number;
+}
+export interface SessionStatsState {
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalCost: number;
+    llmCalls: number;
+    llmErrors: number;
+    toolCalls: number;
+    toolErrors: number;
+    agentCount: number;
+    firstEventAt: number | null;
+    lastEventAt: number | null;
+    /** Per-provider breakdown of LLM usage */
+    byProvider: Record<string, ProviderStats>;
+}
+/**
+ * Select session stats from session state (for external consumers).
+ */
+export declare function selectSessionStats(sessionState: SessionState): SessionStatsState;
+export declare const sessionStatsPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"session-stats", void, void, {}, {}>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/session-stats/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/session-stats/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAO5D,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACzC;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,iBAAiB,CAEhF;AAMD,eAAO,MAAM,kBAAkB,kGAwDtB,CAAA"}

package/dist/plugins/shell/executor.d.ts

@@ -0,0 +1,78 @@
+import type { SessionEnvironment } from '../../core/sessions/session-environment.js';
+import type { ToolError } from '../../core/tools/executor.js';
+import { type Result } from '../../lib/utils/result.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { ProcessRunner } from '../../platform/process.js';
+/**
+ * Extra path to bind-mount inside bwrap sandbox.
+ */
+export interface ExtraBind {
+    /** Absolute path on the host to bind-mount */
+    path: string;
+    /** Mount mode: 'rw' for read-write, 'ro' for read-only */
+    mode: 'rw' | 'ro';
+    /** Destination path inside the sandbox. Defaults to `path` (same as host). */
+    destPath?: string;
+}
+export interface SandboxConfig {
+    enabled: boolean;
+    /** Allow network access (default: false) */
+    network?: boolean;
+    /** Paths with read-write access (default: [cwd]) */
+    writablePaths?: string[];
+}
+export interface ShellConfig {
+    /** Working directory for commands (fallback when not sandboxed and no workspace) */
+    cwd: string;
+    /** Command timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Environment variables to add/override */
+    env?: Record<string, string>;
+    /** Shell to use (default: sh on unix, cmd.exe on windows) */
+    shell?: string;
+    /** Whether sandbox is active */
+    sandboxed: boolean;
+    /** Extra paths to bind-mount inside bwrap sandbox */
+    extraBinds?: ExtraBind[];
+    /** Bubblewrap sandbox config (default: enabled) */
+    sandbox?: SandboxConfig;
+}
+export interface BwrapOptions {
+    command: string;
+    cwd: string;
+    sandbox: SandboxConfig;
+    /** Real session directory to map into sandbox */
+    sessionDir?: string;
+    /** Real workspace directory to map into sandbox */
+    workspaceDir?: string;
+    /** Extra paths to bind-mount inside sandbox */
+    extraBinds?: ExtraBind[];
+}
+export declare function buildBwrapArgs(opts: BwrapOptions): string[];
+export interface RunCommandInput {
+    command: string;
+    args?: string | string[];
+    cwd?: string;
+    timeout?: number;
+    stdin?: string;
+}
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    signal?: string;
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface ShellExecutorDeps {
+    fs: FileSystem;
+    process: ProcessRunner;
+}
+export declare class ShellExecutor {
+    private config;
+    private readonly fs;
+    private readonly process;
+    constructor(config: ShellConfig, deps: ShellExecutorDeps);
+    execute(input: RunCommandInput, environment: SessionEnvironment): Promise<Result<ShellResult, ToolError>>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/plugins/shell/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/plugins/shell/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAiHxE;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAA;IACX,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,CAAA;CACvB;AAqBD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,aAAa,CAAA;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CA6D3D;AAMD,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACtB;AAED,qBAAa,aAAa;IAIb,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAEnB,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB;IAK1D,OAAO,CACZ,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,kBAAkB,GAC7B,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;CA8K1C"}

package/dist/plugins/shell/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shell plugin - command execution with sandbox support
+ */
+export { createRestrictedShellConfig, createSafeShellConfig, type ExtraBind as ShellExtraBind, type ShellAgentConfig, shellPlugin, type ShellPresetConfig, } from './plugin.js';
+export { buildBwrapArgs, type BwrapOptions, type ExtraBind, type RunCommandInput, type SandboxConfig, type ShellConfig, ShellExecutor, type ShellResult, } from './executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/shell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/shell/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,EACrB,KAAK,SAAS,IAAI,cAAc,EAChC,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,iBAAiB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACN,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,WAAW,GAChB,MAAM,eAAe,CAAA"}

package/dist/plugins/shell/plugin.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Extra path to bind-mount inside bwrap sandbox.
+ */
+export interface ExtraBind {
+    /** Absolute path on the host to bind-mount */
+    path: string;
+    /** Mount mode: 'rw' for read-write, 'ro' for read-only */
+    mode: 'rw' | 'ro';
+    /** Destination path inside the sandbox. Defaults to `path` (same as host). */
+    destPath?: string;
+}
+/**
+ * Session-wide shell configuration.
+ */
+export interface ShellPresetConfig {
+    /** Working directory for commands (fallback when not sandboxed and no workspace) */
+    cwd: string;
+    /** Command timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Environment variables to add/override */
+    env?: Record<string, string>;
+    /** Shell to use (default: sh on unix, cmd.exe on windows) */
+    shell?: string;
+    /** Whether sandbox is active */
+    sandboxed?: boolean;
+    /** Extra paths to bind-mount inside bwrap sandbox */
+    extraBinds?: ExtraBind[];
+    /** Bubblewrap sandbox config (default: enabled) */
+    sandbox?: {
+        enabled: boolean;
+        /** Allow network access (default: false) */
+        network?: boolean;
+        /** Paths with read-write access (default: [cwd]) */
+        writablePaths?: string[];
+    };
+    /** Default enabled state for agents (default: true). Agents can override via ShellAgentConfig.enabled. */
+    defaultEnabled?: boolean;
+}
+/**
+ * Agent-specific shell configuration.
+ */
+export interface ShellAgentConfig {
+    /** Whether shell is enabled for this agent (default: true) */
+    enabled?: boolean;
+}
+export declare const shellPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"shell", ShellPresetConfig, ShellAgentConfig, {}, {}>;
+/** Safe shell config for typical development tasks */
+export declare function createSafeShellConfig(cwd: string): ShellPresetConfig;
+/** Restrictive shell config for untrusted agents */
+export declare function createRestrictedShellConfig(cwd: string): ShellPresetConfig;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/shell/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/shell/plugin.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAA;IACX,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,4CAA4C;QAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,oDAAoD;QACpD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;KACxB,CAAA;IACD,0GAA0G;IAC1G,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAcD,eAAO,MAAM,WAAW,mHAyCf,CAAA;AAET,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAEpE;AAED,oDAAoD;AACpD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAE1E"}

package/dist/plugins/shell/shell.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell.integration.test.d.ts.map

package/dist/plugins/shell/shell.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/shell/shell.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/shell/shell.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell.test.d.ts.map

package/dist/plugins/shell/shell.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/shell/shell.test.ts"],"names":[],"mappings":""}

package/dist/plugins/skills/discovery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Skill Discovery - Scans directories for SKILL.md files and parses frontmatter.
+ *
+ * Skills are discovered at preset load time. The system scans configured
+ * source directories for subdirectories containing SKILL.md files.
+ *
+ * Expected directory structure:
+ *   /skills/
+ *     research/
+ *       SKILL.md
+ *     code-review/
+ *       SKILL.md
+ *
+ * SKILL.md format:
+ *   ---
+ *   name: research
+ *   description: Structured research workflow
+ *   ---
+ *   # Research Skill
+ *   ...
+ */
+import type { Result } from '../../lib/utils/result.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { SkillMetadata } from '../../plugins/skills/schema.js';
+export interface SkillDiscoveryError {
+    type: 'discovery_error';
+    message: string;
+    path?: string;
+}
+export interface FrontmatterParseError {
+    type: 'frontmatter_error';
+    message: string;
+}
+export interface ParsedFrontmatter {
+    name: string;
+    description: string;
+}
+export interface ParsedSkillFile {
+    frontmatter: ParsedFrontmatter;
+    content: string;
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md file content.
+ * Returns the parsed name and description fields.
+ *
+ * Expected format:
+ * ```
+ * ---
+ * name: skill-name
+ * description: Short description
+ * ---
+ * # Content follows...
+ * ```
+ */
+export declare function parseSkillFrontmatter(content: string): Result<ParsedFrontmatter, FrontmatterParseError>;
+/**
+ * Parse a SKILL.md file, extracting frontmatter and content separately.
+ */
+export declare function parseSkillFile(fileContent: string): Result<ParsedSkillFile, FrontmatterParseError>;
+/**
+ * Discover skills from configured source directories.
+ * Scans each source directory for subdirectories containing SKILL.md files.
+ */
+export declare function discoverSkills(fs: FileSystem, sources: string[], basePath: string): Promise<Result<SkillMetadata[], SkillDiscoveryError>>;
+/**
+ * Load the full content of a skill file (without frontmatter).
+ */
+export declare function loadSkillContent(fs: FileSystem, skillPath: string): Promise<Result<string, SkillDiscoveryError>>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/plugins/skills/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAO/D,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;CACf;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,GACb,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAkElD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,WAAW,EAAE,MAAM,GACjB,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAchD;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CACnC,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAwEvD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAqB9C"}

package/dist/plugins/skills/discovery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discovery.test.d.ts.map

package/dist/plugins/skills/discovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/discovery.test.ts"],"names":[],"mappings":""}