@clinebot/core 0.0.36 → 0.0.37

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

@@ -0,0 +1,57 @@
+import type { AutomationEventEnvelope, BasicLogger } from "@clinebot/shared";
+import type { ResolveCronSpecsDirOptions } from "@clinebot/shared/storage";
+import { type CronEventIngressResult } from "./cron-event-ingress";
+import type { HubScheduleRuntimeHandlers } from "./schedule-service";
+import type { CronRunRecord, CronSpecRecord, ListEventLogsOptions, ListRunsOptions, ListSpecsOptions } from "./sqlite-cron-store";
+/**
+ * Top-level orchestrator for file-based cron automation.
+ *
+ * Wires together:
+ *   - `SqliteCronStore` (cron.db)
+ *   - `CronReconciler` (disk -> DB)
+ *   - `CronWatcher` (cron specs directory filesystem events)
+ *   - `CronMaterializer` (queue materialization)
+ *   - `CronRunner` (claim + execute + report)
+ *
+ * This service is the forward path: the legacy `HubScheduleService`
+ * continues to serve programmatic schedules, while `CronService` handles
+ * everything sourced from the configured file-based cron directory.
+ */
+export interface CronServiceOptions {
+    /** Default runtime workspace for the hub/daemon process. */
+    workspaceRoot: string;
+    /** Cron spec source/report location. Defaults to global `~/.cline/cron`. */
+    specs?: ResolveCronSpecsDirOptions;
+    runtimeHandlers: HubScheduleRuntimeHandlers;
+    dbPath?: string;
+    logger?: BasicLogger;
+    pollIntervalMs?: number;
+    claimLeaseSeconds?: number;
+    globalMaxConcurrency?: number;
+    watcherDebounceMs?: number;
+}
+export declare class CronService {
+    private readonly store;
+    private readonly reconciler;
+    private readonly watcher;
+    private readonly eventIngress;
+    private readonly materializer;
+    private readonly runner;
+    private started;
+    private disposed;
+    constructor(options: CronServiceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    listSpecs(options?: ListSpecsOptions): CronSpecRecord[];
+    getSpec(specId: string): CronSpecRecord | undefined;
+    listRuns(options?: ListRunsOptions): CronRunRecord[];
+    getRun(runId: string): CronRunRecord | undefined;
+    listActiveRuns(): CronRunRecord[];
+    listUpcomingRuns(limit?: number): CronRunRecord[];
+    reconcileNow(): Promise<void>;
+    ingestEvent(event: AutomationEventEnvelope): CronEventIngressResult;
+    listEventLogs(options?: ListEventLogsOptions): import("./sqlite-cron-store").CronEventLogRecord[];
+    getEventLog(eventId: string): import("./sqlite-cron-store").CronEventLogRecord | undefined;
+}
+//# sourceMappingURL=cron-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron-service.d.ts","sourceRoot":"","sources":["../../src/cron/cron-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,kBAAkB;IAClC,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC,eAAe,EAAE,0BAA0B,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IAuC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,cAAc,EAAE;IAIvD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,aAAa,EAAE;IAIpD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD,cAAc,IAAI,aAAa,EAAE;IAIjC,gBAAgB,CAAC,KAAK,SAAK,GAAG,aAAa,EAAE;IAIvC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,sBAAsB;IAInE,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB;IAI5C,WAAW,CAAC,OAAO,EAAE,MAAM;CAGlC"}

package/dist/cron/cron-spec-parser.d.ts

@@ -0,0 +1,27 @@
+import type { CronSpecParseResult, CronTriggerKind } from "@clinebot/shared";
+/**
+ * Markdown frontmatter parser for `.cline/cron/*.md` automation specs.
+ *
+ * Lives in @clinebot/core because it depends on `yaml`. The spec types
+ * themselves live in @clinebot/shared so other packages can consume them
+ * without pulling in a YAML parser.
+ *
+ * The parser never throws for a single bad file — it produces a
+ * `CronSpecParseResult` with an `error` message so the reconciler can record
+ * `parse_status='invalid'` durably instead of dropping state.
+ */
+export declare function inferTriggerKindFromPath(relativePath: string): CronTriggerKind;
+export declare function splitFrontmatter(raw: string): {
+    frontmatter: string | undefined;
+    body: string;
+};
+export declare function computeContentHash(frontmatterJson: unknown, body: string): string;
+export interface ParseCronSpecInput {
+    relativePath: string;
+    raw: string;
+}
+/**
+ * Parse a single cron spec file. Never throws; always returns a result.
+ */
+export declare function parseCronSpecFile(input: ParseCronSpecInput): CronSpecParseResult;
+//# sourceMappingURL=cron-spec-parser.d.ts.map

package/dist/cron/cron-spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-spec-parser.d.ts","sourceRoot":"","sources":["../../src/cron/cron-spec-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAOX,mBAAmB,EACnB,eAAe,EACf,MAAM,kBAAkB,CAAC;AAK1B;;;;;;;;;;GAUG;AAEH,wBAAgB,wBAAwB,CACvC,YAAY,EAAE,MAAM,GAClB,eAAe,CASjB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC9C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACb,CAcA;AA+HD,wBAAgB,kBAAkB,CACjC,eAAe,EAAE,OAAO,EACxB,IAAI,EAAE,MAAM,GACV,MAAM,CAMR;AAqBD,MAAM,WAAW,kBAAkB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACZ;AAqCD;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,kBAAkB,GACvB,mBAAmB,CAqOrB"}

package/dist/cron/cron-watcher.d.ts

@@ -0,0 +1,23 @@
+import type { CronReconciler } from "./cron-reconciler";
+export interface CronWatcherOptions {
+    reconciler: CronReconciler;
+    debounceMs?: number;
+    onError?: (error: unknown) => void;
+    onReconciled?: () => void | Promise<void>;
+}
+export declare class CronWatcher {
+    private readonly reconciler;
+    private readonly debounceMs;
+    private readonly onError;
+    private readonly onReconciled;
+    private watcher?;
+    private readonly pending;
+    private disposed;
+    constructor(options: CronWatcherOptions);
+    start(): void;
+    stop(): void;
+    dispose(): void;
+    private scheduleReconcile;
+    private reconcileNow;
+}
+//# sourceMappingURL=cron-watcher.d.ts.map

package/dist/cron/cron-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-watcher.d.ts","sourceRoot":"","sources":["../../src/cron/cron-watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYxD,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;IAC5E,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IAOhC,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,IAAI;IAOZ,OAAO,IAAI,IAAI;IAKtB,OAAO,CAAC,iBAAiB;YAUX,YAAY;CAsB1B"}

package/dist/cron/scheduler.d.ts

@@ -8,7 +8,9 @@ export interface ParsedCron {
 }
 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 function validateCronSchedule(pattern: string, timezone?: string, after?: number): void;
+export declare function validateTimezone(timezone: string | undefined): void;
+export declare function getNextCronTime(pattern: string, after: number, timezone?: string): number;
 export declare class ScheduleStore {
     private schedules;
     private executions;

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

@@ -1 +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"}
+{"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;AAoG1B,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;AAgCD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAwBrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,GAAE,MAAmB,GACxB,IAAI,CAEN;AA+BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAInE;AAyED,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,CA4FR;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-cron-store.d.ts

@@ -0,0 +1,230 @@
+import type { AutomationEventEnvelope, CronSpec, CronSpecExtensionKind, CronTriggerKind } from "@clinebot/shared";
+/**
+ * Generalized cron/automation store backed by `cron.db`. Sessions stay in
+ * their own database (see @clinebot/shared `ensureSessionSchema`). cron_runs
+ * here absorb one-off, recurring, and event-driven work under one queue.
+ */
+export type CronRunStatus = "queued" | "running" | "done" | "failed" | "cancelled";
+export type CronRunTriggerKind = "one_off" | "schedule" | "event" | "manual" | "retry";
+export type CronParseStatus = "valid" | "invalid";
+export type CronEventProcessingStatus = "received" | "unmatched" | "queued" | "suppressed" | "failed";
+export interface CronSpecRecord {
+    specId: string;
+    externalId: string;
+    sourcePath: string;
+    triggerKind: CronTriggerKind;
+    sourceMtimeMs?: number;
+    sourceHash?: string;
+    parseStatus: CronParseStatus;
+    parseError?: string;
+    enabled: boolean;
+    removed: boolean;
+    title: string;
+    prompt?: string;
+    workspaceRoot?: string;
+    scheduleExpr?: string;
+    timezone?: string;
+    eventType?: string;
+    filters?: Record<string, unknown>;
+    debounceSeconds?: number;
+    dedupeWindowSeconds?: number;
+    cooldownSeconds?: number;
+    mode?: string;
+    systemPrompt?: string;
+    providerId?: string;
+    modelId?: string;
+    maxIterations?: number;
+    timeoutSeconds?: number;
+    maxParallel?: number;
+    tools?: string[];
+    notesDirectory?: string;
+    extensions?: CronSpecExtensionKind[];
+    source?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    revision: number;
+    lastMaterializedRunId?: string;
+    lastRunAt?: string;
+    nextRunAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CronRunRecord {
+    runId: string;
+    specId: string;
+    specRevision: number;
+    triggerKind: CronRunTriggerKind;
+    status: CronRunStatus;
+    claimToken?: string;
+    claimStartedAt?: string;
+    claimUntilAt?: string;
+    scheduledFor?: string;
+    triggerEventId?: string;
+    startedAt?: string;
+    completedAt?: string;
+    sessionId?: string;
+    reportPath?: string;
+    error?: string;
+    attemptCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CronEventLogRecord {
+    eventId: string;
+    eventType: string;
+    source: string;
+    subject?: string;
+    occurredAt: string;
+    receivedAt: string;
+    workspaceRoot?: string;
+    dedupeKey?: string;
+    payload?: Record<string, unknown>;
+    attributes?: Record<string, unknown>;
+    processingStatus: CronEventProcessingStatus;
+    matchedSpecCount: number;
+    queuedRunCount: number;
+    suppressedCount: number;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UpsertSpecInput {
+    externalId: string;
+    sourcePath: string;
+    triggerKind: CronTriggerKind;
+    sourceMtimeMs?: number;
+    sourceHash: string;
+    parseStatus: CronParseStatus;
+    parseError?: string;
+    spec?: CronSpec;
+}
+export interface UpsertSpecResult {
+    record: CronSpecRecord;
+    created: boolean;
+    revisionChanged: boolean;
+}
+export interface SqliteCronStoreOptions {
+    dbPath?: string;
+}
+export interface ListSpecsOptions {
+    triggerKind?: CronTriggerKind;
+    enabled?: boolean;
+    parseStatus?: CronParseStatus;
+    includeRemoved?: boolean;
+    limit?: number;
+}
+export interface ListRunsOptions {
+    specId?: string;
+    status?: CronRunStatus | CronRunStatus[];
+    limit?: number;
+}
+export interface ClaimRunOptions {
+    nowIso: string;
+    leaseMs: number;
+    limit?: number;
+}
+export interface ClaimedCronRun {
+    run: CronRunRecord;
+    claimToken: string;
+    claimUntilAt: string;
+}
+interface ClaimBoundUpdate {
+    runId: string;
+    claimToken: string;
+}
+export interface MaterializeScheduleRunResult {
+    queued: boolean;
+    run?: CronRunRecord;
+    nextRunAt?: string;
+}
+export interface EnqueueRunInput {
+    specId: string;
+    specRevision: number;
+    triggerKind: CronRunTriggerKind;
+    scheduledFor?: string;
+    triggerEventId?: string;
+}
+export interface InsertEventLogResult {
+    record: CronEventLogRecord;
+    created: boolean;
+}
+export interface ListEventLogsOptions {
+    eventType?: string;
+    source?: string;
+    processingStatus?: CronEventProcessingStatus;
+    limit?: number;
+}
+export declare class SqliteCronStore {
+    private readonly db;
+    constructor(options?: SqliteCronStoreOptions);
+    close(): void;
+    getSpecBySourcePath(sourcePath: string): CronSpecRecord | undefined;
+    getSpec(specId: string): CronSpecRecord | undefined;
+    getSpecByExternalId(externalId: string): CronSpecRecord | undefined;
+    listSpecs(options?: ListSpecsOptions): CronSpecRecord[];
+    listEventSpecsForType(eventType: string): CronSpecRecord[];
+    upsertSpec(input: UpsertSpecInput): UpsertSpecResult;
+    private insertSpecRow;
+    private updateSpecRow;
+    markSpecRemoved(specId: string): void;
+    updateSpecNextRunAt(specId: string, nextRunAt: string | undefined): void;
+    updateSpecLastRunAt(specId: string, lastRunAt: string): void;
+    updateLastMaterializedRunId(specId: string, runId: string): void;
+    materializeDueScheduleRun(options: {
+        specId: string;
+        nowMs: number;
+    }): MaterializeScheduleRunResult;
+    getRun(runId: string): CronRunRecord | undefined;
+    insertEventLog(event: AutomationEventEnvelope, options?: {
+        receivedAtIso?: string;
+    }): InsertEventLogResult;
+    getEventLog(eventId: string): CronEventLogRecord | undefined;
+    listEventLogs(options?: ListEventLogsOptions): CronEventLogRecord[];
+    updateEventLogProcessing(eventId: string, update: {
+        status: CronEventProcessingStatus;
+        matchedSpecCount?: number;
+        queuedRunCount?: number;
+        suppressedCount?: number;
+        error?: string;
+    }): boolean;
+    listRuns(options?: ListRunsOptions): CronRunRecord[];
+    hasRecentEventRunForDedupe(options: {
+        specId: string;
+        dedupeKey: string;
+        sinceIso: string;
+    }): boolean;
+    hasRecentEventRunForSpec(options: {
+        specId: string;
+        sinceIso: string;
+    }): boolean;
+    findQueuedEventRunForDedupe(options: {
+        specId: string;
+        dedupeKey: string;
+    }): CronRunRecord | undefined;
+    updateQueuedEventRunForDebounce(options: {
+        runId: string;
+        triggerEventId: string;
+        scheduledFor: string;
+    }): CronRunRecord | undefined;
+    hasOneOffRunForRevision(specId: string, revision: number): boolean;
+    enqueueRun(input: EnqueueRunInput): CronRunRecord;
+    cancelQueuedRunsForSpec(specId: string): number;
+    claimDueRuns(options: ClaimRunOptions): ClaimedCronRun[];
+    renewClaim(runId: string, claimToken: string, leaseUntilAt: string): boolean;
+    completeRun(runId: string, update: {
+        status: "done" | "failed" | "cancelled";
+        sessionId?: string;
+        reportPath?: string;
+        error?: string;
+        completedAtIso?: string;
+        claimToken?: string;
+    }): boolean;
+    requeueRun(update: ClaimBoundUpdate & {
+        error?: string;
+        scheduledFor?: string;
+    }): boolean;
+    attachSessionIdToRun(runId: string, sessionId: string): void;
+    attachReportPathToRun(runId: string, reportPath: string): void;
+}
+export {};
+//# sourceMappingURL=sqlite-cron-store.d.ts.map

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

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

package/dist/extensions/plugin/plugin-config-loader.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig, WorkspaceInfo } from "@clinebot/shared";
+import type { AgentConfig, PluginSetupContext, WorkspaceInfo } from "@clinebot/shared";
 import type { PluginLoadDiagnostics } from "./plugin-load-report";
 import type { PluginTargeting } from "./plugin-targeting";
 type AgentPlugin = NonNullable<AgentConfig["extensions"]>[number];
@@ -26,6 +26,12 @@ export interface ResolveAndLoadAgentPluginsOptions extends ResolveAgentPluginPat
      * in the extension context.
      */
     workspaceInfo?: WorkspaceInfo;
+    session?: PluginSetupContext["session"];
+    client?: PluginSetupContext["client"];
+    user?: PluginSetupContext["user"];
+    automation?: PluginSetupContext["automation"];
+    logger?: PluginSetupContext["logger"];
+    telemetry?: PluginSetupContext["telemetry"];
 }
 export declare function resolveAndLoadAgentPlugins(options?: ResolveAndLoadAgentPluginsOptions): Promise<{
     extensions: AgentPlugin[];

package/dist/extensions/plugin/plugin-config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-config-loader.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-config-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,KAAK,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,8BAA8B,CAC7C,aAAa,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAEV;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED,MAAM,WAAW,8BAA8B;IAC9C,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,uBAAuB,CACtC,OAAO,GAAE,8BAAmC,GAC1C,MAAM,EAAE,CAsBV;AAED,MAAM,WAAW,iCAChB,SAAQ,8BAA8B,EACrC,eAAe;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,wBAAsB,0BAA0B,CAC/C,OAAO,GAAE,iCAAsC,GAC7C,OAAO,CACT;IACC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,GAAG,qBAAqB,CACzB,CAuCA"}
+{"version":3,"file":"plugin-config-loader.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-config-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,KAAK,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,8BAA8B,CAC7C,aAAa,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAEV;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED,MAAM,WAAW,8BAA8B;IAC9C,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,uBAAuB,CACtC,OAAO,GAAE,8BAAmC,GAC1C,MAAM,EAAE,CAsBV;AAED,MAAM,WAAW,iCAChB,SAAQ,8BAA8B,EACrC,eAAe;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAC5C;AAED,wBAAsB,0BAA0B,CAC/C,OAAO,GAAE,iCAAsC,GAC7C,OAAO,CACT;IACC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,GAAG,qBAAqB,CACzB,CAiDA"}

package/dist/extensions/plugin/plugin-loader.d.ts

@@ -1,19 +1,23 @@
-import type { AgentConfig, PluginSetupContext } from "@clinebot/shared";
+import type { AgentExtension, PluginSetupContext } from "@clinebot/shared";
 import type { PluginInitializationFailure, PluginInitializationWarning } from "./plugin-load-report";
 import { type PluginTargeting } from "./plugin-targeting";
-type AgentPlugin = NonNullable<AgentConfig["extensions"]>[number];
 export interface LoadAgentPluginFromPathOptions {
     exportName?: string;
     cwd?: string;
     useCache?: boolean;
+    session?: PluginSetupContext["session"];
+    client?: PluginSetupContext["client"];
+    user?: PluginSetupContext["user"];
     workspaceInfo?: PluginSetupContext["workspaceInfo"];
+    automation?: PluginSetupContext["automation"];
+    logger?: PluginSetupContext["logger"];
+    telemetry?: PluginSetupContext["telemetry"];
 }
-export declare function loadAgentPluginFromPath(pluginPath: string, options?: LoadAgentPluginFromPathOptions): Promise<AgentPlugin>;
-export declare function loadAgentPluginsFromPaths(pluginPaths: string[], options?: LoadAgentPluginFromPathOptions & PluginTargeting): Promise<AgentPlugin[]>;
+export declare function loadAgentPluginFromPath(pluginPath: string, options?: LoadAgentPluginFromPathOptions): Promise<AgentExtension>;
+export declare function loadAgentPluginsFromPaths(pluginPaths: string[], options?: LoadAgentPluginFromPathOptions & PluginTargeting): Promise<AgentExtension[]>;
 export declare function loadAgentPluginsFromPathsWithDiagnostics(pluginPaths: string[], options?: LoadAgentPluginFromPathOptions & PluginTargeting): Promise<{
-    plugins: AgentPlugin[];
+    plugins: AgentExtension[];
     failures: PluginInitializationFailure[];
     warnings: PluginInitializationWarning[];
 }>;
-export {};
 //# sourceMappingURL=plugin-loader.d.ts.map

package/dist/extensions/plugin/plugin-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EACX,2BAA2B,EAC3B,2BAA2B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAWlE,MAAM,WAAW,8BAA8B;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CACpD;AA+ED,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC1C,OAAO,CAAC,WAAW,CAAC,CA4BtB;AAED,wBAAsB,yBAAyB,CAC9C,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,8BAA8B,GAAG,eAAoB,GAC5D,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB;AAED,wBAAsB,wCAAwC,CAC7D,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,8BAA8B,GAAG,eAAoB,GAC5D,OAAO,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,QAAQ,EAAE,2BAA2B,EAAE,CAAC;CACxC,CAAC,CA4CD"}
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EACX,2BAA2B,EAC3B,2BAA2B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,WAAW,8BAA8B;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAC5C;AA+ED,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAuCzB;AAED,wBAAsB,yBAAyB,CAC9C,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,8BAA8B,GAAG,eAAoB,GAC5D,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B;AAED,wBAAsB,wCAAwC,CAC7D,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,8BAA8B,GAAG,eAAoB,GAC5D,OAAO,CAAC;IACV,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,QAAQ,EAAE,2BAA2B,EAAE,CAAC;CACxC,CAAC,CA4CD"}

package/dist/extensions/plugin/plugin-sandbox.d.ts

@@ -1,6 +1,7 @@
-import type { AgentConfig, WorkspaceInfo } from "@clinebot/shared";
+import type { AgentConfig, PluginSetupContext, WorkspaceInfo } from "@clinebot/shared";
 import type { PluginLoadDiagnostics } from "./plugin-load-report";
 import type { PluginTargeting } from "./plugin-targeting";
+export type SandboxedPluginSetupContext = Pick<PluginSetupContext, "session" | "client" | "user" | "workspaceInfo" | "logger">;
 export interface PluginSandboxOptions extends PluginTargeting {
     pluginPaths: string[];
     exportName?: string;
@@ -23,6 +24,11 @@ export interface PluginSandboxOptions extends PluginTargeting {
      * so they can inspect git state without running their own commands.
      */
     workspaceInfo?: WorkspaceInfo;
+    session?: SandboxedPluginSetupContext["session"];
+    client?: SandboxedPluginSetupContext["client"];
+    user?: SandboxedPluginSetupContext["user"];
+    /** Enables a logger bridge that forwards sandbox log calls to the host. */
+    logger?: SandboxedPluginSetupContext["logger"];
 }
 export declare function loadSandboxedPlugins(options: PluginSandboxOptions): Promise<{
     extensions: AgentConfig["extensions"];

package/dist/extensions/plugin/plugin-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-sandbox.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,WAAW,EAGX,aAAa,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AA8JD,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CACT;IACC,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,GAAG,qBAAqB,CACzB,CA8FA"}
+{"version":3,"file":"plugin-sandbox.d.ts","sourceRoot":"","sources":["../../../src/extensions/plugin/plugin-sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,WAAW,EAIX,kBAAkB,EAElB,aAAa,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC7C,kBAAkB,EAClB,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,QAAQ,CAC1D,CAAC;AAEF,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAoMD,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CACT;IACC,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,GAAG,qBAAqB,CACzB,CAyGA"}