agentlas 1.0.18 → 1.0.19

package/engine/bootstrap-schema.sql

@@ -1,6 +1,6 @@
--- Agentlas 첫 실행 부트스트랩 스키마 (생성: 2026-07-28T08:31:20Z)
--- 소스 DB user_version=81 — 앱이 나중에 설치되면 여기서부터 마이그레이션한다.
-PRAGMA user_version=81;
+-- Agentlas first-run bootstrap schema (project-first Work contract)
+-- Source DB user_version=85. Desktop remains the migration authority.
+PRAGMA user_version=85;
 CREATE TABLE active_runtime (
         id INTEGER PRIMARY KEY CHECK(id = 1),
         kind TEXT NOT NULL
@@ -21,11 +21,13 @@ CREATE TABLE projects (
         id TEXT PRIMARY KEY,
         name TEXT NOT NULL,
         description TEXT,
-        default_agent_id TEXT,
-        context_note TEXT,
+        system_prompt TEXT,
+        agent_pool_json TEXT NOT NULL DEFAULT '[]',
+        source_type TEXT NOT NULL DEFAULT 'local' CHECK(source_type IN ('local','github','sample')),
+        source_ref TEXT,
         created_at TEXT NOT NULL,
-        updated_at TEXT NOT NULL, folder_path TEXT,
-        FOREIGN KEY(default_agent_id) REFERENCES installed_agents(id) ON DELETE SET NULL
+        updated_at TEXT NOT NULL,
+        folder_path TEXT
       );
 CREATE TABLE chats (
         id TEXT PRIMARY KEY,
@@ -33,7 +35,7 @@ CREATE TABLE chats (
         agent_id TEXT NOT NULL,
         title TEXT NOT NULL DEFAULT '새 채팅',
         created_at TEXT NOT NULL,
-        updated_at TEXT NOT NULL, firm_id TEXT REFERENCES firms(id) ON DELETE SET NULL, archived_at TEXT, working_folder TEXT, kind TEXT NOT NULL DEFAULT 'user', parent_chat_id TEXT, used_at TEXT, agent_group_id TEXT REFERENCES agent_groups(id) ON DELETE SET NULL, continuous_mode INTEGER NOT NULL DEFAULT 0, swarm_mode INTEGER NOT NULL DEFAULT 0, last_viewed_at TEXT, hired_agents TEXT, origin_surface TEXT NOT NULL DEFAULT 'work', runtime_selection_json TEXT,
+        updated_at TEXT NOT NULL, firm_id TEXT REFERENCES firms(id) ON DELETE SET NULL, archived_at TEXT, working_folder TEXT, kind TEXT NOT NULL DEFAULT 'user', parent_chat_id TEXT, used_at TEXT, continuous_mode INTEGER NOT NULL DEFAULT 0, swarm_mode INTEGER NOT NULL DEFAULT 0, last_viewed_at TEXT, hired_agents TEXT, origin_surface TEXT NOT NULL DEFAULT 'work', runtime_selection_json TEXT,
         FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE SET NULL,
         FOREIGN KEY(agent_id) REFERENCES installed_agents(id) ON DELETE CASCADE
       );
@@ -116,8 +118,20 @@ CREATE TABLE automations (
         last_run_at TEXT,
         next_run_at TEXT,
         created_at TEXT NOT NULL
-      , graph_json TEXT, schedule_json TEXT, timezone TEXT, end_at TEXT, max_runs INTEGER, run_count INTEGER NOT NULL DEFAULT 0, trigger_type TEXT NOT NULL DEFAULT 'schedule', trigger_json TEXT, claimed_at TEXT, lease_owner TEXT, tool_mode TEXT NOT NULL DEFAULT 'auto', hub_mode TEXT NOT NULL DEFAULT 'hub-allowed', execution_permission TEXT NOT NULL DEFAULT 'write' CHECK(execution_permission IN ('read','write')), target_version TEXT, runtime_selection_json TEXT);
+      , graph_json TEXT, schedule_json TEXT, timezone TEXT, end_at TEXT, max_runs INTEGER, run_count INTEGER NOT NULL DEFAULT 0, trigger_type TEXT NOT NULL DEFAULT 'schedule', trigger_json TEXT, claimed_at TEXT, lease_owner TEXT, tool_mode TEXT NOT NULL DEFAULT 'auto', hub_mode TEXT NOT NULL DEFAULT 'hub-allowed', execution_permission TEXT NOT NULL DEFAULT 'write' CHECK(execution_permission IN ('read','write')), target_version TEXT, runtime_selection_json TEXT, project_id TEXT REFERENCES projects(id) ON DELETE SET NULL);
 CREATE INDEX idx_automations_due ON automations(enabled, next_run_at);
+CREATE TABLE automation_sessions (
+        id TEXT PRIMARY KEY,
+        automation_id TEXT NOT NULL,
+        target_kind TEXT NOT NULL CHECK(target_kind IN ('host','agent','firm','hub')),
+        target_id TEXT NOT NULL,
+        ledger_chat_id TEXT NOT NULL UNIQUE REFERENCES chats(id) ON DELETE CASCADE,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(automation_id, target_kind, target_id)
+      );
+CREATE INDEX idx_automation_sessions_owner
+        ON automation_sessions(automation_id, updated_at DESC);
 CREATE TABLE agent_apps (
         id TEXT PRIMARY KEY,
         chat_id TEXT NOT NULL,
@@ -379,18 +393,6 @@ CREATE INDEX idx_persona_loop_runs_updated
 CREATE INDEX idx_persona_loop_runs_automation
         ON persona_loop_runs(automation_id);
 CREATE INDEX idx_chats_used_updated ON chats(used_at, updated_at DESC);
-CREATE TABLE agent_groups (
-        id TEXT PRIMARY KEY,
-        name TEXT NOT NULL,
-        description TEXT NOT NULL DEFAULT '',
-        orchestrator_name TEXT NOT NULL,
-        members_json TEXT NOT NULL DEFAULT '[]',
-        created_at TEXT NOT NULL,
-        updated_at TEXT NOT NULL
-      );
-CREATE INDEX idx_agent_groups_updated
-        ON agent_groups(updated_at DESC);
-CREATE INDEX idx_chats_agent_group_updated ON chats(agent_group_id, updated_at DESC);
 CREATE TABLE run_history (
         id TEXT PRIMARY KEY,
         automation_id TEXT,

package/engine/commands/run.cjs

@@ -9,14 +9,13 @@
  *   --permission <level>  read | write | full
  * 프롬프트가 없고 stdin이 TTY가 아니면 stdin을 읽는다.
  *
- * 자동 라우팅(agents/router.cjs): 첫 토큰이 에이전트로 해석되지 않으면 호스트 LLM
- * 판정(resolveAutoRoute)이 최적 에이전트를 고른다 — 어휘 점수는 후보 모집 전용이다.
- * 판정 런타임이 없으면 기본 에이전트로 정직 폴백하되 note를 stderr에 반드시 출력한다
- * (조용한 오라우팅/폴백 금지 — 오너 결정).
+ * 첫 토큰이 정확한 에이전트이면 고급 직접 호출이다. 그 외 일반 실행은 현재 폴더에
+ * 연결된 Desktop Work 프로젝트의 첫 에이전트를 컨트롤러로 사용한다. 프로젝트나
+ * 컨트롤러가 불명확하면 다른 에이전트로 대체하지 않고 실행을 중단한다.
  * 런타임 사다리: 명시 핀 > 에이전트별 오버라이드(agent_runtime_overrides) >
  * model_roles[orchestrator] > active_runtime > detected (runtimes/overrides.cjs).
  */
-const { findAgent, listAgents } = require("../agents/registry.cjs");
+const { findAgent } = require("../agents/registry.cjs");
 const {
   resolveRuntimeForAgent,
   unavailableOverrideNote,
@@ -28,6 +27,7 @@ const permissions = require("../agentlas-permissions.cjs");
 const { EFFORTS, TIERS } = require("../agentlas-workload-routing.cjs");
 const { projectCwd } = require("../project/paths.cjs");
 const { ensureTerminalProjectForExecutionCli } = require("../project/state.cjs");
+const { resolveProjectController, withProjectControllerContext } = require("../project/controller.cjs");
 
 function readStdin() {
   return new Promise((resolve) => {
@@ -99,7 +99,23 @@ async function runOnce(ctx, args) {
     return 1;
   }
 
-  // 기본 런타임을 먼저 확정한다 — 판정 러너(자동 라우팅)도 이 런타임을 쓴다.
+  const cwd = projectCwd();
+  if (!agent) {
+    try {
+      const resolved = resolveProjectController(db, cwd);
+      agent = withProjectControllerContext(resolved.controller, resolved.project);
+      ctx.err(ctx.uiInstance.c.dim(
+        ctx.lang === "ko"
+          ? `프로젝트: ${resolved.project.name} · 컨트롤러: ${agent.name}`
+          : `Project: ${resolved.project.name} · Controller: ${agent.nameEn || agent.name}`,
+      ));
+    } catch (e) {
+      ctx.err(String((e && e.message) || e));
+      return 1;
+    }
+  }
+
+  // 프로젝트 컨트롤러 또는 명시 에이전트의 런타임을 확정한다.
   let runtime;
   try {
     runtime = resolveRuntimeForAgent({
@@ -109,6 +125,7 @@ async function runOnce(ctx, args) {
       model: parsed.model,
       effort: parsed.effort,
       role: "orchestrator",
+      agentId: agent.id,
     });
     if (parsed.tier) runtime.modelTier = parsed.tier;
   } catch (e) {
@@ -116,33 +133,6 @@ async function runOnce(ctx, args) {
     return 1;
   }
 
-  if (!agent) {
-    // 자동 라우팅 — 최종 픽은 호스트 LLM 판정. 판정 불가 시 기본 에이전트 정직 폴백 + note.
-    const router = require("../agents/router.cjs");
-    let choice = null;
-    try {
-      choice = await router.resolveAutoRoute(db, prompt, { lang: ctx.lang, runtime });
-    } catch (e) {
-      ctx.err(ctx.lang === "ko"
-        ? `자동 라우팅 실패(${(e && e.message) || e}) — 기본 에이전트로 실행합니다`
-        : `auto-routing failed (${(e && e.message) || e}) — running with the default agent`);
-    }
-    if (choice && choice.agent) {
-      agent = choice.agent;
-    } else {
-      const visible = listAgents(db);
-      agent = visible[0] || findAgent(db, "agentlas-orchestrator");
-      if (!agent) {
-        ctx.err(ctx.lang === "en" ? "no installed agent (agentlas search/install first)" : "설치된 에이전트가 없습니다 (agentlas search/install 먼저)");
-        return 1;
-      }
-      // 직답 판정 — 페르소나 오염 없이 기본 에이전트 챗으로, 플레인 프롬프트로 답한다.
-      if (choice && choice.direct) agent = { ...agent, systemPrompt: router.directSystemPrompt(ctx.lang) };
-    }
-    // 조용한 라우팅 금지 — 누가 왜 선택됐는지(또는 왜 판정을 못 했는지) 반드시 출력.
-    if (choice && choice.note) ctx.err(ctx.uiInstance.c.dim(choice.note));
-  }
-
   // 에이전트가 확정된 뒤 에이전트별 오버라이드를 포함한 전체 사다리를 다시 해석한다.
   // 명시 runtime/model/effort 핀은 항상 최상단이라 에이전트 기본값보다 우선한다.
   if (agent && agent.id) {
@@ -167,7 +157,6 @@ async function runOnce(ctx, args) {
   }
 
   const permission = permissions.normalize(parsed.permission || (ctx.prefs && ctx.prefs.permission) || "write");
-  const cwd = projectCwd();
   try {
     ensureTerminalProjectForExecutionCli(db, cwd, permission, "terminal-run");
   } catch (e) {

package/engine/project/controller.cjs

@@ -0,0 +1,113 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { listRoutableAgents } = require("../agents/registry.cjs");
+
+function canonicalPath(value) {
+  const resolved = path.resolve(String(value || ""));
+  try {
+    return fs.realpathSync.native(resolved);
+  } catch {
+    return resolved;
+  }
+}
+
+function pathContains(parent, child) {
+  const relative = path.relative(parent, child);
+  return relative === "" || (!relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative));
+}
+
+function projectColumns(db) {
+  try {
+    return new Set(db.prepare("PRAGMA table_info(projects)").all().map((row) => row.name));
+  } catch {
+    return new Set();
+  }
+}
+
+function parseAgentPool(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw || "[]");
+  } catch {
+    throw new Error("This project's agent team cannot be read. Open the project in Agentlas Desktop and save its team again.");
+  }
+  if (!Array.isArray(parsed)) {
+    throw new Error("This project's agent team cannot be read. Open the project in Agentlas Desktop and save its team again.");
+  }
+  return parsed.filter((member) => member && typeof member === "object"
+    && typeof member.agentId === "string" && member.agentId.trim()
+    && ["local", "cloud", "hub"].includes(member.source)
+    && typeof member.nameSnapshot === "string");
+}
+
+function resolveProjectForCwd(db, cwd) {
+  const columns = projectColumns(db);
+  if (!columns.has("folder_path") || !columns.has("agent_pool_json")) {
+    throw new Error("This Agentlas data store does not support project teams yet. Open the latest Agentlas Desktop once, then retry.");
+  }
+  const rows = db.prepare(
+    `SELECT id, name, system_prompt, agent_pool_json, source_type, source_ref, folder_path
+       FROM projects
+      WHERE folder_path IS NOT NULL AND trim(folder_path) <> ''`,
+  ).all();
+  const target = canonicalPath(cwd);
+  const matches = rows.map((row) => ({ row, root: canonicalPath(row.folder_path) }))
+    .filter(({ root }) => pathContains(root, target))
+    .sort((a, b) => b.root.length - a.root.length);
+  if (!matches.length) {
+    throw new Error("This folder is not connected to an Agentlas project. Connect it in Desktop Work, or pass an exact agent for an advanced direct invocation.");
+  }
+  const bestLength = matches[0].root.length;
+  const best = matches.filter((entry) => entry.root.length === bestLength);
+  if (best.length !== 1) {
+    throw new Error("More than one Agentlas project is connected to this folder. Keep one source connection, then retry.");
+  }
+  return { ...best[0].row, rootPath: best[0].root, agentPool: parseAgentPool(best[0].row.agent_pool_json) };
+}
+
+function resolveProjectController(db, cwd) {
+  const project = resolveProjectForCwd(db, cwd);
+  if (!project.agentPool.length) {
+    throw new Error("This project has no agent team. Drag agents into the project in Desktop Work, then retry.");
+  }
+  const controllerRef = project.agentPool[0];
+  if (controllerRef.source !== "local") {
+    throw new Error(`The project controller “${controllerRef.nameSnapshot}” is not installed locally for Terminal execution. Install that exact release locally or reorder the project team.`);
+  }
+  const controller = listRoutableAgents(db).find((agent) => agent.id === controllerRef.agentId) || null;
+  if (!controller) {
+    throw new Error(`The project controller “${controllerRef.nameSnapshot}” is unavailable. Restore that agent or explicitly choose a new first agent in Desktop Work.`);
+  }
+  return { project, controller };
+}
+
+function withProjectControllerContext(controller, project) {
+  const team = project.agentPool.map((member, index) =>
+    `${index + 1}. ${member.nameSnapshot} (${member.source}${member.releaseId ? `, exact release ${member.releaseId}` : ""})`,
+  ).join("\n");
+  const projectInstruction = String(project.system_prompt || "").trim();
+  const ownership = [
+    `You are the controller for the Agentlas Work project “${project.name}”.`,
+    "You own this task. The remaining ordered project members are eligible sub-agents for task-scoped WorkOrders only.",
+    "Do not transfer task ownership, silently substitute an unavailable member, or claim a sub-agent ran without an assignment and execution receipt.",
+    "Project team:",
+    team,
+  ].join("\n");
+  return {
+    ...controller,
+    systemPrompt: [controller.systemPrompt, projectInstruction && `Project system prompt:\n${projectInstruction}`, ownership]
+      .filter(Boolean)
+      .join("\n\n"),
+  };
+}
+
+module.exports = {
+  canonicalPath,
+  pathContains,
+  parseAgentPool,
+  resolveProjectForCwd,
+  resolveProjectController,
+  withProjectControllerContext,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "Agentlas agent terminal — chat with your installed AI agents and teams from the terminal, Claude Code style. Standalone: no desktop app required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"