@urateam/core 0.1.0

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,IAAI,aAAa,EAAE,QAAQ,GAAG,UAAqB,CAAC;AAE3D,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI,CAEpE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAkBzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BvB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtB,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,129 @@
+import { customType, sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
+/**
+ * Active driver mode for cross-database timestamp serialization.
+ * Set by createDb when a connection is established.
+ * Internal — not part of the public API.
+ */
+export let _schemaDriver = "sqlite";
+/** @internal — called only by createDb in client.ts. */
+export function _setSchemaDriver(driver) {
+    _schemaDriver = driver;
+}
+/**
+ * Cross-database timestamp column type.
+ *
+ * - SQLite:   stored as INTEGER epoch seconds. `toDriver` converts Date → epoch int.
+ *             `fromDriver` converts epoch integer (or legacy ISO string) → Date.
+ * - Postgres: stored as TIMESTAMPTZ. `toDriver` converts Date → ISO-8601 string.
+ *             `fromDriver` converts the Date object returned by postgres-js → Date.
+ *
+ * Application code always works with plain JS `Date` objects regardless of driver.
+ */
+export const crossTimestamp = customType({
+    dataType() {
+        return _schemaDriver === "postgres" ? "timestamptz" : "integer";
+    },
+    toDriver(value) {
+        if (_schemaDriver === "postgres") {
+            return value.toISOString();
+        }
+        return Math.floor(value.getTime() / 1000);
+    },
+    fromDriver(value) {
+        if (value instanceof Date)
+            return value;
+        if (typeof value === "number")
+            return new Date(value * 1000);
+        return new Date(value);
+    },
+});
+export const pipelineRuns = sqliteTable("pipeline_runs", {
+    id: text("id").primaryKey(),
+    issueId: text("issue_id").notNull(),
+    issueTitle: text("issue_title").notNull(),
+    pipelineKey: text("pipeline_key").notNull(),
+    repoUrl: text("repo_url").notNull(),
+    branch: text("branch"),
+    status: text("status").notNull(),
+    startedAt: crossTimestamp("started_at")
+        .notNull()
+        .$defaultFn(() => new Date()),
+    completedAt: crossTimestamp("completed_at"),
+    prUrl: text("pr_url"),
+    totalInputTokens: integer("total_input_tokens").notNull().default(0),
+    totalOutputTokens: integer("total_output_tokens").notNull().default(0),
+    errorMessage: text("error_message"),
+    currentStageIndex: integer("current_stage_index"),
+    resumePayload: text("resume_payload"),
+    retryCount: integer("retry_count").notNull().default(0),
+    /** "standard" for normal runs, "review-feedback" for PR comment re-entry runs. */
+    runType: text("run_type").notNull().default("standard"),
+    /** For review-feedback runs: the run ID of the original pipeline run that created the PR. */
+    parentRunId: text("parent_run_id"),
+    /** For review-feedback runs: JSON-serialised array of ReviewFeedbackComment objects. */
+    feedbackContext: text("feedback_context"),
+    /** True (1) when the pipeline auto-merged the PR; false (0) otherwise. */
+    autoMerged: integer("auto_merged", { mode: "boolean" }),
+    /** Human-readable reason for the auto-merge decision (e.g. "PR auto-merged" or skip reason). */
+    autoMergeReason: text("auto_merge_reason"),
+    /** True (1) when auto-commit was triggered because the agent did not commit its work. Quality metric. */
+    autoCommitted: integer("auto_committed", { mode: "boolean" }),
+});
+export const stageRuns = sqliteTable("stage_runs", {
+    id: text("id").primaryKey(),
+    pipelineRunId: text("pipeline_run_id")
+        .notNull()
+        .references(() => pipelineRuns.id),
+    stage: text("stage").notNull(),
+    status: text("status").notNull(),
+    startedAt: crossTimestamp("started_at")
+        .notNull()
+        .$defaultFn(() => new Date()),
+    completedAt: crossTimestamp("completed_at"),
+    inputTokens: integer("input_tokens").notNull().default(0),
+    outputTokens: integer("output_tokens").notNull().default(0),
+    turns: integer("turns").notNull().default(0),
+    handoffArtifact: text("handoff_artifact"),
+    errorMessage: text("error_message"),
+});
+export const agentLogs = sqliteTable("agent_logs", {
+    id: text("id").primaryKey(),
+    stageRunId: text("stage_run_id")
+        .notNull()
+        .references(() => stageRuns.id),
+    timestamp: crossTimestamp("timestamp")
+        .notNull()
+        .$defaultFn(() => new Date()),
+    type: text("type").notNull(),
+    content: text("content").notNull(),
+});
+export const activeWork = sqliteTable("active_work", {
+    id: text("id").primaryKey(),
+    runId: text("run_id").notNull().unique(),
+    issueId: text("issue_id").notNull(),
+    stage: text("stage").notNull(),
+    filesModified: text("files_modified"),
+    startedAt: crossTimestamp("started_at")
+        .notNull()
+        .$defaultFn(() => new Date()),
+    updatedAt: crossTimestamp("updated_at")
+        .notNull()
+        .$defaultFn(() => new Date()),
+});
+export const webhookDedup = sqliteTable("webhook_dedup", {
+    id: text("id").primaryKey(),
+    expiresAt: crossTimestamp("expires_at").notNull(),
+});
+export const pmApprovals = sqliteTable("pm_approvals", {
+    id: text("id").primaryKey(),
+    issueId: text("issue_id").notNull(),
+    action: text("action").notNull(),
+    reason: text("reason").notNull(),
+    slackMessageTs: text("slack_message_ts").notNull(),
+    status: text("status").notNull(),
+    createdAt: crossTimestamp("created_at")
+        .notNull()
+        .$defaultFn(() => new Date()),
+    resolvedAt: crossTimestamp("resolved_at"),
+});
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

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

package/dist/entrypoint.d.ts

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

package/dist/entrypoint.d.ts.map

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

package/dist/entrypoint.js

@@ -0,0 +1,113 @@
+import { readFileSync } from "node:fs";
+import { serve } from "@hono/node-server";
+import { createApp } from "./server.js";
+import { defaultConfigs } from "./pipeline/config.js";
+import { cleanupWorktrees } from "./repo/git.js";
+// Build optional GitHub config from env vars
+let github;
+if (process.env.GITHUB_APP_ID && process.env.GITHUB_PRIVATE_KEY_PATH) {
+    github = {
+        appId: process.env.GITHUB_APP_ID,
+        privateKey: readFileSync(process.env.GITHUB_PRIVATE_KEY_PATH, "utf-8"),
+        installationId: process.env.GITHUB_INSTALLATION_ID
+            ? parseInt(process.env.GITHUB_INSTALLATION_ID, 10)
+            : undefined,
+    };
+}
+// Build optional dashboard auth.
+// NOTE: core cannot import @urateam/dashboard (would be circular).
+// dashboardAuth is read here so it can be passed to createApp for callers
+// that mount the dashboard separately (e.g. the CLI). For a self-contained
+// production deployment, run the dashboard as a separate process using
+// packages/dashboard directly, or migrate this entrypoint to the CLI package.
+const dashboardUser = process.env.DASHBOARD_USER;
+const dashboardPass = process.env.DASHBOARD_PASSWORD;
+const dashboardAuth = dashboardUser && dashboardPass
+    ? { username: dashboardUser, password: dashboardPass }
+    : undefined;
+const _parsedTtl = parseInt(process.env.WORKTREE_TTL_HOURS ?? "24", 10);
+const worktreeTtlHours = Number.isFinite(_parsedTtl) && _parsedTtl > 0 ? _parsedTtl : 24;
+// Build repoConfigs from env vars (same pattern as CLI dev command)
+const repoConfigs = {};
+if (process.env.REPO_TEAM_ID && process.env.REPO_URL) {
+    repoConfigs[process.env.REPO_TEAM_ID] = {
+        url: process.env.REPO_URL,
+        defaultBranch: process.env.REPO_DEFAULT_BRANCH ?? "main",
+        testCommand: process.env.REPO_TEST_CMD ?? "pnpm test",
+        buildCommand: process.env.REPO_BUILD_CMD ?? "pnpm build",
+    };
+}
+const config = {
+    webhookSecret: process.env.LINEAR_WEBHOOK_SECRET ?? "",
+    linearApiKey: process.env.LINEAR_API_KEY ?? "",
+    pipelineConfigs: defaultConfigs,
+    repoConfigs,
+    databaseUrl: process.env.DATABASE_URL,
+    slackWebhookUrl: process.env.SLACK_WEBHOOK_URL,
+    discordWebhookUrl: process.env.DISCORD_WEBHOOK_URL,
+    concurrency: parseInt(process.env.MAX_CONCURRENT_RUNS ?? "3", 10),
+    agentRunDir: process.env.AGENT_RUN_DIR,
+    github,
+    dashboardAuth,
+    githubWebhookSecret: process.env.GITHUB_WEBHOOK_SECRET,
+};
+if (!config.webhookSecret) {
+    console.error("LINEAR_WEBHOOK_SECRET is required");
+    process.exit(1);
+}
+async function main() {
+    const { app, db, runner } = await createApp(config);
+    const port = parseInt(process.env.PORT ?? "3000", 10);
+    console.log(`Linear Agent Framework starting on port ${port}`);
+    console.log(`Pipelines: ${Object.keys(config.pipelineConfigs).join(", ")}`);
+    console.log(`Database: ${config.databaseUrl?.startsWith("postgres") ? "Postgres" : "SQLite"}`);
+    // --- Worktree cleanup cron ---
+    // Failed pipeline runs preserve their worktrees for debugging.  Run an
+    // initial sweep at startup, then repeat every hour so stale directories
+    // don't accumulate between restarts.
+    const agentRunDir = config.agentRunDir ?? "/var/agent-runs";
+    async function runWorktreeCleanup() {
+        const removed = await cleanupWorktrees(agentRunDir, worktreeTtlHours);
+        if (removed.length > 0) {
+            console.log(`Worktree cleanup: removed ${removed.length} stale director${removed.length === 1 ? "y" : "ies"} (TTL ${worktreeTtlHours}h)`);
+        }
+    }
+    await runWorktreeCleanup();
+    const cleanupInterval = setInterval(runWorktreeCleanup, 60 * 60 * 1000); // every hour
+    cleanupInterval.unref(); // don't block process exit
+    // One-time startup recovery: requeue any retriable runs left from a prior crash
+    try {
+        const { recoverRetriableRuns } = await import("./pm/actions/recover.js");
+        const recoveryResult = await recoverRetriableRuns({
+            db,
+            runner,
+            maxRetries: 3,
+        });
+        if (recoveryResult.recovered.length > 0) {
+            console.log(`Startup recovery: requeued ${recoveryResult.recovered.length} retriable run(s)`);
+        }
+        if (recoveryResult.exhausted.length > 0) {
+            console.log(`Startup recovery: ${recoveryResult.exhausted.length} run(s) exceeded max retries`);
+        }
+    }
+    catch (err) {
+        console.error("Startup recovery sweep failed:", err);
+    }
+    const server = serve({ fetch: app.fetch, port });
+    function shutdown() {
+        console.log("Shutting down...");
+        clearInterval(cleanupInterval);
+        server.close(() => {
+            console.log("Server closed");
+            process.exit(0);
+        });
+        setTimeout(() => process.exit(1), 30_000);
+    }
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+}
+main().catch((err) => {
+    console.error("Failed to start:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=entrypoint.js.map

package/dist/entrypoint.js.map

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

package/dist/executor/agent-config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Default CLAUDE.md content injected into agent worktrees.
+ * Establishes coding standards, security requirements, and behavioral
+ * guidelines for autonomous pipeline execution.
+ *
+ * If the target repo already has a CLAUDE.md, this is NOT injected —
+ * the repo's own config takes precedence.
+ */
+export declare const DEFAULT_AGENT_CLAUDE_MD = "# CLAUDE.md \u2014 Deployed Agent Instructions\n\nThis file is injected by the Linear Agent Framework. It establishes coding standards, security requirements, and behavioral guidelines for autonomous pipeline execution.\n\n## Role\n\nYou are an autonomous agent executing a pipeline stage (implement, test, review, etc.) for a Linear issue. You are working in a git worktree on a dedicated branch. Your output will be reviewed by a validation agent and possibly a human reviewer before merging.\n\n## Code Quality Standards\n\n### General\n- Write minimal, focused changes. Fix what the issue asks \u2014 nothing more.\n- Do not refactor surrounding code, add comments to unchanged code, or \"improve\" things not in scope.\n- Do not add speculative features, feature flags, or backwards-compatibility shims.\n- Prefer simple, readable code over clever abstractions. Three similar lines > premature abstraction.\n- Only add error handling at system boundaries (user input, external APIs). Trust internal code.\n\n### Security (non-negotiable)\n- NEVER use `exec` \u2014 always `execFile` to prevent command injection.\n- NEVER interpolate user input into shell commands, SQL, or agent prompts without escaping.\n- NEVER commit secrets, API keys, .env files, or credentials.\n- Sanitize all external content (issue descriptions, webhook payloads) before use.\n- Follow OWASP top 10 awareness: XSS, SQL injection, command injection, etc.\n\n### Testing\n- Run the test suite after making changes. If tests fail, fix them.\n- Add tests for new functionality \u2014 but don't over-test. Cover the contract, not the implementation.\n- Don't mock what you can test directly. Prefer integration tests over unit tests with heavy mocking.\n\n### Git\n- Make atomic commits with clear messages describing WHY, not WHAT.\n- Don't amend, rebase, or force-push. Create new commits.\n- Don't commit generated files, build artifacts, or node_modules.\n\n## Behavioral Guidelines\n\n### Efficiency\n- Go straight to the point. Try the simplest approach first.\n- Read files before modifying them. Understand context before changing code.\n- Don't create new files unless absolutely necessary. Edit existing files.\n- Don't add documentation files, READMEs, or comments unless the issue asks for it.\n\n### Communication\n- Be concise in any output. Lead with the action or answer.\n- When you encounter an obstacle, diagnose before switching approaches.\n- If you're stuck, explain what you tried and what failed \u2014 don't loop.\n\n### Scope Discipline\n- Stay within the issue's acceptance criteria. Check them before finishing.\n- If the issue is ambiguous, make reasonable assumptions and document them in code comments.\n- If you discover related bugs while working, note them but don't fix them unless they block the issue.\n\n## Technology Conventions\n\n### TypeScript / Node.js\n- Use `import` / `export` (ESM), not `require`.\n- Use `interface` over `type` for object shapes.\n- Use Zod for runtime validation of external data.\n- Use `async/await`, not callbacks or `.then()` chains.\n- Prefer `const` over `let`. Never use `var`.\n\n### Project Structure\n- Types and schemas in a central `types.ts` file.\n- Each module has a barrel export `index.ts`.\n- Tests in `__tests__/` directories next to source files.\n\n## Handoff\n\nWhen you complete your work, the framework automatically extracts a structured handoff artifact from your changes (via git diff). You do not need to output a JSON block \u2014 just do the work and the framework handles the rest.\n\nIf you want to provide additional context for the next stage, include it as clear prose in your final message.\n";
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/executor/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/executor/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,4lHAuEnC,CAAC"}

package/dist/executor/agent-config.js

@@ -0,0 +1,81 @@
+/**
+ * Default CLAUDE.md content injected into agent worktrees.
+ * Establishes coding standards, security requirements, and behavioral
+ * guidelines for autonomous pipeline execution.
+ *
+ * If the target repo already has a CLAUDE.md, this is NOT injected —
+ * the repo's own config takes precedence.
+ */
+export const DEFAULT_AGENT_CLAUDE_MD = `# CLAUDE.md — Deployed Agent Instructions
+
+This file is injected by the Linear Agent Framework. It establishes coding standards, security requirements, and behavioral guidelines for autonomous pipeline execution.
+
+## Role
+
+You are an autonomous agent executing a pipeline stage (implement, test, review, etc.) for a Linear issue. You are working in a git worktree on a dedicated branch. Your output will be reviewed by a validation agent and possibly a human reviewer before merging.
+
+## Code Quality Standards
+
+### General
+- Write minimal, focused changes. Fix what the issue asks — nothing more.
+- Do not refactor surrounding code, add comments to unchanged code, or "improve" things not in scope.
+- Do not add speculative features, feature flags, or backwards-compatibility shims.
+- Prefer simple, readable code over clever abstractions. Three similar lines > premature abstraction.
+- Only add error handling at system boundaries (user input, external APIs). Trust internal code.
+
+### Security (non-negotiable)
+- NEVER use \`exec\` — always \`execFile\` to prevent command injection.
+- NEVER interpolate user input into shell commands, SQL, or agent prompts without escaping.
+- NEVER commit secrets, API keys, .env files, or credentials.
+- Sanitize all external content (issue descriptions, webhook payloads) before use.
+- Follow OWASP top 10 awareness: XSS, SQL injection, command injection, etc.
+
+### Testing
+- Run the test suite after making changes. If tests fail, fix them.
+- Add tests for new functionality — but don't over-test. Cover the contract, not the implementation.
+- Don't mock what you can test directly. Prefer integration tests over unit tests with heavy mocking.
+
+### Git
+- Make atomic commits with clear messages describing WHY, not WHAT.
+- Don't amend, rebase, or force-push. Create new commits.
+- Don't commit generated files, build artifacts, or node_modules.
+
+## Behavioral Guidelines
+
+### Efficiency
+- Go straight to the point. Try the simplest approach first.
+- Read files before modifying them. Understand context before changing code.
+- Don't create new files unless absolutely necessary. Edit existing files.
+- Don't add documentation files, READMEs, or comments unless the issue asks for it.
+
+### Communication
+- Be concise in any output. Lead with the action or answer.
+- When you encounter an obstacle, diagnose before switching approaches.
+- If you're stuck, explain what you tried and what failed — don't loop.
+
+### Scope Discipline
+- Stay within the issue's acceptance criteria. Check them before finishing.
+- If the issue is ambiguous, make reasonable assumptions and document them in code comments.
+- If you discover related bugs while working, note them but don't fix them unless they block the issue.
+
+## Technology Conventions
+
+### TypeScript / Node.js
+- Use \`import\` / \`export\` (ESM), not \`require\`.
+- Use \`interface\` over \`type\` for object shapes.
+- Use Zod for runtime validation of external data.
+- Use \`async/await\`, not callbacks or \`.then()\` chains.
+- Prefer \`const\` over \`let\`. Never use \`var\`.
+
+### Project Structure
+- Types and schemas in a central \`types.ts\` file.
+- Each module has a barrel export \`index.ts\`.
+- Tests in \`__tests__/\` directories next to source files.
+
+## Handoff
+
+When you complete your work, the framework automatically extracts a structured handoff artifact from your changes (via git diff). You do not need to output a JSON block — just do the work and the framework handles the rest.
+
+If you want to provide additional context for the next stage, include it as clear prose in your final message.
+`;
+//# sourceMappingURL=agent-config.js.map

package/dist/executor/agent-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.js","sourceRoot":"","sources":["../../src/executor/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEtC,CAAC"}

package/dist/executor/agent-stream.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared helpers for consuming Agent SDK message streams and parsing
+ * JSON blocks from agent output.
+ */
+export interface StreamMessage {
+    type?: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+    content?: Array<{
+        type: string;
+        text?: string;
+    }> | string;
+    /** Agent SDK wraps assistant text in `message` for some message shapes */
+    message?: {
+        content?: Array<{
+            type: string;
+            text?: string;
+        }> | string;
+    } | string;
+}
+export interface ConsumeResult {
+    lastText: string;
+    inputTokens: number;
+    outputTokens: number;
+    turns: number;
+}
+/**
+ * Consume an Agent SDK message stream, accumulating token usage and
+ * extracting the last assistant text content.
+ *
+ * The optional `onToolMessage` callback is invoked for tool_use / tool_result
+ * messages so callers (e.g. executor.ts) can log them without duplicating
+ * the iteration boilerplate.
+ */
+export declare function consumeAgentStream(messages: AsyncIterable<unknown>, options?: {
+    onToolMessage?: (msg: StreamMessage) => void;
+    /** Called periodically (every progressIntervalMs) with current stats */
+    onProgress?: (stats: {
+        messageCount: number;
+        turns: number;
+        inputTokens: number;
+        outputTokens: number;
+    }) => void;
+    progressIntervalMs?: number;
+}): Promise<ConsumeResult>;
+/**
+ * Extract text from an Agent SDK message content field.
+ */
+export declare function extractText(content: Array<{
+    type: string;
+    text?: string;
+}> | string): string;
+/**
+ * Extract and parse a bare JSON object from text (finds first `{...}` match).
+ * Returns null if no object is found or if parsing fails.
+ */
+export declare function parseJsonObject(text: string): any | null;
+/**
+ * Extract and parse a ```json fenced code block from agent output text.
+ * Returns null if no block is found or if parsing fails.
+ */
+export declare function parseJsonBlock(text: string): unknown | null;
+//# sourceMappingURL=agent-stream.d.ts.map

package/dist/executor/agent-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream.d.ts","sourceRoot":"","sources":["../../src/executor/agent-stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,CAAC;IAC1D,0EAA0E;IAC1E,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CAClF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GACA,OAAO,CAAC,aAAa,CAAC,CAoDxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,GACvD,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAQxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ3D"}

package/dist/executor/agent-stream.js

@@ -0,0 +1,101 @@
+/**
+ * Shared helpers for consuming Agent SDK message streams and parsing
+ * JSON blocks from agent output.
+ */
+/**
+ * Consume an Agent SDK message stream, accumulating token usage and
+ * extracting the last assistant text content.
+ *
+ * The optional `onToolMessage` callback is invoked for tool_use / tool_result
+ * messages so callers (e.g. executor.ts) can log them without duplicating
+ * the iteration boilerplate.
+ */
+export async function consumeAgentStream(messages, options) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let turns = 0;
+    let lastText = "";
+    let messageCount = 0;
+    let lastProgressTime = Date.now();
+    const progressInterval = options?.progressIntervalMs ?? 30_000;
+    for await (const rawMessage of messages) {
+        const message = rawMessage;
+        messageCount++;
+        if (options?.onProgress && Date.now() - lastProgressTime >= progressInterval) {
+            options.onProgress({ messageCount, turns, inputTokens, outputTokens });
+            lastProgressTime = Date.now();
+        }
+        if (message.usage) {
+            inputTokens += message.usage.input_tokens ?? 0;
+            outputTokens += message.usage.output_tokens ?? 0;
+        }
+        if ((message.type === "tool_use" || message.type === "tool_result") &&
+            options?.onToolMessage) {
+            options.onToolMessage(message);
+        }
+        if (message.type === "assistant") {
+            // Agent SDK may put text in `content` (tool-using sessions) or
+            // `message.content` (no-tool sessions). Check both.
+            if (message.content) {
+                const text = extractText(message.content);
+                if (text)
+                    lastText = text;
+            }
+            else if (message.message) {
+                const inner = typeof message.message === "string"
+                    ? message.message
+                    : message.message.content
+                        ? extractText(message.message.content)
+                        : "";
+                if (inner)
+                    lastText = inner;
+            }
+        }
+        if (message.type === "assistant") {
+            turns++;
+        }
+    }
+    return { lastText, inputTokens, outputTokens, turns };
+}
+/**
+ * Extract text from an Agent SDK message content field.
+ */
+export function extractText(content) {
+    return Array.isArray(content)
+        ? content
+            .filter((p) => p.type === "text")
+            .map((p) => p.text ?? "")
+            .join("\n")
+        : String(content);
+}
+/**
+ * Extract and parse a bare JSON object from text (finds first `{...}` match).
+ * Returns null if no object is found or if parsing fails.
+ */
+export function parseJsonObject(text) {
+    const match = text.match(/\{[\s\S]*\}/);
+    if (!match)
+        return null;
+    try {
+        return JSON.parse(match[0]);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract and parse a ```json fenced code block from agent output text.
+ * Returns null if no block is found or if parsing fails.
+ */
+export function parseJsonBlock(text) {
+    const match = text.match(/```json\s*\n([\s\S]*?)\n```/);
+    if (!match)
+        return null;
+    try {
+        return JSON.parse(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=agent-stream.js.map

package/dist/executor/agent-stream.js.map

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

package/dist/executor/auth-check.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validates Claude auth credentials by running `claude auth status`.
+ * Results are cached for 5 minutes to avoid hammering the CLI on every call.
+ * Uses a single-flight pattern so concurrent callers share one subprocess.
+ * Returns true if auth is valid, false otherwise.
+ */
+export declare function isClaudeAuthValid(): Promise<boolean>;
+/** Reset the cached auth check (e.g., after a refresh attempt). */
+export declare function resetAuthCheckCache(): void;
+//# sourceMappingURL=auth-check.d.ts.map

package/dist/executor/auth-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-check.d.ts","sourceRoot":"","sources":["../../src/executor/auth-check.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CA8B1D;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/executor/auth-check.js

@@ -0,0 +1,52 @@
+import { execFile } from "node:child_process";
+import { createLogger } from "../logger.js";
+const log = createLogger({ component: "AuthCheck" });
+let lastCheckTime = 0;
+let lastCheckResult = false;
+let inflightCheck = null;
+const CHECK_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Validates Claude auth credentials by running `claude auth status`.
+ * Results are cached for 5 minutes to avoid hammering the CLI on every call.
+ * Uses a single-flight pattern so concurrent callers share one subprocess.
+ * Returns true if auth is valid, false otherwise.
+ */
+export async function isClaudeAuthValid() {
+    const now = Date.now();
+    if (now - lastCheckTime < CHECK_INTERVAL_MS) {
+        return lastCheckResult;
+    }
+    // Single-flight: if a check is already in progress, share its result.
+    if (inflightCheck)
+        return inflightCheck;
+    inflightCheck = (async () => {
+        try {
+            await new Promise((resolve, reject) => {
+                execFile("claude", ["auth", "status"], { timeout: 10_000 }, (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+            lastCheckResult = true;
+            log.debug("Claude auth check passed");
+        }
+        catch {
+            lastCheckResult = false;
+            log.error("Claude auth check failed — credentials may be expired. Run: claude login");
+        }
+        finally {
+            lastCheckTime = Date.now();
+            inflightCheck = null;
+        }
+        return lastCheckResult;
+    })();
+    return inflightCheck;
+}
+/** Reset the cached auth check (e.g., after a refresh attempt). */
+export function resetAuthCheckCache() {
+    lastCheckTime = 0;
+    lastCheckResult = false;
+}
+//# sourceMappingURL=auth-check.js.map

package/dist/executor/auth-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-check.js","sourceRoot":"","sources":["../../src/executor/auth-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;AAErD,IAAI,aAAa,GAAG,CAAC,CAAC;AACtB,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,IAAI,aAAa,GAA4B,IAAI,CAAC;AAClD,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAErD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,aAAa,GAAG,iBAAiB,EAAE,CAAC;QAC5C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,sEAAsE;IACtE,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;oBAClE,IAAI,GAAG;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;wBAChB,OAAO,EAAE,CAAC;gBACjB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,eAAe,GAAG,IAAI,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,eAAe,GAAG,KAAK,CAAC;YACxB,GAAG,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;QACxF,CAAC;gBAAS,CAAC;YACT,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB;IACjC,aAAa,GAAG,CAAC,CAAC;IAClB,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC"}