siclaw 0.1.0

package/dist/cron/cron-scheduler.js

@@ -0,0 +1,91 @@
+/**
+ * Cron Scheduler — Event-driven, one setTimeout per job
+ *
+ * Pure timer manager. Each active job gets its own timer.
+ * CRUD operations update timers in real-time.
+ * DB coordination is handled by CronCoordinator.
+ */
+import { getNextCronDelay, getNextCronTime } from "./cron-matcher.js";
+export class CronScheduler {
+    timers = new Map();
+    jobs = new Map();
+    executing = new Set();
+    onFire;
+    constructor(onFire) {
+        this.onFire = onFire;
+    }
+    /** Add or update a job — cancels old timer and reschedules */
+    addOrUpdate(job) {
+        this.cancel(job.id);
+        this.jobs.set(job.id, job);
+        if (job.status === "active") {
+            this.scheduleNext(job);
+            console.log(`[cron-scheduler] Scheduled job ${job.id} (${job.name})`);
+        }
+        else {
+            console.log(`[cron-scheduler] Job ${job.id} (${job.name}) is paused, not scheduling`);
+        }
+    }
+    /** Cancel a job's timer */
+    cancel(jobId) {
+        const timer = this.timers.get(jobId);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(jobId);
+        }
+        this.jobs.delete(jobId);
+    }
+    /** Schedule next fire for a job */
+    scheduleNext(job) {
+        try {
+            const delay = getNextCronDelay(job.schedule);
+            const nextTime = getNextCronTime(job.schedule);
+            console.log(`[cron-scheduler] Job ${job.id} (${job.name}) next fire at ${nextTime.toISOString()} (in ${Math.round(delay / 1000)}s)`);
+            const timer = setTimeout(async () => {
+                this.timers.delete(job.id);
+                // Guard against concurrent execution from race with addOrUpdate
+                if (this.executing.has(job.id))
+                    return;
+                this.executing.add(job.id);
+                console.log(`[cron-scheduler] Firing job ${job.id} (${job.name})`);
+                try {
+                    await this.onFire(job);
+                }
+                catch (err) {
+                    console.error(`[cron-scheduler] Job ${job.id} fire error:`, err);
+                }
+                finally {
+                    this.executing.delete(job.id);
+                }
+                // Reschedule if still in our job list and active
+                const current = this.jobs.get(job.id);
+                if (current && current.status === "active") {
+                    this.scheduleNext(current);
+                }
+            }, delay);
+            timer.unref();
+            this.timers.set(job.id, timer);
+        }
+        catch (err) {
+            console.error(`[cron-scheduler] Failed to schedule job ${job.id}:`, err);
+        }
+    }
+    /** Stop all timers */
+    stop() {
+        for (const [, timer] of this.timers) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.jobs.clear();
+        console.log("[cron-scheduler] Stopped all timers");
+    }
+    /** Get current job count */
+    get jobCount() {
+        return this.timers.size;
+    }
+    /** Get IDs of all scheduled jobs (for reconciliation) */
+    get scheduledJobIds() {
+        return [...this.timers.keys()];
+    }
+}
+//# sourceMappingURL=cron-scheduler.js.map

package/dist/cron/cron-scheduler.js.map

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

package/dist/cron/gateway-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Gateway Client — HTTP proxy for cron DB operations
+ *
+ * Replaces direct ConfigRepository access so the cron service
+ * no longer needs its own database connection. All state flows
+ * through Gateway's internal API.
+ */
+import type { CronJobRow } from "./cron-scheduler.js";
+export declare class GatewayClient {
+    private baseUrl;
+    constructor(gatewayUrl: string);
+    registerCronInstance(instanceId: string, endpoint: string): Promise<void>;
+    updateHeartbeat(instanceId: string, jobCount: number): Promise<void>;
+    deleteInstance(instanceId: string): Promise<void>;
+    releaseInstanceJobs(instanceId: string): Promise<void>;
+    getDeadInstances(thresholdMs: number): Promise<Array<{
+        instanceId: string;
+        heartbeatAt: Date;
+    }>>;
+    getLeastLoadedInstance(thresholdMs: number): Promise<{
+        instanceId: string;
+        jobCount: number;
+    } | null>;
+    listCronJobsByInstance(instanceId: string): Promise<CronJobRow[]>;
+    getCronJobById(id: string): Promise<CronJobRow | null>;
+    getUnassignedActiveJobs(): Promise<CronJobRow[]>;
+    claimUnassignedJob(jobId: string, instanceId: string): Promise<boolean>;
+    updateCronJobRun(jobId: string, result: "success" | "failure"): Promise<void>;
+    reassignOrphanedJobs(fromInstanceId: string, toInstanceId: string): Promise<void>;
+    private get;
+    private post;
+}

package/dist/cron/gateway-client.js

@@ -0,0 +1,91 @@
+/**
+ * Gateway Client — HTTP proxy for cron DB operations
+ *
+ * Replaces direct ConfigRepository access so the cron service
+ * no longer needs its own database connection. All state flows
+ * through Gateway's internal API.
+ */
+export class GatewayClient {
+    baseUrl;
+    constructor(gatewayUrl) {
+        this.baseUrl = gatewayUrl.replace(/\/$/, "");
+    }
+    // ─── Cron Instances ──────────────────────────────
+    async registerCronInstance(instanceId, endpoint) {
+        await this.post("/api/internal/cron/register", { instanceId, endpoint });
+    }
+    async updateHeartbeat(instanceId, jobCount) {
+        await this.post("/api/internal/cron/heartbeat", { instanceId, jobCount });
+    }
+    async deleteInstance(instanceId) {
+        await this.post("/api/internal/cron/delete-instance", { instanceId });
+    }
+    async releaseInstanceJobs(instanceId) {
+        await this.post("/api/internal/cron/release-jobs", { instanceId });
+    }
+    async getDeadInstances(thresholdMs) {
+        const data = await this.get(`/api/internal/cron/dead-instances?thresholdMs=${thresholdMs}`);
+        return data.instances.map((i) => ({
+            instanceId: i.instanceId,
+            heartbeatAt: new Date(i.heartbeatAt),
+        }));
+    }
+    async getLeastLoadedInstance(thresholdMs) {
+        const data = await this.get(`/api/internal/cron/least-loaded?thresholdMs=${thresholdMs}`);
+        return data.instance;
+    }
+    // ─── Cron Jobs ──────────────────────────────────
+    async listCronJobsByInstance(instanceId) {
+        const data = await this.get(`/api/internal/cron/jobs?instanceId=${encodeURIComponent(instanceId)}`);
+        return data.jobs.map(parseJobDates);
+    }
+    async getCronJobById(id) {
+        const data = await this.get(`/api/internal/cron/jobs/${encodeURIComponent(id)}`);
+        return data.job ? parseJobDates(data.job) : null;
+    }
+    async getUnassignedActiveJobs() {
+        const data = await this.get("/api/internal/cron/jobs?unassigned=1");
+        return data.jobs.map(parseJobDates);
+    }
+    async claimUnassignedJob(jobId, instanceId) {
+        const data = await this.post("/api/internal/cron/claim-job", { jobId, instanceId });
+        return data.claimed;
+    }
+    async updateCronJobRun(jobId, result) {
+        await this.post("/api/internal/cron/job-run", { jobId, result });
+    }
+    async reassignOrphanedJobs(fromInstanceId, toInstanceId) {
+        await this.post("/api/internal/cron/reassign-jobs", { fromInstanceId, toInstanceId });
+    }
+    // ─── HTTP helpers ────────────────────────────────
+    async get(path) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!resp.ok) {
+            throw new Error(`Gateway GET ${path} returned ${resp.status}: ${await resp.text()}`);
+        }
+        return resp.json();
+    }
+    async post(path, body) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!resp.ok) {
+            throw new Error(`Gateway POST ${path} returned ${resp.status}: ${await resp.text()}`);
+        }
+        return resp.json();
+    }
+}
+/** Convert JSON date strings back to Date objects */
+function parseJobDates(job) {
+    return {
+        ...job,
+        lastRunAt: job.lastRunAt ? new Date(job.lastRunAt) : null,
+        lockedAt: job.lockedAt ? new Date(job.lockedAt) : null,
+    };
+}
+//# sourceMappingURL=gateway-client.js.map

package/dist/cron/gateway-client.js.map

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

package/dist/cron-main.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cron Service — Standalone Process Entry Point
+ *
+ * Independent from Gateway. Multi-instance capable via CronCoordinator.
+ * Each instance registers itself, sends heartbeats, and claims jobs.
+ * Dead instances are detected and their jobs reassigned.
+ *
+ * All DB access goes through Gateway's internal API (no direct DB connection).
+ */
+export {};

package/dist/cron-main.js

@@ -0,0 +1,75 @@
+/**
+ * Cron Service — Standalone Process Entry Point
+ *
+ * Independent from Gateway. Multi-instance capable via CronCoordinator.
+ * Each instance registers itself, sends heartbeats, and claims jobs.
+ * Dead instances are detected and their jobs reassigned.
+ *
+ * All DB access goes through Gateway's internal API (no direct DB connection).
+ */
+import os from "node:os";
+import { CronScheduler } from "./cron/cron-scheduler.js";
+import { CronExecutor } from "./cron/cron-executor.js";
+import { CronCoordinator } from "./cron/cron-coordinator.js";
+import { createCronApi } from "./cron/cron-api.js";
+import { GatewayClient } from "./cron/gateway-client.js";
+const apiPort = parseInt(process.env.SICLAW_CRON_API_PORT || "3100", 10);
+// Instance identity — in K8s, HOSTNAME is the pod name (unique per replica)
+const instanceId = process.env.SICLAW_CRON_INSTANCE_ID || process.env.HOSTNAME || `cron-${os.hostname()}-${process.pid}`;
+// Construct endpoint: explicit > Pod IP > localhost
+const endpoint = process.env.SICLAW_CRON_ENDPOINT ||
+    (process.env.POD_IP
+        ? `http://${process.env.POD_IP}:${apiPort}`
+        : `http://localhost:${apiPort}`);
+console.log(`[cron] Instance ID: ${instanceId}`);
+console.log(`[cron] Endpoint: ${endpoint}`);
+// 1. Create gateway client (all DB access goes through gateway)
+const gatewayUrl = process.env.SICLAW_GATEWAY_URL || "http://siclaw-gateway";
+console.log(`[cron] Gateway URL: ${gatewayUrl}`);
+const client = new GatewayClient(gatewayUrl);
+// 2. Create executor (delegates to gateway's internal API)
+const executor = new CronExecutor(gatewayUrl, client);
+const scheduler = new CronScheduler((job) => executor.execute(job));
+// 3. Create coordinator for multi-instance coordination
+const coordinator = new CronCoordinator(instanceId, endpoint, client, scheduler);
+// 4. Start inner API
+const apiServer = createCronApi(scheduler, instanceId);
+apiServer.listen(apiPort, () => {
+    console.log(`[cron] Inner API listening on port ${apiPort}`);
+});
+// 5. Start coordinator (registers instance, loads assigned jobs, starts heartbeat + reconcile)
+await coordinator.start();
+console.log(`[cron] Service started (instance: ${instanceId})`);
+// 6. Built-in daily purge: hard-delete notifications older than 30 days
+const PURGE_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const RETENTION_DAYS = 30;
+async function purgeOldNotifications() {
+    try {
+        const resp = await fetch(`${gatewayUrl}/api/internal/notifications/purge`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ retentionDays: RETENTION_DAYS }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        const data = await resp.json();
+        console.log(`[cron] Notification purge: deleted=${data.deleted ?? 0} (retention=${RETENTION_DAYS}d)`);
+    }
+    catch (err) {
+        console.warn("[cron] Notification purge failed:", err instanceof Error ? err.message : err);
+    }
+}
+// Run once on startup + every 24h
+purgeOldNotifications();
+const purgeTimer = setInterval(purgeOldNotifications, PURGE_INTERVAL_MS);
+purgeTimer.unref();
+// 7. Graceful shutdown — release jobs immediately so other instances can claim them
+async function shutdown() {
+    console.log("\n[cron] Shutting down...");
+    scheduler.stop();
+    await coordinator.shutdown();
+    apiServer.close();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+//# sourceMappingURL=cron-main.js.map

package/dist/cron-main.js.map

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

package/dist/gateway/agentbox/client.d.ts

@@ -0,0 +1,187 @@
+/**
+ * AgentBox HTTP Client
+ *
+ * Client used by the Gateway to call the AgentBox HTTP API.
+ * Supports mTLS when TLS options are provided.
+ */
+import { type ResourceType } from "../../shared/resource-sync.js";
+export interface AgentBoxTlsOptions {
+    cert: string;
+    key: string;
+    ca: string;
+}
+export interface PromptOptions {
+    sessionId?: string;
+    text: string;
+    /** string = use this env, null = explicitly no env, undefined = keep current */
+    kubeconfigPath?: string | null;
+    /** Environment ID for schedule filtering — string = use this env, null = no env */
+    envId?: string | null;
+    /** Session mode — "web" | "channel" */
+    mode?: string;
+    /** Model provider to use for this prompt */
+    modelProvider?: string;
+    /** Model ID to use for this prompt */
+    modelId?: string;
+    /** Brain type — "pi-agent" | "claude-sdk" */
+    brainType?: string;
+    /** Workspace ID (for logging/context) */
+    workspaceId?: string;
+    /** Credential payload — agentbox materializes files locally from this data */
+    credentials?: {
+        manifest: Array<{
+            name: string;
+            type: string;
+            description?: string | null;
+            files: string[];
+            metadata?: Record<string, unknown>;
+        }>;
+        files: Array<{
+            name: string;
+            content: string;
+            mode?: number;
+        }>;
+    };
+    /** Full provider config for dynamic registration (from gateway DB) */
+    modelConfig?: {
+        name: string;
+        baseUrl: string;
+        apiKey: string;
+        api: string;
+        authHeader: boolean;
+        models: Array<{
+            id: string;
+            name: string;
+            reasoning: boolean;
+            input: string[];
+            cost: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+            };
+            contextWindow: number;
+            maxTokens: number;
+            compat?: Record<string, unknown>;
+        }>;
+    };
+}
+export interface PromptResponse {
+    ok: boolean;
+    sessionId: string;
+    brainType?: string;
+}
+export interface SessionInfo {
+    id: string;
+    createdAt: string;
+    lastActiveAt: string;
+}
+export interface HealthResponse {
+    status: string;
+    sessions: number;
+    timestamp: string;
+}
+export interface ModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+}
+export interface ContextUsageResponse {
+    tokens: number;
+    contextWindow: number;
+    percent: number;
+    isCompacting: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    cost: number;
+}
+export declare class AgentBoxClient {
+    private endpoint;
+    private timeoutMs;
+    private httpsAgent;
+    constructor(endpoint: string, timeoutMs?: number, tlsOptions?: AgentBoxTlsOptions);
+    /**
+     * Health check
+     */
+    health(): Promise<HealthResponse>;
+    /**
+     * Send a prompt
+     */
+    prompt(opts: PromptOptions): Promise<PromptResponse>;
+    /**
+     * Get session list
+     */
+    listSessions(): Promise<{
+        sessions: SessionInfo[];
+    }>;
+    /**
+     * Generic resource reload — POST to the descriptor's reloadPath.
+     */
+    reloadResource(type: ResourceType): Promise<unknown>;
+    /**
+     * Get context usage
+     */
+    getContextUsage(sessionId: string): Promise<ContextUsageResponse>;
+    /**
+     * Send a steer instruction (inserts a user message after interrupting the current tool)
+     */
+    steerSession(sessionId: string, text: string): Promise<void>;
+    /**
+     * Clear queued steer/followUp messages
+     */
+    clearQueue(sessionId: string): Promise<{
+        steering: string[];
+        followUp: string[];
+    }>;
+    /**
+     * Abort the current prompt execution
+     */
+    abortSession(sessionId: string): Promise<void>;
+    /**
+     * Close a session
+     */
+    closeSession(sessionId: string): Promise<void>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<{
+        models: ModelInfo[];
+    }>;
+    /**
+     * Get the current model
+     */
+    getModel(sessionId: string): Promise<{
+        model: ModelInfo | null;
+        brainType?: string;
+    }>;
+    /**
+     * Switch model
+     */
+    setModel(sessionId: string, provider: string, modelId: string): Promise<{
+        ok: boolean;
+        model: ModelInfo;
+    }>;
+    /**
+     * Subscribe to the SSE event stream
+     *
+     * Returns an AsyncIterable that can be iterated with for-await-of.
+     */
+    streamEvents(sessionId: string): AsyncIterable<unknown>;
+    /**
+     * SSE stream over HTTPS with mTLS
+     */
+    private streamEventsHttps;
+    /**
+     * Base fetch wrapper (supports both HTTP and HTTPS with mTLS)
+     */
+    private fetch;
+    /**
+     * HTTPS request with mTLS (returns a Response-compatible object)
+     */
+    private httpsRequest;
+}