agentlas 0.4.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend, and
+      hold each Contributor harmless for any liability incurred by, or
+      claims asserted against, such Contributor by reason of your accepting
+      any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Agentlas
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,107 @@
+# agentlas
+
+**The Agentlas agent terminal.** Chat with your installed AI agents and teams
+from the terminal — Claude Code style. Standalone: no desktop app required.
+
+```sh
+npm install -g agentlas
+agentlas
+```
+
+Type a task and it auto-routes to the right agent. Your model, your choice:
+Claude Code / Codex / Gemini CLI subscriptions or BYOK API keys.
+
+---
+
+**Agentlas 터미널 CLI** — Claude Code(`claude`), Codex(`codex`)처럼
+`npm install` 하나로 깔리고, `agentlas` 하나로 도는 독립 에이전트 터미널.
+**데스크탑 앱이 없어도 동작한다.**
+
+- 엔진(대화형 REPL·에이전트 라우팅·팀 실행·클라우드 설치·자격증명 관리)이
+  패키지에 통째로 번들되어 있다.
+- 첫 실행 시 앱과 동일한 SQLite 스키마를 직접 부트스트랩하고 빌트인
+  에이전트(오케스트레이터·PM 소울·메모리 큐레이터 등)를 시드한다.
+- 데스크탑 앱이 설치돼 있으면 같은 데이터(에이전트·채팅·키체인)를 자동
+  공유한다 — 앱에서 설치한 에이전트가 터미널에 바로 보인다.
+
+## 설치
+
+```sh
+npm install -g agentlas
+# 또는 이 폴더에서: npm install -g .
+# 또는: sh install.sh              # ~/.local/bin/agentlas 심링크 (sudo 불필요)
+```
+
+Windows(미검증): `powershell -ExecutionPolicy Bypass -File install.ps1`
+
+요구사항: Node 20+ (better-sqlite3 빌드 실패 시 Node 22+의 `node:sqlite` 폴백).
+에이전트 실행에는 claude / codex / gemini 중 하나의 CLI가 필요하다(BYOK API 키도 가능).
+
+## 사용
+
+```sh
+agentlas                           # 대화형 TUI (온보딩 → 에이전트 피커 → 스트리밍 REPL)
+agentlas list                      # 설치된 에이전트/회사 + 활성 런타임
+agentlas <agent>                   # 해당 에이전트와 대화형 세션
+agentlas run <agent> "프롬프트"     # 1회 실행 (prompt 없으면 stdin)
+agentlas firm <firm> "프롬프트"     # 회사(팀) 실행
+agentlas cd <agent>                # 에이전트 폴더 경로 → cd "$(agentlas cd seo)" && claude
+agentlas import <폴더>             # 로컬 에이전트/팀 임포트
+agentlas storm "목표"               # Stormbreaker 파이프라인 (라우팅→검증→실행) [--research]
+agentlas swarm "목표"               # emergent 에이전트 스웜 (병렬+블랙보드+종합) [--parallel N]
+agentlas login | logout | whoami   # Agentlas Cloud 로그인 (브라우저 플로우)
+agentlas automation list|add|on|off|remove|runs   # 자동화 등록/관리
+agentlas automation run <id>       # 자동화 지금 1회 실행
+agentlas automation daemon         # 상주 실행기 — 앱 없이 예약 자동화 실행 (앱과 리스 공유)
+agentlas cloud search "찾는 일"     # 마켓플레이스 검색 (로그인 불필요)
+agentlas cloud install <slug>      # 마켓플레이스에서 에이전트 설치
+agentlas usage                     # 로컬 사용 현황 (실행/메시지/자동화)
+agentlas telegram                  # 텔레그램 바인딩 현황 (읽기 전용)
+agentlas creds / env               # 자격증명 · env
+agentlas multimodal                # 이미지/영상/음성 provider
+agentlas doctor                    # 런타임/데이터 점검
+agentlas setup                     # 온보딩(언어→런타임→권한) 다시 실행
+agentlas update                    # Desktop 최신 릴리스 확인/설치
+```
+
+공통 옵션: `--runtime claude-code|codex|gemini` · `--permission read|write|full`
+
+## 동작 방식
+
+런처(`bin/agentlas.cjs`)가 이 패키지의 `engine/`(정본)을 시스템 Node로 실행한다 —
+데스크탑 앱과 완전히 독립이며, 앱이 설치돼 있으면 같은 userData(SQLite)를 써서
+데이터만 자연스럽게 공유된다. `engine/ENGINE_META.json`에 최초 임포트 출처가 기록돼 있다.
+
+SQLite는 `better-sqlite3`(optionalDependency, npm이 네이티브 빌드) → 실패 시
+Node 22+ `node:sqlite` 폴백. 데이터 폴더는 앱과 동일한 userData
+(macOS `~/Library/Application Support/Agentlas`)이며 `AGENTLAS_USER_DATA_DIR`로
+바꿀 수 있다.
+
+### 개발
+
+엔진 소스는 `engine/*.cjs` — 여기가 정본이므로 직접 수정한다.
+첫 실행용 스키마가 데스크탑 DB 마이그레이션과 어긋나면 재생성:
+
+```sh
+sh scripts/gen-bootstrap-schema.sh [db-path]       # engine/bootstrap-schema.sql 재생성
+```
+
+### 진단
+
+```sh
+agentlas --where                   # 엔진/DB 해석 결과 JSON
+sh test/smoke.sh                   # where/version/list/doctor + 신선 환경 첫 실행
+```
+
+## 제거
+
+```sh
+npm uninstall -g agentlas            # npm 설치 시
+rm ~/.local/bin/agentlas             # install.sh 설치 시
+```
+
+## License
+
+Apache-2.0 — engine sources are vendored from the public
+[agentlas-ai/agentlas-desktop](https://github.com/agentlas-ai/agentlas-desktop) repo
+(see `engine/ENGINE_META.json` for the exact version/commit).

package/bin/agentlas.cjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+/*
+ * agentlas — Agentlas를 터미널에서 쓰는 독립 CLI (Claude Code 방식).
+ *
+ * `npm install -g agentlas` 후 `agentlas` 하나로 완결된다. 데스크탑 앱은 필요 없다:
+ * 엔진(engine/agentlas.cjs — REPL·라우팅·클라우드·자격증명 포함 전체 터미널
+ * 클라이언트)이 이 패키지에 들어 있고(정본), 첫 실행 시 앱과 동일한 SQLite 스키마를
+ * 직접 부트스트랩한 뒤 빌트인 에이전트를 시드한다. 데스크탑 앱이 설치돼 있으면
+ * 같은 userData(SQLite)를 자동으로 공유한다 — 별도 설정 없이 데이터가 한 몸이다.
+ *
+ * SQLite: better-sqlite3(optionalDependency, npm이 빌드해주면 네이티브) →
+ * 실패 시 Node 22+의 node:sqlite 폴백.
+ *
+ * env 오버라이드:
+ *   AGENTLAS_USER_DATA_DIR 데이터 폴더 (기본: 앱과 동일한 userData)
+ *
+ * 런처 자체 명령: `agentlas --where` → 해석 결과 JSON 출력 후 종료.
+ */
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawn } = require("node:child_process");
+
+const REAL_SELF = (() => {
+  try { return fs.realpathSync(__filename); } catch { return __filename; }
+})();
+const PKG_ROOT = path.dirname(path.dirname(REAL_SELF));
+const ENGINE = path.join(PKG_ROOT, "engine", "agentlas.cjs");
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+// ── userData / DB 경로 (engine/agentlas.cjs의 userDataDir와 동일 규칙) ──
+function userDataDir() {
+  const override = process.env.AGENTLAS_USER_DATA_DIR;
+  if (override) return override;
+  const home = os.homedir();
+  if (process.platform === "darwin") return path.join(home, "Library", "Application Support", "Agentlas");
+  if (process.platform === "win32") return path.join(process.env.APPDATA || path.join(home, "AppData", "Roaming"), "Agentlas");
+  return path.join(process.env.XDG_CONFIG_HOME || path.join(home, ".config"), "Agentlas");
+}
+
+function dbPath() {
+  return path.join(userDataDir(), "agentlas.sqlite");
+}
+
+// ── SQLite 로더 (부트스트랩용): better-sqlite3 → node:sqlite ──
+// require.resolve가 아니라 실제 로드로 판별한다 — ABI가 깨진 better-sqlite3나
+// node:sqlite가 아직 없는/플래그가 필요한 Node(≤22.4 등)를 정확히 걸러낸다.
+function probeSqliteDriver() {
+  try { require("better-sqlite3"); return "better-sqlite3"; } catch { /* absent or ABI-broken */ }
+  try {
+    const { DatabaseSync } = require("node:sqlite");
+    if (DatabaseSync) return "node:sqlite";
+  } catch { /* not available without a flag on this Node */ }
+  return null;
+}
+
+function openSqlite(p) {
+  try {
+    const Database = require("better-sqlite3");
+    const db = new Database(p);
+    return { exec: (sql) => db.exec(sql), close: () => db.close(), driver: "better-sqlite3" };
+  } catch { /* optional dep 미설치/ABI 불일치 */ }
+  const major = Number(process.versions.node.split(".")[0]);
+  if (major < 22) {
+    throw new Error(`Node ${process.version} — better-sqlite3가 없으면 Node 22+ (node:sqlite)가 필요합니다.`);
+  }
+  const { DatabaseSync } = require("node:sqlite");
+  const db = new DatabaseSync(p);
+  return { exec: (sql) => db.exec(sql), close: () => db.close(), driver: "node:sqlite" };
+}
+
+// 첫 실행 부트스트랩: DB가 없으면 앱과 동일한 스키마를 만든다.
+// (엔진의 openDb는 파일이 없으면 하드 실패하므로, 여기서 미리 만들어 준다.
+//  스키마가 생기면 엔진의 seedBuiltins가 빌트인 에이전트를 채운다.)
+function bootstrapDbIfMissing() {
+  const p = dbPath();
+  if (exists(p)) return { created: false, path: p };
+  const schemaFile = path.join(PKG_ROOT, "engine", "bootstrap-schema.sql");
+  if (!exists(schemaFile)) {
+    throw new Error(`부트스트랩 스키마가 없습니다: ${schemaFile}`);
+  }
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  const sql = fs.readFileSync(schemaFile, "utf8");
+  const db = openSqlite(p);
+  try {
+    db.exec(sql);
+  } catch (e) {
+    db.close();
+    try { fs.rmSync(p); } catch { /* leave partial for inspection */ }
+    throw new Error(`DB 부트스트랩 실패: ${e.message}`);
+  }
+  db.close();
+  return { created: true, path: p };
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const sqliteDriver = probeSqliteDriver();
+  const engineFound = exists(ENGINE);
+
+  let error = null;
+  if (!engineFound) {
+    error = "엔진이 없습니다 (engine/agentlas.cjs). 재설치: npm i -g agentlas";
+  } else if (!sqliteDriver) {
+    error = `Node ${process.version} — SQLite 드라이버가 없습니다. Node 22.5+ 로 올리거나 'npm i -g agentlas'로 재설치(better-sqlite3 빌드)하세요.`;
+  }
+
+  if (args[0] === "--where" || args[0] === "terminal-where") {
+    process.stdout.write(JSON.stringify({
+      launcher: REAL_SELF,
+      packageRoot: PKG_ROOT,
+      engine: ENGINE,
+      engineFound,
+      db: dbPath(),
+      dbExists: exists(dbPath()),
+      sqliteDriver,
+      node: process.version,
+      error,
+    }, null, 2) + "\n");
+    process.exit(error ? 1 : 0);
+  }
+
+  if (error) {
+    process.stderr.write(error + "\n");
+    process.exit(1);
+  }
+
+  try {
+    const boot = bootstrapDbIfMissing();
+    if (boot.created) {
+      process.stderr.write(`첫 실행: Agentlas 데이터 초기화 완료 (${boot.path})\n`);
+    }
+  } catch (e) {
+    process.stderr.write(`${e.message}\n`);
+    process.exit(1);
+  }
+
+  const child = spawn(process.execPath, [ENGINE, ...args], { stdio: "inherit" });
+
+  // 시그널 처리:
+  //  - 터미널 Ctrl-C(SIGINT)는 포그라운드 프로세스 그룹으로 자식(REPL)에게 이미 전달된다.
+  //    런처가 한 번 더 전달하면 REPL의 "Ctrl-C 두 번이면 종료"가 오작동하므로 전달하지 않는다.
+  //  - PID로 직접 온 SIGTERM/SIGHUP(kill·프로세스 매니저·timeout(1))은 자식에게 전달한다.
+  try { process.on("SIGINT", () => { /* group delivery already reached the child */ }); } catch { /* ignore */ }
+  for (const sig of ["SIGTERM", "SIGHUP"]) {
+    try {
+      process.on(sig, () => {
+        try { child.kill(sig); } catch { /* already dead */ }
+      });
+    } catch { /* win32 SIGHUP 등 */ }
+  }
+
+  child.on("error", (err) => {
+    process.stderr.write(`Agentlas 엔진 실행 실패: ${err.message}\n`);
+    process.exit(1);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      // 자식의 시그널 종료를 그대로 전파 — 자체 핸들러를 걷어내야 재raise가 먹는다.
+      try {
+        process.removeAllListeners(signal);
+        process.kill(process.pid, signal);
+      } catch { /* fall through to numeric exit */ }
+      const num = os.constants.signals[signal];
+      process.exit(num ? 128 + num : 1);
+    }
+    process.exit(code == null ? 0 : code);
+  });
+}
+
+main();

package/engine/ENGINE_META.json

@@ -0,0 +1,8 @@
+{
+  "canonical": true,
+  "note": "이 engine/ 이 엔진 소스의 정본(canonical home)입니다. 데스크탑 앱에서 벤더링하지 않습니다 — 여기서 직접 유지보수합니다.",
+  "importedFrom": "agentlas-ai/agentlas-desktop/cli",
+  "importedAtDesktopVersion": "0.7.18",
+  "importedAtCommit": "bcfe0df",
+  "independentSince": "2026-07-07"
+}