@locusai/sdk 0.13.0 → 0.13.3

package/dist/agent/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IAgBV,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAG5C,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,aAAa,CAAgB;gBAEjB,MAAM,EAAE,YAAY;IAqDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAmB5D,eAAe;YAcf,WAAW;IAgDzB;;OAEG;YACW,WAAW;IAoCzB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAoBf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8I3B"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IAgBV,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAG5C,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,aAAa,CAAgB;gBAEjB,MAAM,EAAE,YAAY;IAqDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAmB5D,eAAe;YAcf,WAAW;IAgDzB;;OAEG;YACW,WAAW;IAoCzB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAoBf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4I3B"}

package/dist/agent/worker.js

@@ -391,6 +391,39 @@ var init_workspaces = __esm(() => {
   };
 });
 
+// src/discussion/discussion-types.ts
+var import_zod, DiscussionMessageSchema, DiscussionInsightSchema, DiscussionSchema;
+var init_discussion_types = __esm(() => {
+  import_zod = require("zod");
+  DiscussionMessageSchema = import_zod.z.object({
+    role: import_zod.z.enum(["user", "assistant"]),
+    content: import_zod.z.string(),
+    timestamp: import_zod.z.number()
+  });
+  DiscussionInsightSchema = import_zod.z.object({
+    id: import_zod.z.string(),
+    type: import_zod.z.enum(["decision", "requirement", "idea", "concern", "learning"]),
+    title: import_zod.z.string(),
+    content: import_zod.z.string(),
+    tags: import_zod.z.array(import_zod.z.string()).default([]),
+    createdAt: import_zod.z.string()
+  });
+  DiscussionSchema = import_zod.z.object({
+    id: import_zod.z.string(),
+    title: import_zod.z.string(),
+    topic: import_zod.z.string(),
+    status: import_zod.z.enum(["active", "completed", "archived"]).default("active"),
+    messages: import_zod.z.array(DiscussionMessageSchema).default([]),
+    insights: import_zod.z.array(DiscussionInsightSchema).default([]),
+    createdAt: import_zod.z.string(),
+    updatedAt: import_zod.z.string(),
+    metadata: import_zod.z.object({
+      model: import_zod.z.string(),
+      provider: import_zod.z.string()
+    })
+  });
+});
+
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
@@ -403,6 +436,9 @@ __export(exports_src, {
   LocusClient: () => LocusClient,
   InvitationsModule: () => InvitationsModule,
   DocsModule: () => DocsModule,
+  DiscussionSchema: () => DiscussionSchema,
+  DiscussionMessageSchema: () => DiscussionMessageSchema,
+  DiscussionInsightSchema: () => DiscussionInsightSchema,
   CiModule: () => CiModule,
   AuthModule: () => AuthModule
 });
@@ -508,6 +544,7 @@ var init_src = __esm(() => {
   init_sprints();
   init_tasks();
   init_workspaces();
+  init_discussion_types();
   import_axios = __toESM(require("axios"));
   init_events();
   init_auth();
@@ -521,6 +558,12 @@ var init_src = __esm(() => {
 });
 
 // src/core/config.ts
+function isValidModelForProvider(provider, model) {
+  return PROVIDER_MODELS[provider].includes(model);
+}
+function getModelsForProvider(provider) {
+  return PROVIDER_MODELS[provider];
+}
 function getLocusPath(projectPath, fileName) {
   return import_node_path.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG[fileName]);
 }
@@ -528,16 +571,36 @@ function getAgentArtifactsPath(projectPath, agentId) {
   const shortId = agentId.slice(-8);
   return import_node_path.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.artifactsDir, shortId);
 }
-var import_node_path, PROVIDER, DEFAULT_MODEL, LOCUS_SCHEMA_BASE_URL = "https://locusai.dev/schemas", LOCUS_SCHEMAS, LOCUS_CONFIG, LOCUS_GITIGNORE_PATTERNS;
+var import_node_path, PROVIDER, CLAUDE_MODELS, CODEX_MODELS, PROVIDER_MODELS, DEFAULT_MODEL, LOCUS_SCHEMA_BASE_URL = "https://locusai.dev/schemas", LOCUS_SCHEMAS, LOCUS_CONFIG, LOCUS_GITIGNORE_PATTERNS;
 var init_config = __esm(() => {
   import_node_path = require("node:path");
   PROVIDER = {
     CLAUDE: "claude",
     CODEX: "codex"
   };
+  CLAUDE_MODELS = {
+    OPUS: "opus",
+    SONNET: "sonnet",
+    HAIKU: "haiku",
+    OPUS_PLAN: "opusplan",
+    CLAUDE_OPUS_4_6: "claude-opus-4-6",
+    CLAUDE_SONNET_4_5: "claude-sonnet-4-5-20250929",
+    CLAUDE_SONNET_4_6: "claude-sonnet-4-6",
+    CLAUDE_HAIKU_4_5: "claude-haiku-4-5-20251001"
+  };
+  CODEX_MODELS = {
+    GPT_5_3_CODEX: "gpt-5.3-codex",
+    GPT_5_3_CODEX_SPARK: "gpt-5.3-codex-spark",
+    GPT_5_CODEX_MINI: "gpt-5-codex-mini",
+    GPT_5_2_CODEX: "gpt-5.2-codex"
+  };
+  PROVIDER_MODELS = {
+    [PROVIDER.CLAUDE]: Object.values(CLAUDE_MODELS),
+    [PROVIDER.CODEX]: Object.values(CODEX_MODELS)
+  };
   DEFAULT_MODEL = {
-    [PROVIDER.CLAUDE]: "opus",
-    [PROVIDER.CODEX]: "gpt-5.3-codex"
+    [PROVIDER.CLAUDE]: CLAUDE_MODELS.OPUS,
+    [PROVIDER.CODEX]: CODEX_MODELS.GPT_5_3_CODEX
   };
   LOCUS_SCHEMAS = {
     config: `${LOCUS_SCHEMA_BASE_URL}/config.schema.json`,
@@ -554,7 +617,8 @@ var init_config = __esm(() => {
     documentsDir: "documents",
     sessionsDir: "sessions",
     reviewsDir: "reviews",
-    plansDir: "plans"
+    plansDir: "plans",
+    discussionsDir: "discussions"
   };
   LOCUS_GITIGNORE_PATTERNS = [
     "# Locus AI - Session data (user-specific, can grow large)",
@@ -569,6 +633,9 @@ var init_config = __esm(() => {
     "# Locus AI - Plans (generated per task)",
     ".locus/plans/",
     "",
+    "# Locus AI - Discussions (AI discussion sessions)",
+    ".locus/discussions/",
+    "",
     "# Locus AI - Settings (contains API key, telegram config, etc.)",
     ".locus/settings.json",
     "",
@@ -1517,6 +1584,10 @@ var init_codex_runner = __esm(() => {
 function createAiRunner(provider, config) {
   const resolvedProvider = provider ?? PROVIDER.CLAUDE;
   const model = config.model ?? DEFAULT_MODEL[resolvedProvider];
+  if (!isValidModelForProvider(resolvedProvider, model)) {
+    const validModels = getModelsForProvider(resolvedProvider);
+    throw new Error(`Model "${model}" is not valid for provider "${resolvedProvider}". ` + `Valid models: ${validModels.join(", ")}`);
+  }
   switch (resolvedProvider) {
     case PROVIDER.CODEX:
       return new CodexRunner(config.projectPath, model, config.log, config.reasoningEffort ?? "high", config.timeoutMs);
@@ -1871,6 +1942,187 @@ var init_git_workflow = __esm(() => {
   import_node_child_process4 = require("node:child_process");
 });
 
+// src/discussion/discussion-manager.ts
+class DiscussionManager {
+  discussionsDir;
+  constructor(projectPath) {
+    this.discussionsDir = getLocusPath(projectPath, "discussionsDir");
+  }
+  create(topic, model, provider) {
+    this.ensureDir();
+    const now = new Date().toISOString();
+    const id = `disc-${Date.now()}`;
+    const discussion = {
+      id,
+      title: topic,
+      topic,
+      status: "active",
+      messages: [],
+      insights: [],
+      createdAt: now,
+      updatedAt: now,
+      metadata: { model, provider }
+    };
+    this.save(discussion);
+    return discussion;
+  }
+  save(discussion) {
+    this.ensureDir();
+    const jsonPath = import_node_path5.join(this.discussionsDir, `${discussion.id}.json`);
+    const mdPath = import_node_path5.join(this.discussionsDir, `summary-${discussion.id}.md`);
+    import_node_fs3.writeFileSync(jsonPath, JSON.stringify(discussion, null, 2), "utf-8");
+    import_node_fs3.writeFileSync(mdPath, this.toMarkdown(discussion), "utf-8");
+  }
+  load(id) {
+    this.ensureDir();
+    const filePath = import_node_path5.join(this.discussionsDir, `${id}.json`);
+    if (!import_node_fs3.existsSync(filePath)) {
+      return null;
+    }
+    try {
+      return JSON.parse(import_node_fs3.readFileSync(filePath, "utf-8"));
+    } catch {
+      return null;
+    }
+  }
+  list(status) {
+    this.ensureDir();
+    const files = import_node_fs3.readdirSync(this.discussionsDir).filter((f) => f.endsWith(".json"));
+    const discussions = [];
+    for (const file of files) {
+      try {
+        const discussion = JSON.parse(import_node_fs3.readFileSync(import_node_path5.join(this.discussionsDir, file), "utf-8"));
+        if (!status || discussion.status === status) {
+          discussions.push(discussion);
+        }
+      } catch {}
+    }
+    discussions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return discussions;
+  }
+  complete(id) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.status = "completed";
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  archive(id) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.status = "archived";
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+  }
+  delete(id) {
+    this.ensureDir();
+    const jsonPath = import_node_path5.join(this.discussionsDir, `${id}.json`);
+    const mdPath = import_node_path5.join(this.discussionsDir, `summary-${id}.md`);
+    if (import_node_fs3.existsSync(jsonPath)) {
+      import_node_fs3.unlinkSync(jsonPath);
+    }
+    if (import_node_fs3.existsSync(mdPath)) {
+      import_node_fs3.unlinkSync(mdPath);
+    }
+  }
+  addMessage(id, role, content) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.messages.push({
+      role,
+      content,
+      timestamp: Date.now()
+    });
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  addInsight(id, insight) {
+    const discussion = this.load(id);
+    if (!discussion) {
+      throw new Error(`Discussion not found: ${id}`);
+    }
+    discussion.insights.push(insight);
+    discussion.updatedAt = new Date().toISOString();
+    this.save(discussion);
+    return discussion;
+  }
+  getAllInsights() {
+    const discussions = this.list("completed");
+    const insights = [];
+    for (const discussion of discussions) {
+      insights.push(...discussion.insights);
+    }
+    insights.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return insights;
+  }
+  getMarkdown(id) {
+    const discussion = this.load(id);
+    if (!discussion)
+      return null;
+    return this.toMarkdown(discussion);
+  }
+  toMarkdown(discussion) {
+    const lines = [];
+    lines.push(`# Discussion: ${discussion.title}`);
+    lines.push("");
+    lines.push(`**Status:** ${discussion.status.toUpperCase()}`);
+    lines.push(`**Topic:** ${discussion.topic}`);
+    lines.push(`**Created:** ${discussion.createdAt}`);
+    lines.push(`**Updated:** ${discussion.updatedAt}`);
+    lines.push(`**Model:** ${discussion.metadata.model} (${discussion.metadata.provider})`);
+    lines.push("");
+    if (discussion.messages.length > 0) {
+      lines.push(`## Messages (${discussion.messages.length})`);
+      lines.push("");
+      for (const msg of discussion.messages) {
+        const time = new Date(msg.timestamp).toISOString();
+        const roleLabel = msg.role === "user" ? "User" : "Assistant";
+        lines.push(`### ${roleLabel} — ${time}`);
+        lines.push("");
+        lines.push(msg.content);
+        lines.push("");
+      }
+    }
+    if (discussion.insights.length > 0) {
+      lines.push(`## Insights (${discussion.insights.length})`);
+      lines.push("");
+      for (const insight of discussion.insights) {
+        lines.push(`### [${insight.type.toUpperCase()}] ${insight.title}`);
+        lines.push("");
+        lines.push(insight.content);
+        if (insight.tags.length > 0) {
+          lines.push("");
+          lines.push(`**Tags:** ${insight.tags.join(", ")}`);
+        }
+        lines.push("");
+      }
+    }
+    lines.push("---");
+    lines.push(`*Discussion ID: ${discussion.id}*`);
+    return lines.join(`
+`);
+  }
+  ensureDir() {
+    if (!import_node_fs3.existsSync(this.discussionsDir)) {
+      import_node_fs3.mkdirSync(this.discussionsDir, { recursive: true });
+    }
+  }
+}
+var import_node_fs3, import_node_path5;
+var init_discussion_manager = __esm(() => {
+  init_config();
+  import_node_fs3 = require("node:fs");
+  import_node_path5 = require("node:path");
+});
+
 // src/core/prompt-builder.ts
 class PromptBuilder {
   projectPath;
@@ -1909,6 +2161,15 @@ ${knowledgeBase}
 These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
 ${learnings}
 </learnings>
+`;
+    }
+    const discussionInsights = this.getDiscussionInsightsContent();
+    if (discussionInsights) {
+      sections += `
+<discussion_insights>
+These are key decisions and insights from product discussions. Follow them to maintain product coherence:
+${discussionInsights}
+</discussion_insights>
 `;
     }
     if (task.docs && task.docs.length > 0) {
@@ -1997,6 +2258,15 @@ ${knowledgeBase}
 These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
 ${learnings}
 </learnings>
+`;
+    }
+    const discussionInsights = this.getDiscussionInsightsContent();
+    if (discussionInsights) {
+      sections += `
+<discussion_insights>
+These are key decisions and insights from product discussions. Follow them to maintain product coherence:
+${discussionInsights}
+</discussion_insights>
 `;
     }
     return `<direct_execution>
@@ -2011,9 +2281,9 @@ ${sections}
   }
   getProjectContext() {
     const contextPath = getLocusPath(this.projectPath, "contextFile");
-    if (import_node_fs3.existsSync(contextPath)) {
+    if (import_node_fs4.existsSync(contextPath)) {
       try {
-        const context = import_node_fs3.readFileSync(contextPath, "utf-8");
+        const context = import_node_fs4.readFileSync(contextPath, "utf-8");
         if (context.trim().length > 20) {
           return context;
         }
@@ -2024,10 +2294,10 @@ ${sections}
     return this.getFallbackContext() || null;
   }
   getFallbackContext() {
-    const readmePath = import_node_path5.join(this.projectPath, "README.md");
-    if (import_node_fs3.existsSync(readmePath)) {
+    const readmePath = import_node_path6.join(this.projectPath, "README.md");
+    if (import_node_fs4.existsSync(readmePath)) {
       try {
-        const content = import_node_fs3.readFileSync(readmePath, "utf-8");
+        const content = import_node_fs4.readFileSync(readmePath, "utf-8");
         const limit = 1000;
         return content.slice(0, limit) + (content.length > limit ? `
 ...(truncated)...` : "");
@@ -2041,15 +2311,16 @@ ${sections}
     return `You have access to the following documentation directories for context:
 - Artifacts: \`.locus/artifacts\` (local-only, not synced to cloud)
 - Documents: \`.locus/documents\` (synced from cloud)
+- Discussions: \`.locus/discussions\` (product discussion insights and decisions)
 If you need more information about the project strategies, plans, or architecture, read files in these directories.`;
   }
   getLearningsContent() {
     const learningsPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!import_node_fs3.existsSync(learningsPath)) {
+    if (!import_node_fs4.existsSync(learningsPath)) {
       return null;
     }
     try {
-      const content = import_node_fs3.readFileSync(learningsPath, "utf-8");
+      const content = import_node_fs4.readFileSync(learningsPath, "utf-8");
       const lines = content.split(`
 `).filter((l) => l.startsWith("- "));
       if (lines.length === 0) {
@@ -2061,6 +2332,53 @@ If you need more information about the project strategies, plans, or architectur
       return null;
     }
   }
+  getDiscussionInsightsContent() {
+    try {
+      const manager = new DiscussionManager(this.projectPath);
+      const insights = manager.getAllInsights();
+      if (insights.length === 0) {
+        return null;
+      }
+      const groups = {};
+      for (const insight of insights) {
+        const key = insight.type;
+        if (!groups[key]) {
+          groups[key] = [];
+        }
+        groups[key].push(insight);
+      }
+      const typeLabels = {
+        decision: "Decisions",
+        requirement: "Requirements",
+        idea: "Ideas",
+        concern: "Concerns",
+        learning: "Learnings"
+      };
+      let output = "";
+      for (const [type, label] of Object.entries(typeLabels)) {
+        const items = groups[type];
+        if (!items || items.length === 0)
+          continue;
+        output += `## ${label}
+`;
+        for (const item of items) {
+          output += `- [${item.title}]: ${item.content}
+`;
+        }
+        output += `
+`;
+      }
+      if (output.length === 0) {
+        return null;
+      }
+      if (output.length > 2000) {
+        output = `${output.slice(0, 1997)}...`;
+      }
+      return output.trimEnd();
+    } catch {
+      return null;
+    }
+  }
   roleToText(role) {
     if (!role) {
       return null;
@@ -2081,11 +2399,12 @@ If you need more information about the project strategies, plans, or architectur
     }
   }
 }
-var import_node_fs3, import_node_path5, import_shared2;
+var import_node_fs4, import_node_path6, import_shared2;
 var init_prompt_builder = __esm(() => {
+  init_discussion_manager();
   init_config();
-  import_node_fs3 = require("node:fs");
-  import_node_path5 = require("node:path");
+  import_node_fs4 = require("node:fs");
+  import_node_path6 = require("node:path");
   import_shared2 = require("@locusai/shared");
 });
 
@@ -2408,7 +2727,6 @@ Branch: \`${result.branch}\`` : "";
       this.log("All tasks done. Creating pull request...", "info");
       const prResult = this.gitWorkflow.createPullRequest(this.completedTaskList, this.taskSummaries);
       if (prResult.url) {
-        this.log(`PR created: ${prResult.url}`, "success");
         for (const task of this.completedTaskList) {
           try {
             await this.client.tasks.update(task.id, this.config.workspaceId, {

package/dist/ai/__tests__/factory.test.d.ts

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

package/dist/ai/__tests__/factory.test.d.ts.map

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

package/dist/ai/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/ai/factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;AAEV,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,MAAM,EAAE,cAAc,GACrB,QAAQ,CAqBV"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/ai/factory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;AAEV,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,MAAM,EAAE,cAAc,GACrB,QAAQ,CA8BV"}

package/dist/core/config.d.ts

@@ -3,7 +3,29 @@ export declare const PROVIDER: {
     readonly CODEX: "codex";
 };
 export type Provider = (typeof PROVIDER)[keyof typeof PROVIDER];
-export declare const DEFAULT_MODEL: Record<Provider, string>;
+export declare const CLAUDE_MODELS: {
+    readonly OPUS: "opus";
+    readonly SONNET: "sonnet";
+    readonly HAIKU: "haiku";
+    readonly OPUS_PLAN: "opusplan";
+    readonly CLAUDE_OPUS_4_6: "claude-opus-4-6";
+    readonly CLAUDE_SONNET_4_5: "claude-sonnet-4-5-20250929";
+    readonly CLAUDE_SONNET_4_6: "claude-sonnet-4-6";
+    readonly CLAUDE_HAIKU_4_5: "claude-haiku-4-5-20251001";
+};
+export type ClaudeModel = (typeof CLAUDE_MODELS)[keyof typeof CLAUDE_MODELS];
+export declare const CODEX_MODELS: {
+    readonly GPT_5_3_CODEX: "gpt-5.3-codex";
+    readonly GPT_5_3_CODEX_SPARK: "gpt-5.3-codex-spark";
+    readonly GPT_5_CODEX_MINI: "gpt-5-codex-mini";
+    readonly GPT_5_2_CODEX: "gpt-5.2-codex";
+};
+export type CodexModel = (typeof CODEX_MODELS)[keyof typeof CODEX_MODELS];
+export type ModelId = ClaudeModel | CodexModel;
+export declare const PROVIDER_MODELS: Record<Provider, readonly ModelId[]>;
+export declare const DEFAULT_MODEL: Record<Provider, ModelId>;
+export declare function isValidModelForProvider(provider: Provider, model: string): boolean;
+export declare function getModelsForProvider(provider: Provider): readonly ModelId[];
 export declare const LOCUS_SCHEMA_BASE_URL = "https://locusai.dev/schemas";
 export declare const LOCUS_SCHEMAS: {
     readonly config: "https://locusai.dev/schemas/config.schema.json";
@@ -21,8 +43,9 @@ export declare const LOCUS_CONFIG: {
     sessionsDir: string;
     reviewsDir: string;
     plansDir: string;
+    discussionsDir: string;
 };
-export declare const LOCUS_GITIGNORE_PATTERNS: readonly ["# Locus AI - Session data (user-specific, can grow large)", ".locus/sessions/", "", "# Locus AI - Artifacts (local-only, user-specific)", ".locus/artifacts/", "", "# Locus AI - Review reports (generated per sprint)", ".locus/reviews/", "", "# Locus AI - Plans (generated per task)", ".locus/plans/", "", "# Locus AI - Settings (contains API key, telegram config, etc.)", ".locus/settings.json", "", "# Locus AI - Configuration (contains project context, etc.)", ".locus/config.json"];
+export declare const LOCUS_GITIGNORE_PATTERNS: readonly ["# Locus AI - Session data (user-specific, can grow large)", ".locus/sessions/", "", "# Locus AI - Artifacts (local-only, user-specific)", ".locus/artifacts/", "", "# Locus AI - Review reports (generated per sprint)", ".locus/reviews/", "", "# Locus AI - Plans (generated per task)", ".locus/plans/", "", "# Locus AI - Discussions (AI discussion sessions)", ".locus/discussions/", "", "# Locus AI - Settings (contains API key, telegram config, etc.)", ".locus/settings.json", "", "# Locus AI - Configuration (contains project context, etc.)", ".locus/config.json"];
 export declare function getLocusPath(projectPath: string, fileName: keyof typeof LOCUS_CONFIG): string;
 /**
  * Gets the artifacts directory path for a specific agent.

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAGlD,CAAC;AAEF,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAEnE,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;CAYxB,CAAC;AAIF,eAAO,MAAM,wBAAwB,gfAkB3B,CAAC;AAEX,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,YAAY,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAGvD,CAAC;AAEX,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAGnD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,OAAO,EAAE,CAE3E;AAED,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAEnE,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAaxB,CAAC;AAIF,eAAO,MAAM,wBAAwB,gkBAqB3B,CAAC;AAEX,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,YAAY,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-export { DEFAULT_MODEL, getAgentArtifactsPath, getLocusPath, LOCUS_CONFIG, LOCUS_GITIGNORE_PATTERNS, LOCUS_SCHEMA_BASE_URL, LOCUS_SCHEMAS, PROVIDER, type Provider, } from "./config.js";
+export { CLAUDE_MODELS, type ClaudeModel, CODEX_MODELS, type CodexModel, DEFAULT_MODEL, getAgentArtifactsPath, getLocusPath, getModelsForProvider, isValidModelForProvider, LOCUS_CONFIG, LOCUS_GITIGNORE_PATTERNS, LOCUS_SCHEMA_BASE_URL, LOCUS_SCHEMAS, type ModelId, PROVIDER, PROVIDER_MODELS, type Provider, } from "./config.js";
 export { type CodebaseIndex, CodebaseIndexer } from "./indexer.js";
 export { PromptBuilder } from "./prompt-builder.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,YAAY,EACZ,KAAK,UAAU,EACf,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,KAAK,OAAO,EACZ,QAAQ,EACR,eAAe,EACf,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/prompt-builder.d.ts

@@ -8,6 +8,7 @@ export declare class PromptBuilder {
     private getFallbackContext;
     private getKnowledgeBaseSection;
     private getLearningsContent;
+    private getDiscussionInsightsContent;
     roleToText(role: Task["assigneeRole"]): string | null;
 }
 //# sourceMappingURL=prompt-builder.d.ts.map

package/dist/core/prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/core/prompt-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGrD,qBAAa,aAAa;IACZ,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEjC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAiFlC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BxD,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,mBAAmB;IAiB3B,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,GAAG,IAAI;CAoBtD"}
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/core/prompt-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKrD,qBAAa,aAAa;IACZ,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEjC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAuFlC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCxD,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,4BAA4B;IAqDpC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,GAAG,IAAI;CAoBtD"}

package/dist/discussion/agents/facilitator-prompt.d.ts

@@ -0,0 +1,13 @@
+import type { DiscussionInsight, DiscussionMessage } from "../discussion-types.js";
+export interface FacilitatorPromptInput {
+    topic: string;
+    projectContext: string | null;
+    learnings: string | null;
+    knowledgeBase: string;
+    previousMessages: DiscussionMessage[];
+    insights: DiscussionInsight[];
+    isFirstMessage: boolean;
+}
+export declare function buildFacilitatorPrompt(input: FacilitatorPromptInput): string;
+export declare function buildSummaryPrompt(topic: string, messages: DiscussionMessage[], insights: DiscussionInsight[]): string;
+//# sourceMappingURL=facilitator-prompt.d.ts.map

package/dist/discussion/agents/facilitator-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator-prompt.d.ts","sourceRoot":"","sources":["../../../src/discussion/agents/facilitator-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAwF5E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,MAAM,CAwCR"}

package/dist/discussion/discussion-facilitator.d.ts

@@ -0,0 +1,67 @@
+import type { LogFn } from "../ai/factory.js";
+import type { AiRunner } from "../ai/runner.js";
+import { Provider } from "../core/config.js";
+import type { StreamChunk } from "../exec/types.js";
+import type { DiscussionManager } from "./discussion-manager.js";
+import type { Discussion, DiscussionInsight } from "./discussion-types.js";
+export interface DiscussionFacilitatorConfig {
+    projectPath: string;
+    aiRunner: AiRunner;
+    discussionManager: DiscussionManager;
+    log?: LogFn;
+    provider: Provider;
+    model: string;
+}
+export interface StartDiscussionResult {
+    discussion: Discussion;
+    message: string;
+}
+export interface ContinueDiscussionResult {
+    response: string;
+    insights: DiscussionInsight[];
+}
+export declare class DiscussionFacilitator {
+    private projectPath;
+    private aiRunner;
+    private discussionManager;
+    private log;
+    private provider;
+    private model;
+    constructor(config: DiscussionFacilitatorConfig);
+    /**
+     * Start a new discussion on a topic. Creates the discussion,
+     * generates the AI's opening question, and saves it.
+     */
+    startDiscussion(topic: string): Promise<StartDiscussionResult>;
+    /**
+     * Continue a discussion with a user message. Runs the AI to generate
+     * a response, extracts insights, and saves everything.
+     * Non-streaming path for Telegram and other non-interactive consumers.
+     */
+    continueDiscussion(discussionId: string, userMessage: string): Promise<ContinueDiscussionResult>;
+    /**
+     * Continue a discussion with streaming support for CLI consumption.
+     * Yields stream chunks in real-time and returns the final result.
+     */
+    continueDiscussionStream(discussionId: string, userMessage: string): AsyncGenerator<StreamChunk, ContinueDiscussionResult, unknown>;
+    /**
+     * Generate a final summary of the discussion, save it as the last
+     * assistant message, and mark the discussion as completed.
+     */
+    summarizeDiscussion(discussionId: string): Promise<string>;
+    /**
+     * Extract <insight>...</insight> XML blocks from the AI response.
+     * Returns the cleaned response text (with insight tags removed) and
+     * the parsed insight objects.
+     */
+    private parseInsights;
+    /**
+     * Build context from project files (LOCUS.md, LEARNINGS.md).
+     * Reuses the same logic as PromptBuilder.
+     */
+    private buildContext;
+    private getProjectContext;
+    private getLearningsContent;
+    private getKnowledgeBaseSection;
+}
+//# sourceMappingURL=discussion-facilitator.d.ts.map

package/dist/discussion/discussion-facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussion-facilitator.d.ts","sourceRoot":"","sources":["../../src/discussion/discussion-facilitator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAgB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,2BAA2B;IAS/C;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6CpE;;;;OAIG;IACG,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,CAAC;IAsCpC;;;OAGG;IACI,wBAAwB,CAC7B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,cAAc,CAAC,WAAW,EAAE,wBAAwB,EAAE,OAAO,CAAC;IAkDjE;;;OAGG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBhE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAyCrB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,uBAAuB;CAMhC"}