@clinebot/core 0.0.34 → 0.0.36

package/README.md

@@ -21,24 +21,26 @@ npm install @clinebot/core
 ## Entry Points
 
 - `@clinebot/core`: core contracts, shared utilities, and Node/server helpers for building hosts and runtimes
-- `@clinebot/core/node`: optional alias for the same Node/server runtime surface
 
 ## Typical Usage
 
 Most host apps should start with `@clinebot/core`.
 
 ```ts
-import { createSessionHost } from "@clinebot/core";
+import { ClineCore } from "@clinebot/core";
 
-const host = await createSessionHost({});
+const cline = await ClineCore.create({});
 
-const result = await host.start({
+const result = await cline.start({
 	config: {
 		providerId: "anthropic",
 		modelId: "claude-sonnet-4-6",
 		apiKey: process.env.ANTHROPIC_API_KEY ?? "",
 		cwd: process.cwd(),
+		mode: "act",
 		enableTools: true,
+		enableSpawnAgent: false,
+		enableAgentTeams: false,
 		systemPrompt: "You are a concise assistant.",
 	},
 	prompt: "Summarize this project.",
@@ -46,7 +48,7 @@ const result = await host.start({
 });
 
 console.log(result.result?.text);
-await host.dispose();
+await cline.dispose();
 ```
 
 ## Session Bootstrap
@@ -54,7 +56,8 @@ await host.dispose();
 `ClineCore.create(...)` also accepts `prepare(input)`.
 
 Use it when a host needs to prepare workspace-scoped runtime state before each
-session starts, then apply watcher/extensions/telemetry inputs generically.
+session starts, then apply watcher/extensions/telemetry inputs through
+`localRuntime.configOverrides` without widening the shared host contract.
 
 ## Main APIs
 
@@ -62,8 +65,9 @@ session starts, then apply watcher/extensions/telemetry inputs generically.
 
 Use `@clinebot/core` for host-facing runtime assembly:
 
-- `createSessionHost(...)`
-- `DefaultSessionManager`
+- `ClineCore.create(...)`
+- `createRuntimeHost(...)`
+- `LocalRuntimeHost`
 - `DefaultRuntimeBuilder`
 
 ### Default Tools
@@ -80,13 +84,12 @@ The package also exports storage and settings helpers such as:
 
 - `ProviderSettingsManager`
 - `SqliteTeamStore`
-- SQLite RPC session backend helpers from `@clinebot/core`
+- SQLite-backed local session stores and artifacts through `@clinebot/core`
 
 ## Related Packages
 
 - `@clinebot/agents`: stateless agent loop and tool primitives
 - `@clinebot/llms`: provider/model configuration and handlers
-- `@clinebot/rpc`: remote session and runtime transport
 
 ## More Examples
 

package/dist/ClineCore.d.ts

@@ -1,29 +1,31 @@
-import type { AgentConfig, ITelemetryService, ToolApprovalRequest, ToolApprovalResult } from "@clinebot/shared";
-import type { TeamToolsFactory } from "./runtime/session-runtime";
-import { type SessionBackend, type SessionHost } from "./session/session-host";
-import type { StartSessionInput } from "./session/session-manager";
-import type { ToolExecutors } from "./tools";
-/** Advanced options for connecting to or spawning the Cline RPC server. */
-export interface RpcOptions {
-    /**
-     * The address of the Cline RPC server to connect to.
-     * Defaults to the `CLINE_RPC_ADDRESS` env var, or the SDK default address if unset.
-     */
-    address?: string;
-    /**
-     * When `true` (default), automatically spawns a background RPC server process if one is
-     * not already running.
-     */
-    autoStart?: boolean;
-    /**
-     * Number of connection attempts made to the RPC server after it is spawned.
-     * Defaults to `5`.
-     */
-    connectAttempts?: number;
-    /**
-     * Milliseconds to wait between RPC connection attempts. Defaults to `100`.
-     */
-    connectDelayMs?: number;
+import type { AgentConfig, BasicLogger, ITelemetryService, ToolApprovalRequest, ToolApprovalResult } from "@clinebot/shared";
+import type { ToolExecutors } from "./extensions/tools";
+import type { SessionBackend } from "./runtime/host";
+import type { LocalRuntimeStartOptions, RuntimeHost, RuntimeHostMode, RuntimeHostSubscribeOptions, StartSessionInput, StartSessionResult } from "./runtime/runtime-host";
+import type { CoreSessionConfig } from "./types/config";
+import type { CoreSessionEvent } from "./types/events";
+import type { SessionMessagesArtifactUploader } from "./types/session";
+export interface HubOptions {
+    endpoint?: string;
+    authToken?: string;
+    strategy?: "prefer-hub" | "require-hub";
+    clientType?: string;
+    displayName?: string;
+    workspaceRoot?: string;
+    cwd?: string;
+}
+export interface RemoteOptions {
+    endpoint: string;
+    authToken?: string;
+    clientType?: string;
+    displayName?: string;
+    workspaceRoot?: string;
+    cwd?: string;
+}
+export type { RuntimeHostMode };
+export interface ClineCoreStartInput extends Omit<StartSessionInput, "config" | "localRuntime"> {
+    config: CoreSessionConfig;
+    localRuntime?: LocalRuntimeStartOptions;
 }
 export interface ClineCoreOptions {
     /**
@@ -38,17 +40,23 @@ export interface ClineCoreOptions {
      */
     distinctId?: string;
     /**
-     * Controls how the session backend is selected:
-     * - `"auto"` (default) — connects to a running RPC server if available, starts one in the
-     *   background if `rpc.autoStart` is true, and falls back to local SQLite/file storage.
-     * - `"rpc"` — requires an RPC server; throws if one is not reachable.
-     * - `"local"` — always uses local SQLite (or file-based) storage; never touches RPC.
+     * Controls how the runtime host is selected:
+     * - `"auto"` (default) — prefers a compatible local hub when one is available and falls
+     *   back to local in-process execution when not.
+     * - `"hub"` — requires a compatible websocket hub runtime; throws if one is not reachable.
+     * - `"remote"` — requires an explicit remote websocket hub endpoint.
+     * - `"local"` — always uses local in-process execution and local SQLite/file storage.
+     */
+    backendMode?: RuntimeHostMode;
+    /**
+     * Hub runtime connection options. Used when `backendMode` is `"hub"` or when `"auto"`
+     * should prefer a shared local hub if available.
      */
-    backendMode?: "auto" | "rpc" | "local";
+    hub?: HubOptions;
     /**
-     * RPC server connection options. Only relevant when `backendMode` is `"auto"` or `"rpc"`.
+     * Remote hub connection options. Only relevant when `backendMode` is `"remote"`.
      */
-    rpc?: RpcOptions;
+    remote?: RemoteOptions;
     /**
      * Override one or more default tool executors (e.g. file I/O, shell, browser).
      * Partial — only the keys you supply are replaced; the rest use built-in implementations.
@@ -59,6 +67,11 @@ export interface ClineCoreOptions {
      * If omitted, telemetry is a no-op.
      */
     telemetry?: ITelemetryService;
+    /**
+     * Optional structured logger for core-side operational diagnostics such as
+     * runtime-host selection and fallback decisions.
+     */
+    logger?: BasicLogger;
     /**
      * Per-tool approval policies that control whether a tool runs automatically,
      * requires user confirmation, or is blocked entirely.
@@ -70,31 +83,47 @@ export interface ClineCoreOptions {
      * If omitted, all approval-required tools are auto-denied.
      */
     requestToolApproval?: (request: ToolApprovalRequest) => Promise<ToolApprovalResult>;
+    /**
+     * Optional hook invoked after `messages.json` is persisted to disk.
+     * Consumers can use this to mirror session transcripts into remote storage.
+     */
+    messagesArtifactUploader?: SessionMessagesArtifactUploader;
+    /**
+     * Custom `fetch` implementation forwarded to the AI gateway providers used
+     * by local sessions. When supplied, it is threaded into each
+     * `ProviderConfig.fetch` built during session bootstrap, which in turn
+     * populates `GatewayProviderSettings.fetch` (and the top-level
+     * `GatewayConfig.fetch` fallback) so hosts can inject custom HTTP behavior
+     * such as proxies, retries, tracing, or test doubles.
+     *
+     * Per-session or per-provider overrides still win: an explicit
+     * `config.fetch` on `CoreSessionConfig` or a stored provider-level `fetch`
+     * takes precedence over this default.
+     *
+     * Applies only to sessions executed in this process (local and fallback-
+     * to-local auto mode). For hub and remote runtimes the HTTP call happens
+     * inside the process that owns the gateway, so configure `fetch` there:
+     *   - `startHubServer({ fetch })` / `ensureHubServer({ fetch })` from
+     *     `@clinebot/hub`
+     *   - `createLocalHubScheduleRuntimeHandlers({ fetch })` from
+     *     `@clinebot/core/hub` for the scheduler
+     */
+    fetch?: typeof fetch;
     /**
      * An already-constructed session backend to use instead of resolving one automatically.
      * Intended for testing or embedding a custom persistence layer.
      * @internal
      */
     sessionService?: SessionBackend;
-    /**
-     * Factory that creates team management tools for the multi-agent team system.
-     * When provided, team tools are registered whenever `enableAgentTeams` is `true`
-     * on a session config.
-     *
-     * Consumers that depend on `@clinebot/enterprise` can pass
-     * `bootstrapAgentTeams` here directly.
-     */
-    teamToolsFactory?: TeamToolsFactory;
     /**
      * Optional hook invoked before each session starts.
      * Use this to prepare workspace-scoped runtime state and then return an
-     * adapter that mutates the `StartSessionInput` generically before core
-     * builds the runtime.
+     * adapter that mutates the shared session input before core starts the run.
      */
-    prepare?: (input: StartSessionInput) => Promise<StartSessionBootstrap | undefined> | StartSessionBootstrap | undefined;
+    prepare?: (input: ClineCoreStartInput) => Promise<StartSessionBootstrap | undefined> | StartSessionBootstrap | undefined;
 }
 export interface StartSessionBootstrap {
-    applyToStartSessionInput(input: StartSessionInput): Promise<StartSessionInput> | StartSessionInput;
+    applyToStartSessionInput(input: ClineCoreStartInput): Promise<ClineCoreStartInput> | ClineCoreStartInput;
     dispose?(): Promise<void> | void;
 }
 /**
@@ -108,29 +137,33 @@ export interface StartSessionBootstrap {
  * const session = await cline.start({ ... });
  * ```
  */
-export declare class ClineCore implements SessionHost {
+export declare class ClineCore implements RuntimeHost {
     readonly clientName: string | undefined;
+    readonly runtimeAddress: string | undefined;
     private readonly host;
     private readonly prepare;
-    private readonly teamToolsFactory;
+    private readonly defaultToolExecutors;
     private readonly activeSessionBootstraps;
     private readonly unsubscribeBootstrapCleanup;
     private constructor();
     static create(options?: ClineCoreOptions): Promise<ClineCore>;
     private disposeSessionBootstrap;
-    start: SessionHost["start"];
-    send: SessionHost["send"];
-    getAccumulatedUsage: SessionHost["getAccumulatedUsage"];
-    abort: SessionHost["abort"];
-    stop: SessionHost["stop"];
-    dispose: SessionHost["dispose"];
-    get: SessionHost["get"];
-    list: SessionHost["list"];
-    delete: SessionHost["delete"];
-    readMessages: SessionHost["readMessages"];
-    readTranscript: SessionHost["readTranscript"];
-    readHooks: SessionHost["readHooks"];
-    subscribe: SessionHost["subscribe"];
-    updateSessionModel: SessionHost["updateSessionModel"];
+    private toClineCoreStartInput;
+    private normalizeStartInput;
+    start(input: StartSessionInput): Promise<StartSessionResult>;
+    start(input: ClineCoreStartInput): Promise<StartSessionResult>;
+    send: RuntimeHost["send"];
+    getAccumulatedUsage: RuntimeHost["getAccumulatedUsage"];
+    abort: RuntimeHost["abort"];
+    stop: RuntimeHost["stop"];
+    dispose: RuntimeHost["dispose"];
+    get: RuntimeHost["get"];
+    list: RuntimeHost["list"];
+    delete: RuntimeHost["delete"];
+    update: RuntimeHost["update"];
+    readMessages: RuntimeHost["readMessages"];
+    handleHookEvent: RuntimeHost["handleHookEvent"];
+    subscribe(listener: (event: CoreSessionEvent) => void, options?: RuntimeHostSubscribeOptions): () => void;
+    updateSessionModel: RuntimeHost["updateSessionModel"];
 }
 //# sourceMappingURL=ClineCore.d.ts.map

package/dist/ClineCore.d.ts.map

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

package/dist/account/index.d.ts

@@ -1,4 +1,4 @@
 export { ClineAccountService, type ClineAccountServiceOptions, } from "./cline-account-service";
-export { type ClineAccountOperations, executeRpcClineAccountAction, isRpcClineAccountActionRequest, RpcClineAccountService, type RpcProviderActionExecutor, } from "./rpc";
+export { type ClineAccountOperations, executeClineAccountAction, isClineAccountActionRequest, type ProviderActionExecutor, RpcClineAccountService, } from "./rpc";
 export type { ClineAccountBalance, ClineAccountOrganization, ClineAccountOrganizationBalance, ClineAccountOrganizationUsageTransaction, ClineAccountPaymentTransaction, ClineAccountUsageTransaction, ClineAccountUser, ClineOrganization, FeaturebaseTokenResponse, UserRemoteConfigOrganization, UserRemoteConfigResponse, } from "./types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/account/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,KAAK,yBAAyB,GAC9B,MAAM,OAAO,CAAC;AACf,YAAY,EACX,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,wCAAwC,EACxC,8BAA8B,EAC9B,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,GACxB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/account/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,sBAAsB,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,sBAAsB,GACtB,MAAM,OAAO,CAAC;AACf,YAAY,EACX,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,wCAAwC,EACxC,8BAA8B,EAC9B,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,GACxB,MAAM,SAAS,CAAC"}

package/dist/account/rpc.d.ts

@@ -1,4 +1,4 @@
-import type { RpcClineAccountActionRequest, RpcProviderActionRequest } from "@clinebot/shared";
+import type { ClineAccountActionRequest, ProviderActionRequest } from "@clinebot/shared";
 import type { ClineAccountBalance, ClineAccountOrganization, ClineAccountOrganizationBalance, ClineAccountOrganizationUsageTransaction, ClineAccountPaymentTransaction, ClineAccountUsageTransaction, ClineAccountUser, FeaturebaseTokenResponse } from "./types";
 export interface ClineAccountOperations {
     fetchMe(): Promise<ClineAccountUser>;
@@ -14,16 +14,16 @@ export interface ClineAccountOperations {
     switchAccount(organizationId?: string | null): Promise<void>;
     fetchFeaturebaseToken?(): Promise<FeaturebaseTokenResponse | undefined>;
 }
-export declare function isRpcClineAccountActionRequest(request: RpcProviderActionRequest): request is RpcClineAccountActionRequest;
-export declare function executeRpcClineAccountAction(request: RpcClineAccountActionRequest, service: ClineAccountOperations): Promise<unknown>;
-export interface RpcProviderActionExecutor {
-    runProviderAction(request: RpcProviderActionRequest): Promise<{
+export declare function isClineAccountActionRequest(request: ProviderActionRequest): request is ClineAccountActionRequest;
+export declare function executeClineAccountAction(request: ClineAccountActionRequest, service: ClineAccountOperations): Promise<unknown>;
+export interface ProviderActionExecutor {
+    runProviderAction(request: ProviderActionRequest): Promise<{
         result: unknown;
     }>;
 }
 export declare class RpcClineAccountService implements ClineAccountOperations {
     private readonly executor;
-    constructor(executor: RpcProviderActionExecutor);
+    constructor(executor: ProviderActionExecutor);
     fetchMe(): Promise<ClineAccountUser>;
     fetchBalance(userId?: string): Promise<ClineAccountBalance>;
     fetchUsageTransactions(userId?: string): Promise<ClineAccountUsageTransaction[]>;

package/dist/account/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/account/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,4BAA4B,EAC5B,wBAAwB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACX,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,wCAAwC,EACxC,8BAA8B,EAC9B,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACtC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,sBAAsB,CACrB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAC3C,wBAAwB,CACvB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC;IAC7C,sBAAsB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC9D,wBAAwB,CACvB,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC5C,kCAAkC,CAAC,KAAK,EAAE;QACzC,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,wCAAwC,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,qBAAqB,CAAC,IAAI,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;CACxE;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,wBAAwB,GAC/B,OAAO,IAAI,4BAA4B,CAEzC;AAED,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED,MAAM,WAAW,yBAAyB;IACzC,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC;QAC7D,MAAM,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;CACH;AAED,qBAAa,sBAAuB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,QAAQ,EAAE,yBAAyB;IAIlC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAOpC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ3D,sBAAsB,CAClC,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAQ7B,wBAAwB,CACpC,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,EAAE,CAAC;IAQ/B,sBAAsB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAO7D,wBAAwB,CACpC,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,+BAA+B,CAAC;IAY9B,kCAAkC,CAAC,KAAK,EAAE;QACtD,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,wCAAwC,EAAE,CAAC;IAa1C,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,qBAAqB,IAAI,OAAO,CAC5C,wBAAwB,GAAG,SAAS,CACpC;YAOa,OAAO;CAIrB"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/account/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,yBAAyB,EACzB,qBAAqB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACX,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,wCAAwC,EACxC,8BAA8B,EAC9B,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACtC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,sBAAsB,CACrB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAC3C,wBAAwB,CACvB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC;IAC7C,sBAAsB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC9D,wBAAwB,CACvB,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC5C,kCAAkC,CAAC,KAAK,EAAE;QACzC,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,wCAAwC,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,qBAAqB,CAAC,IAAI,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;CACxE;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,qBAAqB,GAC5B,OAAO,IAAI,yBAAyB,CAEtC;AAED,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED,MAAM,WAAW,sBAAsB;IACtC,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAC1D,MAAM,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;CACH;AAED,qBAAa,sBAAuB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAEtC,QAAQ,EAAE,sBAAsB;IAI/B,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAOpC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ3D,sBAAsB,CAClC,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAQ7B,wBAAwB,CACpC,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,EAAE,CAAC;IAQ/B,sBAAsB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAO7D,wBAAwB,CACpC,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,+BAA+B,CAAC;IAY9B,kCAAkC,CAAC,KAAK,EAAE;QACtD,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,wCAAwC,EAAE,CAAC;IAa1C,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,qBAAqB,IAAI,OAAO,CAC5C,wBAAwB,GAAG,SAAS,CACpC;YAOa,OAAO;CAIrB"}

package/dist/cron/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./resource-limiter";
+export * from "./schedule-command-service";
+export * from "./schedule-service";
+export * from "./scheduler";
+export * from "./sqlite-schedule-store";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cron/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/cron/resource-limiter.d.ts

@@ -0,0 +1,9 @@
+export declare class ResourceLimiter {
+    private readonly globalMaxConcurrency;
+    private readonly activeExecutions;
+    constructor(globalMaxConcurrency: number);
+    acquire(scheduleId: string, executionId: string, maxParallel: number): boolean;
+    release(scheduleId: string, executionId: string): void;
+    getGlobalActiveCount(): number;
+}
+//# sourceMappingURL=resource-limiter.d.ts.map

package/dist/cron/resource-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-limiter.d.ts","sourceRoot":"","sources":["../../src/cron/resource-limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;gBAEvD,oBAAoB,EAAE,MAAM;IAIjC,OAAO,CACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GACjB,OAAO;IAeH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAWtD,oBAAoB,IAAI,MAAM;CAOrC"}

package/dist/cron/schedule-command-service.d.ts

@@ -0,0 +1,10 @@
+import type { HubCommandEnvelope, HubReplyEnvelope } from "@clinebot/shared";
+import type { HubScheduleService } from "./schedule-service";
+export declare class HubScheduleCommandService {
+    private readonly schedules;
+    constructor(schedules: HubScheduleService);
+    handleCommand(envelope: HubCommandEnvelope): Promise<HubReplyEnvelope>;
+    private toCreateInput;
+    private toUpdateInput;
+}
+//# sourceMappingURL=schedule-command-service.d.ts.map

package/dist/cron/schedule-command-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-command-service.d.ts","sourceRoot":"","sources":["../../src/cron/schedule-command-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,kBAAkB,EAClB,gBAAgB,EAGhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA2B7D,qBAAa,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,kBAAkB;IAE7C,aAAa,CACzB,QAAQ,EAAE,kBAAkB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IAiH5B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,aAAa;CAoBrB"}

package/dist/cron/schedule-service.d.ts

@@ -0,0 +1,100 @@
+import type { BasicLogger, ChatRunTurnRequest, ChatStartSessionArtifacts, ChatStartSessionRequest, HubScheduleCreateInput, HubScheduleUpdateInput, ScheduleExecutionRecord, ScheduleRecord } from "@clinebot/shared";
+import { type ListScheduleExecutionsOptions, type ListSchedulesOptions, type ScheduleExecutionStats } from "./sqlite-schedule-store";
+type HubScheduleTurnResult = {
+    text: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+        totalCost?: number;
+    };
+    inputTokens?: number;
+    outputTokens?: number;
+    iterations?: number;
+    finishReason?: string;
+    messages?: unknown[];
+    toolCalls?: Array<{
+        name: string;
+        input?: unknown;
+        output?: unknown;
+        error?: string;
+        durationMs?: number;
+    }>;
+};
+export interface ScheduleAutonomousOptions {
+    enabled?: boolean;
+    idleTimeoutSeconds?: number;
+    pollIntervalSeconds?: number;
+}
+export interface HubScheduleRuntimeHandlers {
+    startSession(request: ChatStartSessionRequest): Promise<{
+        sessionId: string;
+        startResult?: ChatStartSessionArtifacts;
+    }>;
+    sendSession(sessionId: string, request: ChatRunTurnRequest): Promise<{
+        result: HubScheduleTurnResult;
+    }>;
+    abortSession(sessionId: string): Promise<{
+        applied: boolean;
+    }>;
+    stopSession(sessionId: string): Promise<{
+        applied: boolean;
+    }>;
+}
+export interface ActiveScheduledExecution {
+    executionId: string;
+    scheduleId: string;
+    sessionId: string;
+    startedAt: string;
+    timeoutAt?: string;
+}
+export interface HubScheduleServiceOptions {
+    runtimeHandlers: HubScheduleRuntimeHandlers;
+    eventPublisher?: (eventType: string, payload: unknown) => void;
+    logger?: BasicLogger;
+    sessionsDbPath?: string;
+    pollIntervalMs?: number;
+    globalMaxConcurrency?: number;
+    claimLeaseSeconds?: number;
+}
+export declare class HubScheduleService {
+    private readonly store;
+    private readonly resourceLimiter;
+    private readonly options;
+    private readonly claimLeaseMs;
+    private readonly activeExecutions;
+    private timer;
+    private started;
+    private ticking;
+    private disposed;
+    constructor(options: HubScheduleServiceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    createSchedule(input: HubScheduleCreateInput): ScheduleRecord;
+    getSchedule(scheduleId: string): ScheduleRecord | undefined;
+    listSchedules(options?: ListSchedulesOptions): ScheduleRecord[];
+    updateSchedule(scheduleId: string, updates: HubScheduleUpdateInput): ScheduleRecord | undefined;
+    deleteSchedule(scheduleId: string): boolean;
+    pauseSchedule(scheduleId: string): ScheduleRecord | undefined;
+    resumeSchedule(scheduleId: string): ScheduleRecord | undefined;
+    triggerScheduleNow(scheduleId: string): Promise<ScheduleExecutionRecord | undefined>;
+    listScheduleExecutions(options: ListScheduleExecutionsOptions): ScheduleExecutionRecord[];
+    getScheduleStats(scheduleId: string): ScheduleExecutionStats;
+    getActiveExecutions(): ActiveScheduledExecution[];
+    getUpcomingRuns(limit?: number): Array<{
+        scheduleId: string;
+        name: string;
+        nextRunAt: string;
+    }>;
+    private tick;
+    private executeClaimedSchedule;
+    private startClaimLeaseHeartbeat;
+    private buildStartRequest;
+    private executeSchedule;
+    private publishEvent;
+    private runAutonomousIdleLoop;
+}
+export {};
+//# sourceMappingURL=schedule-service.d.ts.map

package/dist/cron/schedule-service.d.ts.map

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

package/dist/cron/scheduler.d.ts

@@ -0,0 +1,66 @@
+import { type HubScheduleCreateInput, type HubScheduleUpdateInput, type ScheduleExecutionRecord, type ScheduleExecutionStatus, type ScheduleRecord } from "@clinebot/shared";
+export interface ParsedCron {
+    minutes: number[];
+    hours: number[];
+    daysOfMonth: number[];
+    months: number[];
+    daysOfWeek: number[];
+}
+export declare function parseCron(pattern: string): ParsedCron;
+export declare function validateCronPattern(pattern: string): void;
+export declare function getNextCronTime(pattern: string, after: number): number;
+export declare class ScheduleStore {
+    private schedules;
+    private executions;
+    load(schedules: ScheduleRecord[] | undefined, executions: ScheduleExecutionRecord[] | undefined): void;
+    snapshotSchedules(): ScheduleRecord[];
+    snapshotExecutions(): ScheduleExecutionRecord[];
+    create(input: HubScheduleCreateInput, now: number): ScheduleRecord;
+    get(scheduleId: string): ScheduleRecord | undefined;
+    list(): ScheduleRecord[];
+    update(input: HubScheduleUpdateInput, now: number): ScheduleRecord;
+    setEnabled(scheduleId: string, enabled: boolean, now: number): ScheduleRecord;
+    delete(scheduleId: string): void;
+    recordTriggered(scheduleId: string, now: number): ScheduleRecord;
+    getDueSchedules(now: number): ScheduleRecord[];
+    startExecution(scheduleId: string, sessionId: string, now: number): ScheduleExecutionRecord;
+    completeExecution(executionId: string, status: Exclude<ScheduleExecutionStatus, "running">, now: number, errorMessage?: string): ScheduleExecutionRecord;
+    listExecutions(scheduleId?: string): ScheduleExecutionRecord[];
+}
+export interface SchedulerTriggerContext {
+    scheduleId: string;
+    sessionId: string;
+    executionId: string;
+}
+export interface SchedulerCallbacks {
+    onTrigger(record: ScheduleRecord): Promise<{
+        sessionId: string;
+    }>;
+    onExecutionCompleted(context: SchedulerTriggerContext, execution: ScheduleExecutionRecord): void;
+    onExecutionFailed(context: SchedulerTriggerContext, execution: ScheduleExecutionRecord, error: unknown): void;
+    onScheduleUpdated(record: ScheduleRecord): void;
+    onPersist(): Promise<void>;
+}
+export interface HubSchedulerOptions {
+    store: ScheduleStore;
+    callbacks: SchedulerCallbacks;
+    now?: () => number;
+    pollIntervalMs?: number;
+}
+export declare class HubScheduler {
+    private readonly store;
+    private readonly callbacks;
+    private readonly now;
+    private readonly pollIntervalMs;
+    private timer;
+    private readonly runningExecutions;
+    constructor(options: HubSchedulerOptions);
+    start(): void;
+    stop(): void;
+    triggerNow(scheduleId: string): Promise<ScheduleExecutionRecord>;
+    notifySessionCompleted(sessionId: string, failed: boolean, errorMessage?: string): Promise<void>;
+    get scheduleStore(): ScheduleStore;
+    private poll;
+    private executeSchedule;
+}
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/cron/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,MAAM,kBAAkB,CAAC;AA8F1B,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAwBD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAwBrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAyFtE;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,UAAU,CAA8C;IAEhE,IAAI,CACH,SAAS,EAAE,cAAc,EAAE,GAAG,SAAS,EACvC,UAAU,EAAE,uBAAuB,EAAE,GAAG,SAAS,GAC/C,IAAI;IAWP,iBAAiB,IAAI,cAAc,EAAE;IAIrC,kBAAkB,IAAI,uBAAuB,EAAE;IAI/C,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;IAsBlE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKnD,IAAI,IAAI,cAAc,EAAE;IAIxB,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;IAqClE,UAAU,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACT,cAAc;IAiBjB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOhC,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;IAehE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE;IAW9C,cAAc,CACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACT,uBAAuB;IAa1B,iBAAiB,CAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,uBAAuB,EAAE,SAAS,CAAC,EACnD,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACnB,uBAAuB;IAe1B,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB,EAAE;CAU9D;AAED,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,oBAAoB,CACnB,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,uBAAuB,GAChC,IAAI,CAAC;IACR,iBAAiB,CAChB,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,uBAAuB,EAClC,KAAK,EAAE,OAAO,GACZ,IAAI,CAAC;IACR,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;gBAEQ,OAAO,EAAE,mBAAmB;IAUxC,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;IAQN,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQhE,sBAAsB,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IA8BhB,IAAI,aAAa,IAAI,aAAa,CAEjC;YAEa,IAAI;YAaJ,eAAe;CA2D7B"}

package/dist/cron/sqlite-schedule-store.d.ts

@@ -0,0 +1,52 @@
+import type { HubScheduleCreateInput, HubScheduleUpdateInput, ScheduleExecutionRecord, ScheduleExecutionStatus, ScheduleRecord } from "@clinebot/shared";
+export interface HubScheduleStoreOptions {
+    sessionsDbPath?: string;
+}
+export interface ScheduleClaimRecord {
+    schedule: ScheduleRecord;
+    claimToken: string;
+    triggeredAt: number;
+    leaseUntilAt: number;
+}
+export interface ListSchedulesOptions {
+    enabled?: boolean;
+    limit?: number;
+    tags?: string[];
+}
+export interface ListScheduleExecutionsOptions {
+    scheduleId?: string;
+    status?: ScheduleExecutionStatus;
+    limit?: number;
+}
+export interface ScheduleExecutionStats {
+    totalRuns: number;
+    successRate: number;
+    avgDurationSeconds: number;
+    lastFailure?: ScheduleExecutionRecord;
+}
+export declare class SqliteHubScheduleStore {
+    private readonly db;
+    constructor(options?: HubScheduleStoreOptions);
+    close(): void;
+    createSchedule(input: HubScheduleCreateInput): ScheduleRecord;
+    getSchedule(scheduleId: string): ScheduleRecord | undefined;
+    listSchedules(options?: ListSchedulesOptions): ScheduleRecord[];
+    updateSchedule(scheduleId: string, updates: HubScheduleUpdateInput): ScheduleRecord | undefined;
+    claimDueSchedules(referenceTimeIso: string, leaseDurationMs: number, limit?: number): ScheduleClaimRecord[];
+    renewScheduleClaim(scheduleId: string, claimToken: string, leaseUntilAt: string): boolean;
+    completeScheduleClaim(scheduleId: string, claimToken: string, triggeredAtIso: string): boolean;
+    releaseScheduleClaim(scheduleId: string, claimToken: string): boolean;
+    deleteSchedule(scheduleId: string): boolean;
+    recordExecution(execution: ScheduleExecutionRecord): void;
+    private sessionExists;
+    listExecutions(options: ListScheduleExecutionsOptions): ScheduleExecutionRecord[];
+    getExecutionStats(scheduleId: string): ScheduleExecutionStats;
+    listUpcomingRuns(limit?: number): Array<{
+        scheduleId: string;
+        name: string;
+        nextRunAt: string;
+    }>;
+    private toScheduleRecord;
+    private toScheduleExecutionRecord;
+}
+//# sourceMappingURL=sqlite-schedule-store.d.ts.map