@grackle-ai/plugin-core 0.96.3

package/dist/root-task-boot.js

@@ -0,0 +1,234 @@
+/**
+ * Root task boot with reanimate-first strategy and exponential backoff.
+ *
+ * Extracted from the inline closure in `server/src/index.ts` so it can be
+ * unit tested. Follows the dependency-injection pattern established by
+ * `cron-phase.ts`.
+ *
+ * On each invocation (triggered by `environment.changed` events):
+ * 1. Checks if the root task is already running — if so, tracks stability.
+ * 2. If not running, attempts to reanimate the most recent session (preserving
+ *    conversation history) before falling back to a fresh spawn.
+ * 3. Applies exponential backoff after consecutive failures to prevent
+ *    crash-loop resource waste.
+ *
+ * @module
+ */
+import { ROOT_TASK_ID, ROOT_TASK_INITIAL_PROMPT, TASK_STATUS } from "@grackle-ai/common";
+import { logger } from "@grackle-ai/core";
+// ─── Constants ──────────────────────────────────────────────
+/** Initial delay before the first retry after a failed boot (milliseconds). */
+const BOOT_INITIAL_DELAY_MS = 1_000;
+/** Multiplier for exponential backoff between boot retries. */
+const BOOT_BACKOFF_MULTIPLIER = 2;
+/** Maximum delay between boot retries (milliseconds). */
+const BOOT_MAX_DELAY_MS = 60_000;
+/** Maximum consecutive boot failures before giving up until server restart. */
+const BOOT_MAX_FAILURES = 10;
+/** Minimum time a session must survive (ms) to be considered stable and reset backoff. */
+const BOOT_STABLE_THRESHOLD_MS = 30_000;
+// ─── State ──────────────────────────────────────────────────
+/** Create a fresh backoff state. */
+function createInitialState() {
+    return {
+        failures: 0,
+        lastFailureAt: 0,
+        inProgress: false,
+        lastSessionStartedAt: 0,
+    };
+}
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Create the root task boot handler.
+ *
+ * Returns a callable async function that can be wired to `environment.changed`
+ * event subscriptions. Each call checks whether the root task needs starting
+ * and applies reanimate-first + exponential backoff logic.
+ *
+ * Each call creates independent backoff state (not shared across calls).
+ *
+ * @param deps - Injected dependencies for testability.
+ * @returns An async function to call on each `environment.changed` event.
+ */
+export function createRootTaskBoot(deps) {
+    return createRootTaskBootHandler(deps, createInitialState());
+}
+/**
+ * Create the root task boot subscriber.
+ *
+ * Creates independent backoff state (not shared with other factory calls)
+ * and subscribes to `environment.changed` and `setting.changed` events.
+ * Returns a Disposable that unsubscribes the handler.
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @param deps - Injected dependencies for testability.
+ * @returns A Disposable that unsubscribes the handler.
+ */
+export function createRootTaskBootSubscriber(ctx, deps) {
+    const bootState = createInitialState();
+    const tryBoot = createRootTaskBootHandler(deps, bootState);
+    const unsubscribe = ctx.subscribe((event) => {
+        if (event.type === "environment.changed") {
+            tryBoot().catch(() => { });
+        }
+        // Also try when onboarding completes — the environment is already
+        // connected but boot was deferred until the user chose a runtime.
+        if (event.type === "setting.changed") {
+            const payload = event.payload;
+            if (payload.key === "onboarding_completed" && payload.value === "true") {
+                tryBoot().catch(() => { });
+            }
+        }
+    });
+    return {
+        dispose() {
+            unsubscribe();
+        },
+    };
+}
+// ─── Internal ───────────────────────────────────────────────
+/**
+ * Create an async boot handler that uses the given backoff state.
+ * Shared implementation for both {@link createRootTaskBoot} and
+ * {@link createRootTaskBootSubscriber}.
+ */
+function createRootTaskBootHandler(deps, s) {
+    return async () => {
+        // Guard: prevent concurrent boot attempts
+        if (s.inProgress) {
+            return;
+        }
+        s.inProgress = true;
+        try {
+            await attemptBoot(deps, s);
+        }
+        catch (err) {
+            recordFailure(s);
+            logger.warn({ err }, "Root task boot failed with unexpected exception");
+        }
+        finally {
+            s.inProgress = false; // eslint-disable-line require-atomic-updates -- single-threaded, flag guards re-entry
+        }
+    };
+}
+/** Core boot logic — separated from the guard/error wrapper for clarity. */
+async function attemptBoot(deps, s) {
+    // 0. Don't auto-start before onboarding — the user hasn't chosen their
+    // runtime yet, so the root task would launch with the default "claude-code".
+    if (deps.isOnboarded && !deps.isOnboarded()) {
+        return;
+    }
+    // 1. Look up root task
+    const rootTask = deps.getTask(ROOT_TASK_ID);
+    if (!rootTask) {
+        return;
+    }
+    // 2. Check if already working
+    const sessions = deps.listSessionsForTask(ROOT_TASK_ID);
+    const { status } = deps.computeTaskStatus(rootTask.status, sessions);
+    if (status === TASK_STATUS.WORKING) {
+        checkStabilityReset(s);
+        return;
+    }
+    // 2b. Crash-loop detection: if we recently started a session but the task
+    // is no longer working before the stability threshold, count it as a failure.
+    // This catches the case where startTaskSession succeeded but the session
+    // crashed shortly after (the main crash-loop scenario from issue #959).
+    if (s.lastSessionStartedAt > 0) {
+        const sinceLastStart = Date.now() - s.lastSessionStartedAt;
+        if (sinceLastStart < BOOT_STABLE_THRESHOLD_MS) {
+            // Session crashed before reaching stability — record as failure
+            if (s.lastFailureAt < s.lastSessionStartedAt) {
+                // Only record once per start (guard against multiple environment.changed events)
+                recordFailure(s);
+                logger.info({ survivedMs: sinceLastStart, failures: s.failures }, "Root task session crashed before stability threshold — recording failure");
+            }
+        }
+        else {
+            // Session survived past stability threshold but is now stopped — reset backoff
+            resetBackoff(s, sinceLastStart);
+        }
+        s.lastSessionStartedAt = 0;
+    }
+    // 3. Find connected environment
+    const connectedEnv = deps.findFirstConnectedEnvironment();
+    if (!connectedEnv) {
+        return;
+    }
+    // 4. Check backoff
+    if (s.failures >= BOOT_MAX_FAILURES) {
+        // Log only once when the threshold is first reached to avoid spam
+        if (s.failures === BOOT_MAX_FAILURES) {
+            logger.error({ failures: s.failures }, "Root task boot exhausted all retries (%d failures) — giving up until server restart", s.failures);
+        }
+        return;
+    }
+    if (s.failures > 0) {
+        const delay = Math.min(BOOT_INITIAL_DELAY_MS * Math.pow(BOOT_BACKOFF_MULTIPLIER, s.failures - 1), BOOT_MAX_DELAY_MS);
+        const elapsed = Date.now() - s.lastFailureAt;
+        if (elapsed < delay) {
+            return; // backoff not elapsed yet
+        }
+    }
+    // 5. Reanimate-first: try to resume the latest session
+    let booted = false;
+    const latestSession = deps.getLatestSessionForTask(ROOT_TASK_ID);
+    if (latestSession?.runtimeSessionId) {
+        try {
+            deps.reanimateAgent(latestSession.id);
+            booted = true;
+            logger.info({ sessionId: latestSession.id, environmentId: latestSession.environmentId }, "Root task reanimated existing session");
+        }
+        catch (reanimateErr) {
+            logger.info({ sessionId: latestSession.id, err: reanimateErr }, "Root task reanimate failed — falling back to fresh spawn");
+        }
+    }
+    // 6. Fresh spawn (fallback)
+    if (!booted) {
+        const err = await deps.startTaskSession(rootTask, {
+            environmentId: connectedEnv.id,
+            notes: ROOT_TASK_INITIAL_PROMPT,
+        });
+        if (err) {
+            recordFailure(s);
+            logger.warn({ err }, "Root task auto-start failed");
+            return;
+        }
+        logger.info({ environmentId: connectedEnv.id }, "Root task auto-started (fresh spawn)");
+    }
+    // 7. Track session start time for stability detection
+    s.lastSessionStartedAt = Date.now(); // eslint-disable-line require-atomic-updates -- single-threaded
+}
+/** Record a boot failure: increment counter and timestamp. */
+function recordFailure(s) {
+    s.failures++;
+    s.lastFailureAt = Date.now();
+}
+/**
+ * If the root task has been WORKING long enough (past the stability threshold),
+ * reset the backoff counter. Called when we detect the task is already running.
+ */
+function checkStabilityReset(s) {
+    if (s.failures === 0) {
+        return;
+    }
+    if (s.lastSessionStartedAt > 0) {
+        const elapsed = Date.now() - s.lastSessionStartedAt;
+        if (elapsed >= BOOT_STABLE_THRESHOLD_MS) {
+            resetBackoff(s, elapsed);
+        }
+    }
+    else {
+        // Task is WORKING but we didn't start it (e.g., session recovery
+        // reanimated it externally). Begin tracking stability from now so
+        // backoff can eventually reset — otherwise MAX_FAILURES is permanent.
+        s.lastSessionStartedAt = Date.now();
+    }
+}
+/** Zero out the backoff state after a session has proven stable. */
+function resetBackoff(s, survivedMs) {
+    logger.info({ survivedMs, previousFailures: s.failures }, "Root task session stable — resetting backoff");
+    s.failures = 0;
+    s.lastFailureAt = 0;
+}
+//# sourceMappingURL=root-task-boot.js.map

package/dist/root-task-boot.js.map

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

package/dist/schedule-expression.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Schedule expression parsing and next-run-time computation.
+ *
+ * Supports two formats:
+ * - **Interval shorthand**: `"<number><unit>"` where unit is s/m/h/d (min 10s)
+ * - **Cron expressions**: Standard 5-field cron syntax via `cron-parser`
+ */
+/**
+ * Parse an interval shorthand expression to milliseconds.
+ *
+ * @param expr - e.g. "30s", "5m", "1h", "1d"
+ * @returns Duration in milliseconds
+ * @throws If the expression is invalid or below the minimum (10s)
+ */
+export declare function parseDuration(expr: string): number;
+/**
+ * Detect whether an expression is interval shorthand (vs. cron).
+ *
+ * @param expr - Schedule expression string
+ * @returns true if the expression matches interval shorthand format
+ */
+export declare function isIntervalExpression(expr: string): boolean;
+/**
+ * Compute the next run time for a schedule expression.
+ *
+ * For intervals: if `lastRunAt + interval` is in the future, use that (prevents
+ * drift). Otherwise use `now + interval` (prevents burst-firing after downtime).
+ *
+ * For cron: next occurrence after now.
+ *
+ * @param expr - Schedule expression (interval or cron)
+ * @param lastRunAt - ISO timestamp of the last fire (undefined for first fire)
+ * @returns ISO timestamp of the next fire
+ */
+export declare function computeNextRunAt(expr: string, lastRunAt?: string): string;
+/**
+ * Validate a schedule expression. Throws if invalid.
+ *
+ * @param expr - Schedule expression to validate
+ * @throws If the expression is neither valid interval shorthand nor valid cron
+ */
+export declare function validateExpression(expr: string): void;
+//# sourceMappingURL=schedule-expression.d.ts.map

package/dist/schedule-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-expression.d.ts","sourceRoot":"","sources":["../src/schedule-expression.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBlD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBrD"}

package/dist/schedule-expression.js

@@ -0,0 +1,105 @@
+/**
+ * Schedule expression parsing and next-run-time computation.
+ *
+ * Supports two formats:
+ * - **Interval shorthand**: `"<number><unit>"` where unit is s/m/h/d (min 10s)
+ * - **Cron expressions**: Standard 5-field cron syntax via `cron-parser`
+ */
+import cronParser from "cron-parser";
+const INTERVAL_RE = /^(\d+)([smhd])$/;
+const MINIMUM_INTERVAL_MS = 10_000; // 10 seconds
+const UNIT_TO_MS = {
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+};
+/**
+ * Parse an interval shorthand expression to milliseconds.
+ *
+ * @param expr - e.g. "30s", "5m", "1h", "1d"
+ * @returns Duration in milliseconds
+ * @throws If the expression is invalid or below the minimum (10s)
+ */
+export function parseDuration(expr) {
+    const match = INTERVAL_RE.exec(expr);
+    if (!match) {
+        throw new Error(`Invalid interval expression: "${expr}". Expected format: <number><s|m|h|d> (e.g. "30s", "5m")`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const ms = value * UNIT_TO_MS[unit];
+    if (ms <= 0) {
+        throw new Error(`Interval must be positive: "${expr}"`);
+    }
+    if (ms < MINIMUM_INTERVAL_MS) {
+        throw new Error(`Interval "${expr}" (${ms}ms) is below the minimum of ${MINIMUM_INTERVAL_MS}ms (10s)`);
+    }
+    return ms;
+}
+/**
+ * Detect whether an expression is interval shorthand (vs. cron).
+ *
+ * @param expr - Schedule expression string
+ * @returns true if the expression matches interval shorthand format
+ */
+export function isIntervalExpression(expr) {
+    return INTERVAL_RE.test(expr);
+}
+/**
+ * Compute the next run time for a schedule expression.
+ *
+ * For intervals: if `lastRunAt + interval` is in the future, use that (prevents
+ * drift). Otherwise use `now + interval` (prevents burst-firing after downtime).
+ *
+ * For cron: next occurrence after now.
+ *
+ * @param expr - Schedule expression (interval or cron)
+ * @param lastRunAt - ISO timestamp of the last fire (undefined for first fire)
+ * @returns ISO timestamp of the next fire
+ */
+export function computeNextRunAt(expr, lastRunAt) {
+    const now = Date.now();
+    if (isIntervalExpression(expr)) {
+        const intervalMs = parseDuration(expr);
+        const nowPlusInterval = now + intervalMs;
+        if (lastRunAt) {
+            const lastRunMs = new Date(lastRunAt).getTime();
+            const anchored = lastRunMs + intervalMs;
+            // Anchored: use lastRunAt + interval if it's in the future (prevents drift).
+            // If it's in the past (server was down), cap to now + interval (prevents burst).
+            if (anchored > now) {
+                return new Date(anchored).toISOString();
+            }
+            return new Date(nowPlusInterval).toISOString();
+        }
+        return new Date(nowPlusInterval).toISOString();
+    }
+    // Cron expression: compute next occurrence after now
+    const interval = cronParser.parseExpression(expr, { utc: true });
+    return interval.next().toISOString();
+}
+/**
+ * Validate a schedule expression. Throws if invalid.
+ *
+ * @param expr - Schedule expression to validate
+ * @throws If the expression is neither valid interval shorthand nor valid cron
+ */
+export function validateExpression(expr) {
+    if (!expr) {
+        throw new Error("Schedule expression cannot be empty");
+    }
+    if (isIntervalExpression(expr)) {
+        // parseDuration validates format and minimum
+        parseDuration(expr);
+        return;
+    }
+    // Try to parse as cron
+    try {
+        cronParser.parseExpression(expr, { utc: true });
+    }
+    catch {
+        throw new Error(`Invalid schedule expression: "${expr}". Must be interval shorthand (e.g. "30s", "5m") or 5-field cron (e.g. "0 9 * * MON")`);
+    }
+}
+//# sourceMappingURL=schedule-expression.js.map

package/dist/schedule-expression.js.map

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

package/dist/schedule-handlers.d.ts

@@ -0,0 +1,12 @@
+import { grackle } from "@grackle-ai/common";
+/** Create a new schedule. */
+export declare function createSchedule(req: grackle.CreateScheduleRequest): Promise<grackle.Schedule>;
+/** List all schedules, optionally filtered by workspace. */
+export declare function listSchedules(req: grackle.ListSchedulesRequest): Promise<grackle.ScheduleList>;
+/** Get a schedule by ID. */
+export declare function getSchedule(req: grackle.ScheduleId): Promise<grackle.Schedule>;
+/** Update an existing schedule. */
+export declare function updateSchedule(req: grackle.UpdateScheduleRequest): Promise<grackle.Schedule>;
+/** Delete a schedule by ID. */
+export declare function deleteSchedule(req: grackle.ScheduleId): Promise<grackle.Empty>;
+//# sourceMappingURL=schedule-handlers.d.ts.map

package/dist/schedule-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-handlers.d.ts","sourceRoot":"","sources":["../src/schedule-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,6BAA6B;AAC7B,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA2ClG;AAED,4DAA4D;AAC5D,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAKpG;AAED,4BAA4B;AAC5B,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAMpF;AAED,mCAAmC;AACnC,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA6DlG;AAED,+BAA+B;AAC/B,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAIpF"}

package/dist/schedule-handlers.js

@@ -0,0 +1,122 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { personaStore, scheduleStore } from "@grackle-ai/database";
+import { v4 as uuid } from "uuid";
+import { validateExpression, computeNextRunAt } from "./schedule-expression.js";
+import { emit } from "@grackle-ai/core";
+import { scheduleRowToProto } from "./grpc-proto-converters.js";
+/** Create a new schedule. */
+export async function createSchedule(req) {
+    const title = req.title.trim();
+    const expr = req.scheduleExpression.trim();
+    const personaId = req.personaId.trim();
+    if (!title) {
+        throw new ConnectError("title is required", Code.InvalidArgument);
+    }
+    if (!expr) {
+        throw new ConnectError("schedule_expression is required", Code.InvalidArgument);
+    }
+    if (!personaId) {
+        throw new ConnectError("persona_id is required", Code.InvalidArgument);
+    }
+    // Validate persona exists
+    const persona = personaStore.getPersona(personaId);
+    if (!persona) {
+        throw new ConnectError(`Persona not found: ${personaId}`, Code.NotFound);
+    }
+    // Validate expression
+    try {
+        validateExpression(expr);
+    }
+    catch (err) {
+        throw new ConnectError(err instanceof Error ? err.message : "Invalid schedule expression", Code.InvalidArgument);
+    }
+    const id = uuid();
+    const nextRunAt = computeNextRunAt(expr);
+    scheduleStore.createSchedule(id, title, req.description, expr, personaId, req.environmentId, req.workspaceId, req.parentTaskId, nextRunAt);
+    emit("schedule.created", { scheduleId: id });
+    const row = scheduleStore.getSchedule(id);
+    return scheduleRowToProto(row);
+}
+/** List all schedules, optionally filtered by workspace. */
+export async function listSchedules(req) {
+    const rows = scheduleStore.listSchedules(req.workspaceId || undefined);
+    return create(grackle.ScheduleListSchema, {
+        schedules: rows.map(scheduleRowToProto),
+    });
+}
+/** Get a schedule by ID. */
+export async function getSchedule(req) {
+    const row = scheduleStore.getSchedule(req.id);
+    if (!row) {
+        throw new ConnectError(`Schedule not found: ${req.id}`, Code.NotFound);
+    }
+    return scheduleRowToProto(row);
+}
+/** Update an existing schedule. */
+export async function updateSchedule(req) {
+    const existing = scheduleStore.getSchedule(req.id);
+    if (!existing) {
+        throw new ConnectError(`Schedule not found: ${req.id}`, Code.NotFound);
+    }
+    const update = {};
+    if (req.title !== undefined && req.title.trim() !== "") {
+        update.title = req.title.trim();
+    }
+    if (req.description !== undefined) {
+        update.description = req.description;
+    }
+    if (req.personaId !== undefined && req.personaId.trim() !== "") {
+        const trimmedPersonaId = req.personaId.trim();
+        const persona = personaStore.getPersona(trimmedPersonaId);
+        if (!persona) {
+            throw new ConnectError(`Persona not found: ${trimmedPersonaId}`, Code.NotFound);
+        }
+        update.personaId = trimmedPersonaId;
+    }
+    if (req.environmentId !== undefined) {
+        update.environmentId = req.environmentId;
+    }
+    // Handle schedule expression change
+    let expressionChanged = false;
+    if (req.scheduleExpression !== undefined && req.scheduleExpression !== "") {
+        const expr = req.scheduleExpression.trim();
+        try {
+            validateExpression(expr);
+        }
+        catch (err) {
+            throw new ConnectError(err instanceof Error ? err.message : "Invalid schedule expression", Code.InvalidArgument);
+        }
+        update.scheduleExpression = expr;
+        expressionChanged = true;
+    }
+    // Handle enable/disable
+    if (req.enabled !== undefined) {
+        update.enabled = req.enabled;
+        if (req.enabled) {
+            const expr = update.scheduleExpression ?? existing.scheduleExpression;
+            update.nextRunAt = computeNextRunAt(expr);
+        }
+        else {
+            update.nextRunAt = null;
+        }
+    }
+    else if (expressionChanged) {
+        // Recompute nextRunAt when expression changes (if currently enabled)
+        if (existing.enabled) {
+            update.nextRunAt = computeNextRunAt(update.scheduleExpression);
+        }
+    }
+    scheduleStore.updateSchedule(req.id, update);
+    emit("schedule.updated", { scheduleId: req.id });
+    const row = scheduleStore.getSchedule(req.id);
+    return scheduleRowToProto(row);
+}
+/** Delete a schedule by ID. */
+export async function deleteSchedule(req) {
+    scheduleStore.deleteSchedule(req.id);
+    emit("schedule.deleted", { scheduleId: req.id });
+    return create(grackle.EmptySchema, {});
+}
+//# sourceMappingURL=schedule-handlers.js.map

package/dist/schedule-handlers.js.map

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

package/dist/session-handlers.d.ts

@@ -0,0 +1,40 @@
+import { grackle } from "@grackle-ai/common";
+/** Spawn a new agent session in the given environment. */
+export declare function spawnAgent(req: grackle.SpawnRequest): Promise<grackle.Session>;
+/** Resume a previously suspended agent session. */
+export declare function resumeAgent(req: grackle.ResumeRequest): Promise<grackle.Session>;
+/** Send text input to a running session. */
+export declare function sendInput(req: grackle.InputMessage): Promise<grackle.Empty>;
+/** Kill (or gracefully stop) an agent session. */
+export declare function killAgent(req: grackle.KillAgentRequest): Promise<grackle.Empty>;
+/** Get aggregated usage stats for a session, task, task tree, workspace, or environment. */
+export declare function getUsage(req: grackle.GetUsageRequest): Promise<grackle.UsageStats>;
+/** Wait for a message on a synchronous pipe subscription. */
+export declare function waitForPipe(req: grackle.WaitForPipeRequest): Promise<grackle.WaitForPipeResponse>;
+/** Write a message to a pipe fd. */
+export declare function writeToFd(req: grackle.WriteToFdRequest): Promise<grackle.Empty>;
+/** Close a pipe file descriptor, optionally stopping child sessions. */
+export declare function closeFd(req: grackle.CloseFdRequest): Promise<grackle.CloseFdResponse>;
+/** Get all open file descriptors for a session. */
+export declare function getSessionFds(req: grackle.SessionId): grackle.SessionFds;
+/** Create a new named stream. Creator gets an rw/async subscription. */
+export declare function createStream(req: grackle.CreateStreamRequest): Promise<grackle.CreateStreamResponse>;
+/** Attach another session to a stream the caller holds an fd on. */
+export declare function attachStream(req: grackle.AttachStreamRequest): Promise<grackle.AttachStreamResponse>;
+/** List all active IPC streams with subscriber details and message buffer depth. */
+export declare function listStreams(): Promise<grackle.ListStreamsResponse>;
+/** List sessions with optional filters. */
+export declare function listSessions(req: grackle.SessionFilter): Promise<grackle.SessionList>;
+/** Get a session by ID. */
+export declare function getSession(req: grackle.SessionId): Promise<grackle.Session>;
+/** Get all events recorded for a session. */
+export declare function getSessionEvents(req: grackle.SessionId): Promise<grackle.SessionEventList>;
+/** Get all sessions for a task. */
+export declare function getTaskSessions(req: grackle.TaskId): Promise<grackle.SessionList>;
+/** Stream session events as they occur. */
+export declare function streamSession(req: grackle.SessionId): AsyncGenerator<grackle.SessionEvent>;
+/** Stream all session events across all sessions. */
+export declare function streamAll(): AsyncGenerator<grackle.SessionEvent>;
+/** Stream domain events (replaces WebSocket event broadcasting). */
+export declare function streamEvents(): AsyncGenerator<grackle.ServerEvent>;
+//# sourceMappingURL=session-handlers.d.ts.map

package/dist/session-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-handlers.d.ts","sourceRoot":"","sources":["../src/session-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAa,MAAM,oBAAoB,CAAC;AAuCxD,0DAA0D;AAC1D,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAkMpF;AAED,mDAAmD;AACnD,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAItF;AAED,4CAA4C;AAC5C,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAoCjF;AAED,kDAAkD;AAClD,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAoCrF;AAED,4FAA4F;AAC5F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CA0CxF;AAED,6DAA6D;AAC7D,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAsCvG;AAED,oCAAoC;AACpC,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAyCrF;AAED,wEAAwE;AACxE,wBAAsB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAwD3F;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAuBxE;AA6CD,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CA4B1G;AAED,oEAAoE;AACpE,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CA2C1G;AAED,oFAAoF;AACpF,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAuBxE;AAED,2CAA2C;AAC3C,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAK3F;AAED,2BAA2B;AAC3B,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAMjF;AAED,6CAA6C;AAC7C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAwBhG;AAED,mCAAmC;AACnC,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAQvF;AAED,2CAA2C;AAC3C,wBAAuB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,CASjG;AAED,qDAAqD;AACrD,wBAAuB,SAAS,IAAI,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,CASvE;AAED,oEAAoE;AACpE,wBAAuB,YAAY,IAAI,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAiBzE"}