agor-live 0.3.7

package/dist/core/task-DuIfiUbW.d.ts

@@ -0,0 +1,163 @@
+import { T as TaskID, a as SessionID } from './id-DMqyogFB.js';
+
+/**
+ * Path to a context file (markdown) relative to context/
+ *
+ * Examples:
+ * - "README.md"
+ * - "concepts/core.md"
+ * - "explorations/subsession-orchestration.md"
+ */
+type ContextFilePath = string;
+/**
+ * Context file list item (lightweight, for browsing)
+ * Returned by GET /context
+ */
+interface ContextFileListItem {
+    /**
+     * File path relative to context/
+     * Examples: "concepts/core.md", "explorations/cli.md", "README.md"
+     */
+    path: ContextFilePath;
+    /** Human-readable title (extracted from first H1 or filename) */
+    title: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified timestamp (ISO 8601) */
+    lastModified: string;
+}
+/**
+ * Full context file details (includes content)
+ * Returned by GET /context/:path
+ */
+interface ContextFileDetail extends ContextFileListItem {
+    /** Full markdown content */
+    content: string;
+}
+
+/**
+ * Path to a report file relative to context/reports/
+ *
+ * Structure: context/reports/<session-id>/<task-id>.md
+ *
+ * Examples:
+ * - "01933e4a-7b89-7c35-a8f3-9d2e1c4b5a6f/0193a1b2-3c4d-7e5f-a8f3-9d2e1c4b5a6f.md"
+ * - "01934c2d-1234-7c35-a8f3-9d2e1c4b5a6f/0193b3c4-5d6e-7f8a-b9c0-d1e2f3a4b5c6.md"
+ */
+type ReportPath = string;
+/**
+ * Template type for report generation
+ *
+ * Different templates structure the report differently:
+ * - "standard": Default template with learnings, decisions, blockers
+ * - "technical": Deep dive into technical decisions and trade-offs
+ * - "summary": Brief summary of work completed
+ * - "custom": User-defined template
+ */
+type ReportTemplate = 'standard' | 'technical' | 'summary' | 'custom';
+/**
+ * Report metadata
+ *
+ * Reports are auto-generated after task completion, capturing:
+ * - What was learned during the task
+ * - Key decisions made
+ * - Concepts that emerged
+ * - Blockers encountered
+ */
+interface Report {
+    /**
+     * File path relative to context/reports/
+     * This serves as the unique identifier.
+     *
+     * Format: "<session-id>/<task-id>.md"
+     */
+    path: ReportPath;
+    /** Task this report belongs to */
+    task_id: TaskID;
+    /** Template used for report generation */
+    template: ReportTemplate;
+    /** Markdown content of the report */
+    content: string;
+    /**
+     * Context files extracted or referenced in this report
+     * Can reference existing context files or suggest new ones
+     */
+    contextFiles: ContextFilePath[];
+    /** When the report was generated */
+    generated_at: string;
+    /** File metadata */
+    created_at: string;
+    last_updated: string;
+}
+
+declare const TaskStatus: {
+    readonly CREATED: "created";
+    readonly RUNNING: "running";
+    readonly STOPPING: "stopping";
+    readonly AWAITING_PERMISSION: "awaiting_permission";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly STOPPED: "stopped";
+};
+type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];
+interface Task {
+    /** Unique task identifier (UUIDv7) */
+    task_id: TaskID;
+    /** Session this task belongs to */
+    session_id: SessionID;
+    /** User ID of the user who created this task */
+    created_by: string;
+    /** Original user prompt (can be multi-line) */
+    full_prompt: string;
+    /** Optional: LLM-generated short summary */
+    description?: string;
+    status: TaskStatus;
+    message_range: {
+        start_index: number;
+        end_index: number;
+        start_timestamp: string;
+        end_timestamp?: string;
+    };
+    tool_use_count: number;
+    git_state: {
+        ref_at_start: string;
+        sha_at_start: string;
+        sha_at_end?: string;
+        commit_message?: string;
+    };
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        total_tokens?: number;
+        cache_read_tokens?: number;
+        cache_creation_tokens?: number;
+        estimated_cost_usd?: number;
+    };
+    duration_ms?: number;
+    agent_session_id?: string;
+    context_window?: number;
+    context_window_limit?: number;
+    model?: string;
+    report?: {
+        /**
+         * File path relative to context/reports/
+         * Format: "<session-id>/<task-id>.md"
+         */
+        path: ReportPath;
+        template: ReportTemplate;
+        generated_at: string;
+    };
+    permission_request?: {
+        request_id: string;
+        tool_name: string;
+        tool_input: Record<string, unknown>;
+        tool_use_id?: string;
+        requested_at: string;
+        approved_by?: string;
+        approved_at?: string;
+    };
+    created_at: string;
+    completed_at?: string;
+}
+
+export { type ContextFilePath as C, type ReportPath as R, TaskStatus as T, type ContextFileListItem as a, type ContextFileDetail as b, type ReportTemplate as c, type Report as d, type Task as e };

package/dist/core/templates/handlebars-helpers.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/templates/handlebars-helpers.ts
+var handlebars_helpers_exports = {};
+__export(handlebars_helpers_exports, {
+  buildWorktreeContext: () => buildWorktreeContext,
+  registerHandlebarsHelpers: () => registerHandlebarsHelpers,
+  renderTemplate: () => renderTemplate
+});
+module.exports = __toCommonJS(handlebars_helpers_exports);
+var import_handlebars = __toESM(require("handlebars"), 1);
+function registerHandlebarsHelpers() {
+  import_handlebars.default.registerHelper("add", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  add helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA + numB;
+  });
+  import_handlebars.default.registerHelper("sub", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  sub helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA - numB;
+  });
+  import_handlebars.default.registerHelper("mul", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  mul helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA * numB;
+  });
+  import_handlebars.default.registerHelper("div", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  div helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    if (numB === 0) {
+      console.warn(`\u26A0\uFE0F  div helper received zero divisor`);
+      return 0;
+    }
+    return numA / numB;
+  });
+  import_handlebars.default.registerHelper("mod", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  mod helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    if (numB === 0) {
+      console.warn(`\u26A0\uFE0F  mod helper received zero divisor`);
+      return 0;
+    }
+    return numA % numB;
+  });
+  import_handlebars.default.registerHelper("uppercase", (str) => {
+    return String(str || "").toUpperCase();
+  });
+  import_handlebars.default.registerHelper("lowercase", (str) => {
+    return String(str || "").toLowerCase();
+  });
+  import_handlebars.default.registerHelper("replace", (str, search, replace) => {
+    return String(str || "").split(search).join(replace);
+  });
+  import_handlebars.default.registerHelper("eq", (a, b) => {
+    return a === b;
+  });
+  import_handlebars.default.registerHelper("neq", (a, b) => {
+    return a !== b;
+  });
+  import_handlebars.default.registerHelper("gt", (a, b) => {
+    return Number(a) > Number(b);
+  });
+  import_handlebars.default.registerHelper("lt", (a, b) => {
+    return Number(a) < Number(b);
+  });
+  import_handlebars.default.registerHelper("gte", (a, b) => {
+    return Number(a) >= Number(b);
+  });
+  import_handlebars.default.registerHelper("lte", (a, b) => {
+    return Number(a) <= Number(b);
+  });
+  import_handlebars.default.registerHelper("default", (value, defaultValue) => {
+    return value ?? defaultValue;
+  });
+  import_handlebars.default.registerHelper("json", (obj) => {
+    return JSON.stringify(obj, null, 2);
+  });
+}
+function renderTemplate(templateString, context) {
+  try {
+    const template = import_handlebars.default.compile(templateString);
+    return template(context);
+  } catch (error) {
+    console.error("\u274C Handlebars template error:", error);
+    throw error;
+  }
+}
+function buildWorktreeContext(worktree) {
+  return {
+    // Scoped entities (accessible as {{entity.property}})
+    worktree: {
+      unique_id: worktree.worktree_unique_id,
+      name: worktree.name,
+      path: worktree.path
+    },
+    repo: {
+      slug: worktree.repo_slug || ""
+    },
+    // User-defined custom context (accessible as {{custom.key}})
+    custom: worktree.custom_context || {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildWorktreeContext,
+  registerHandlebarsHelpers,
+  renderTemplate
+});

package/dist/core/templates/handlebars-helpers.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Handlebars helper functions for template rendering
+ *
+ * Shared between frontend and backend for consistent template evaluation.
+ * Used in:
+ * - Environment config templates (up/down commands)
+ * - Zone triggers
+ * - Report templates
+ * - Any other Handlebars-based templating
+ */
+/**
+ * Register all Handlebars helpers
+ *
+ * Call this once during application initialization.
+ */
+declare function registerHandlebarsHelpers(): void;
+/**
+ * Render a Handlebars template with given context
+ *
+ * Automatically registers helpers if not already registered.
+ *
+ * @param templateString - Handlebars template string
+ * @param context - Template context variables
+ * @returns Rendered string
+ */
+declare function renderTemplate(templateString: string, context: Record<string, unknown>): string;
+/**
+ * Build standard template context for worktree environments
+ *
+ * Provides scoped entity references (consistent with zone triggers):
+ * - {{worktree.unique_id}} - Auto-assigned unique number (1, 2, 3, ...)
+ * - {{worktree.name}} - Worktree name (slug format)
+ * - {{worktree.path}} - Absolute path to worktree directory
+ * - {{repo.slug}} - Repository slug
+ * - {{custom.*}} - Any custom context from worktree.custom_context
+ */
+declare function buildWorktreeContext(worktree: {
+    worktree_unique_id: number;
+    name: string;
+    path: string;
+    repo_slug?: string;
+    custom_context?: Record<string, unknown>;
+}): Record<string, unknown>;
+
+export { buildWorktreeContext, registerHandlebarsHelpers, renderTemplate };

package/dist/core/templates/handlebars-helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Handlebars helper functions for template rendering
+ *
+ * Shared between frontend and backend for consistent template evaluation.
+ * Used in:
+ * - Environment config templates (up/down commands)
+ * - Zone triggers
+ * - Report templates
+ * - Any other Handlebars-based templating
+ */
+/**
+ * Register all Handlebars helpers
+ *
+ * Call this once during application initialization.
+ */
+declare function registerHandlebarsHelpers(): void;
+/**
+ * Render a Handlebars template with given context
+ *
+ * Automatically registers helpers if not already registered.
+ *
+ * @param templateString - Handlebars template string
+ * @param context - Template context variables
+ * @returns Rendered string
+ */
+declare function renderTemplate(templateString: string, context: Record<string, unknown>): string;
+/**
+ * Build standard template context for worktree environments
+ *
+ * Provides scoped entity references (consistent with zone triggers):
+ * - {{worktree.unique_id}} - Auto-assigned unique number (1, 2, 3, ...)
+ * - {{worktree.name}} - Worktree name (slug format)
+ * - {{worktree.path}} - Absolute path to worktree directory
+ * - {{repo.slug}} - Repository slug
+ * - {{custom.*}} - Any custom context from worktree.custom_context
+ */
+declare function buildWorktreeContext(worktree: {
+    worktree_unique_id: number;
+    name: string;
+    path: string;
+    repo_slug?: string;
+    custom_context?: Record<string, unknown>;
+}): Record<string, unknown>;
+
+export { buildWorktreeContext, registerHandlebarsHelpers, renderTemplate };

package/dist/core/templates/handlebars-helpers.js

@@ -0,0 +1,119 @@
+// src/templates/handlebars-helpers.ts
+import Handlebars from "handlebars";
+function registerHandlebarsHelpers() {
+  Handlebars.registerHelper("add", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  add helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA + numB;
+  });
+  Handlebars.registerHelper("sub", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  sub helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA - numB;
+  });
+  Handlebars.registerHelper("mul", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  mul helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    return numA * numB;
+  });
+  Handlebars.registerHelper("div", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  div helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    if (numB === 0) {
+      console.warn(`\u26A0\uFE0F  div helper received zero divisor`);
+      return 0;
+    }
+    return numA / numB;
+  });
+  Handlebars.registerHelper("mod", (a, b) => {
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+      console.warn(`\u26A0\uFE0F  mod helper received non-numeric values: ${a}, ${b}`);
+      return 0;
+    }
+    if (numB === 0) {
+      console.warn(`\u26A0\uFE0F  mod helper received zero divisor`);
+      return 0;
+    }
+    return numA % numB;
+  });
+  Handlebars.registerHelper("uppercase", (str) => {
+    return String(str || "").toUpperCase();
+  });
+  Handlebars.registerHelper("lowercase", (str) => {
+    return String(str || "").toLowerCase();
+  });
+  Handlebars.registerHelper("replace", (str, search, replace) => {
+    return String(str || "").split(search).join(replace);
+  });
+  Handlebars.registerHelper("eq", (a, b) => {
+    return a === b;
+  });
+  Handlebars.registerHelper("neq", (a, b) => {
+    return a !== b;
+  });
+  Handlebars.registerHelper("gt", (a, b) => {
+    return Number(a) > Number(b);
+  });
+  Handlebars.registerHelper("lt", (a, b) => {
+    return Number(a) < Number(b);
+  });
+  Handlebars.registerHelper("gte", (a, b) => {
+    return Number(a) >= Number(b);
+  });
+  Handlebars.registerHelper("lte", (a, b) => {
+    return Number(a) <= Number(b);
+  });
+  Handlebars.registerHelper("default", (value, defaultValue) => {
+    return value ?? defaultValue;
+  });
+  Handlebars.registerHelper("json", (obj) => {
+    return JSON.stringify(obj, null, 2);
+  });
+}
+function renderTemplate(templateString, context) {
+  try {
+    const template = Handlebars.compile(templateString);
+    return template(context);
+  } catch (error) {
+    console.error("\u274C Handlebars template error:", error);
+    throw error;
+  }
+}
+function buildWorktreeContext(worktree) {
+  return {
+    // Scoped entities (accessible as {{entity.property}})
+    worktree: {
+      unique_id: worktree.worktree_unique_id,
+      name: worktree.name,
+      path: worktree.path
+    },
+    repo: {
+      slug: worktree.repo_slug || ""
+    },
+    // User-defined custom context (accessible as {{custom.key}})
+    custom: worktree.custom_context || {}
+  };
+}
+export {
+  buildWorktreeContext,
+  registerHandlebarsHelpers,
+  renderTemplate
+};

package/dist/core/tools/claude/models.cjs

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tools/claude/models.ts
+var models_exports = {};
+__export(models_exports, {
+  AVAILABLE_CLAUDE_MODEL_ALIASES: () => AVAILABLE_CLAUDE_MODEL_ALIASES,
+  DEFAULT_CLAUDE_MODEL: () => DEFAULT_CLAUDE_MODEL
+});
+module.exports = __toCommonJS(models_exports);
+var AVAILABLE_CLAUDE_MODEL_ALIASES = [
+  {
+    id: "claude-opus-4-1",
+    displayName: "Claude Opus 4.1",
+    family: "claude-4",
+    description: "Most capable model (latest)"
+  },
+  {
+    id: "claude-sonnet-4-5",
+    displayName: "Claude Sonnet 4.5",
+    family: "claude-4",
+    description: "Best for coding (latest)"
+  },
+  {
+    id: "claude-sonnet-4-0",
+    displayName: "Claude Sonnet 4.0",
+    family: "claude-4",
+    description: "Sonnet 4.0 (previous)"
+  },
+  {
+    id: "claude-3-7-sonnet-latest",
+    displayName: "Claude 3.7 Sonnet",
+    family: "claude-3.7",
+    description: "Fast & balanced"
+  },
+  {
+    id: "claude-haiku-4-5",
+    displayName: "Claude Haiku 4.5",
+    family: "claude-4",
+    description: "Fastest (latest)"
+  },
+  {
+    id: "claude-3-5-haiku-latest",
+    displayName: "Claude 3.5 Haiku",
+    family: "claude-3.5",
+    description: "Fastest (previous)"
+  }
+];
+var DEFAULT_CLAUDE_MODEL = "claude-sonnet-4-5";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AVAILABLE_CLAUDE_MODEL_ALIASES,
+  DEFAULT_CLAUDE_MODEL
+});

package/dist/core/tools/claude/models.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Claude model metadata for UI display and selection
+ */
+interface ClaudeModel {
+    /** Model ID or alias (e.g., "claude-sonnet-4-5-latest" or "claude-sonnet-4-5-20250929") */
+    id: string;
+    /** Display name for UI (e.g., "Claude Sonnet 4.5") */
+    displayName: string;
+    /** Model family (e.g., "claude-4", "claude-3.5") */
+    family: string;
+    /** User-facing description */
+    description: string;
+}
+/**
+ * Available Claude model aliases (API-provided, auto-update to latest versions)
+ *
+ * Note: Anthropic's naming is inconsistent:
+ * - Newer models (Claude 4.x) use version-based aliases: claude-sonnet-4-5, claude-opus-4-1
+ * - Older models (Claude 3.x) use -latest suffix: claude-3-7-sonnet-latest
+ */
+declare const AVAILABLE_CLAUDE_MODEL_ALIASES: ClaudeModel[];
+/**
+ * Default Claude model for new sessions (uses Sonnet 4.5 for best coding performance)
+ */
+declare const DEFAULT_CLAUDE_MODEL = "claude-sonnet-4-5";
+
+export { AVAILABLE_CLAUDE_MODEL_ALIASES, type ClaudeModel, DEFAULT_CLAUDE_MODEL };

package/dist/core/tools/claude/models.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Claude model metadata for UI display and selection
+ */
+interface ClaudeModel {
+    /** Model ID or alias (e.g., "claude-sonnet-4-5-latest" or "claude-sonnet-4-5-20250929") */
+    id: string;
+    /** Display name for UI (e.g., "Claude Sonnet 4.5") */
+    displayName: string;
+    /** Model family (e.g., "claude-4", "claude-3.5") */
+    family: string;
+    /** User-facing description */
+    description: string;
+}
+/**
+ * Available Claude model aliases (API-provided, auto-update to latest versions)
+ *
+ * Note: Anthropic's naming is inconsistent:
+ * - Newer models (Claude 4.x) use version-based aliases: claude-sonnet-4-5, claude-opus-4-1
+ * - Older models (Claude 3.x) use -latest suffix: claude-3-7-sonnet-latest
+ */
+declare const AVAILABLE_CLAUDE_MODEL_ALIASES: ClaudeModel[];
+/**
+ * Default Claude model for new sessions (uses Sonnet 4.5 for best coding performance)
+ */
+declare const DEFAULT_CLAUDE_MODEL = "claude-sonnet-4-5";
+
+export { AVAILABLE_CLAUDE_MODEL_ALIASES, type ClaudeModel, DEFAULT_CLAUDE_MODEL };