agent-sin 0.1.12 → 0.1.16

package/builtin-skills/service-restart/main.ts

@@ -0,0 +1,249 @@
+import { spawn, execFile } from "node:child_process";
+import { access } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+const DARWIN_LABEL = "com.agent-sin.gateway";
+const WINDOWS_TASK_NAME = "Agent-Sin Gateway";
+const DEFAULT_DELAY_MS = 12000;
+
+type SkillInput = {
+  args?: Record<string, unknown>;
+  sources?: {
+    workspace?: string;
+    locale?: string;
+  };
+};
+
+type SkillResult = {
+  status: "ok" | "error" | "skipped";
+  title: string;
+  summary: string;
+  outputs: Record<string, unknown>;
+  data: Record<string, unknown>;
+  suggestions: unknown[];
+};
+
+export async function run(_ctx: unknown, input: SkillInput): Promise<SkillResult> {
+  const locale = input.sources?.locale === "ja" ? "ja" : "en";
+  const workspace = input.sources?.workspace || process.cwd();
+  const delayMs = clampDelay(input.args?.delay_ms);
+
+  if (process.platform === "darwin") {
+    return scheduleDarwinRestart(locale, workspace, delayMs);
+  }
+  if (process.platform === "win32") {
+    return scheduleWindowsRestart(locale, workspace, delayMs);
+  }
+
+  return errorResult(
+    locale,
+    "Restart is not supported",
+    "自動再起動は未対応です",
+    "Automatic service restart is supported on macOS and Windows. Run `agent-sin service restart` from a terminal on this platform.",
+    "この環境では自動再起動に未対応です。ターミナルで `agent-sin service restart` を実行してください。",
+    { platform: process.platform },
+  );
+}
+
+async function scheduleDarwinRestart(locale: "en" | "ja", workspace: string, delayMs: number): Promise<SkillResult> {
+  const plistPath = path.join(os.homedir(), "Library", "LaunchAgents", `${DARWIN_LABEL}.plist`);
+  try {
+    await access(plistPath);
+  } catch {
+    return errorResult(
+      locale,
+      "Service is not installed",
+      "サービス未登録",
+      "Agent-Sin service is not installed. Run `agent-sin service install` first.",
+      "Agent-Sin service が登録されていません。先に `agent-sin service install` を実行してください。",
+      { platform: "darwin", plist_path: plistPath },
+    );
+  }
+
+  const uid = typeof process.getuid === "function" ? process.getuid() : os.userInfo().uid;
+  const target = `gui/${uid}/${DARWIN_LABEL}`;
+  const loaded = await commandSucceeds("launchctl", ["print", target]);
+  const helperScript = loaded ? darwinKickstartScript() : cliRestartScript();
+  const helperEnv = loaded
+    ? { AGENT_SIN_RESTART_DELAY_MS: String(delayMs), AGENT_SIN_SERVICE_TARGET: target }
+    : cliRestartEnv(workspace, delayMs);
+
+  try {
+    await spawnDetachedHelper(helperScript, helperEnv, workspace);
+  } catch (error) {
+    return errorResult(
+      locale,
+      "Restart failed",
+      "再起動できませんでした",
+      `Could not schedule restart: ${errorMessage(error)}`,
+      `再起動を予約できませんでした: ${errorMessage(error)}`,
+      { platform: "darwin" },
+    );
+  }
+
+  return okResult(locale, delayMs, loaded ? "launchctl-kickstart" : "service-restart");
+}
+
+async function scheduleWindowsRestart(locale: "en" | "ja", workspace: string, delayMs: number): Promise<SkillResult> {
+  const installed = await commandSucceeds("schtasks", ["/Query", "/TN", WINDOWS_TASK_NAME]);
+  if (!installed) {
+    return errorResult(
+      locale,
+      "Service is not installed",
+      "サービス未登録",
+      "Agent-Sin service is not installed. Run `agent-sin service install` first.",
+      "Agent-Sin service が登録されていません。先に `agent-sin service install` を実行してください。",
+      { platform: "win32", task_name: WINDOWS_TASK_NAME },
+    );
+  }
+
+  try {
+    await spawnDetachedHelper(windowsRestartScript(), {
+      AGENT_SIN_RESTART_DELAY_MS: String(delayMs),
+      AGENT_SIN_WINDOWS_TASK_NAME: WINDOWS_TASK_NAME,
+    }, workspace);
+  } catch (error) {
+    return errorResult(
+      locale,
+      "Restart failed",
+      "再起動できませんでした",
+      `Could not schedule restart: ${errorMessage(error)}`,
+      `再起動を予約できませんでした: ${errorMessage(error)}`,
+      { platform: "win32" },
+    );
+  }
+
+  return okResult(locale, delayMs, "schtasks-restart");
+}
+
+function darwinKickstartScript(): string {
+  return `
+const { spawn } = require("node:child_process");
+const delay = Number(process.env.AGENT_SIN_RESTART_DELAY_MS || ${DEFAULT_DELAY_MS});
+const target = process.env.AGENT_SIN_SERVICE_TARGET;
+setTimeout(() => {
+  const child = spawn("launchctl", ["kickstart", "-k", target], { detached: true, stdio: "ignore" });
+  child.unref();
+}, delay);
+setTimeout(() => process.exit(0), delay + 2000);
+`;
+}
+
+function windowsRestartScript(): string {
+  return `
+const { spawn } = require("node:child_process");
+const delay = Number(process.env.AGENT_SIN_RESTART_DELAY_MS || ${DEFAULT_DELAY_MS});
+const taskName = process.env.AGENT_SIN_WINDOWS_TASK_NAME;
+function run(args) {
+  return new Promise((resolve) => {
+    const child = spawn("schtasks", args, { stdio: "ignore", windowsHide: true });
+    child.on("error", () => resolve());
+    child.on("exit", () => resolve());
+  });
+}
+setTimeout(async () => {
+  await run(["/End", "/TN", taskName]);
+  setTimeout(async () => {
+    await run(["/Run", "/TN", taskName]);
+    process.exit(0);
+  }, 1000);
+}, delay);
+setTimeout(() => process.exit(0), delay + 15000);
+`;
+}
+
+function cliRestartScript(): string {
+  return `
+const { spawn } = require("node:child_process");
+const delay = Number(process.env.AGENT_SIN_RESTART_DELAY_MS || ${DEFAULT_DELAY_MS});
+const cli = process.env.AGENT_SIN_CLI_PATH;
+const workspace = process.env.AGENT_SIN_WORKSPACE || process.cwd();
+setTimeout(() => {
+  const child = spawn(process.execPath, [cli, "service", "restart"], {
+    detached: true,
+    stdio: "ignore",
+    cwd: workspace,
+    env: process.env,
+    windowsHide: true,
+  });
+  child.unref();
+}, delay);
+setTimeout(() => process.exit(0), delay + 5000);
+`;
+}
+
+function cliRestartEnv(workspace: string, delayMs: number): Record<string, string> {
+  return {
+    AGENT_SIN_RESTART_DELAY_MS: String(delayMs),
+    AGENT_SIN_CLI_PATH: process.argv[1] || "agent-sin",
+    AGENT_SIN_WORKSPACE: workspace,
+    AGENT_SIN_HOME: process.env.AGENT_SIN_HOME || workspace,
+  };
+}
+
+function spawnDetachedHelper(script: string, extraEnv: Record<string, string>, cwd: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, ["-e", script], {
+      detached: true,
+      stdio: "ignore",
+      cwd,
+      env: { ...process.env, ...extraEnv },
+      windowsHide: true,
+    });
+    child.once("error", reject);
+    child.once("spawn", () => {
+      child.unref();
+      resolve();
+    });
+  });
+}
+
+function commandSucceeds(command: string, args: string[]): Promise<boolean> {
+  return new Promise((resolve) => {
+    execFile(command, args, { windowsHide: true }, (error) => {
+      resolve(!error);
+    });
+  });
+}
+
+function clampDelay(value: unknown): number {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return DEFAULT_DELAY_MS;
+  return Math.max(DEFAULT_DELAY_MS, Math.min(30000, Math.floor(parsed)));
+}
+
+function okResult(locale: "en" | "ja", delayMs: number, action: string): SkillResult {
+  return {
+    status: "ok",
+    title: locale === "ja" ? "再起動します" : "Restarting",
+    summary: locale === "ja"
+      ? "Agent-Sinを再起動します。数秒後に一度切断され、再接続します。続きの確認は再接続後にもう一度送ってください。"
+      : "Restarting Agent-Sin. It will disconnect briefly and reconnect in a few seconds. Send the next check again after it reconnects.",
+    outputs: {},
+    data: { delay_ms: delayMs, action },
+    suggestions: [],
+  };
+}
+
+function errorResult(
+  locale: "en" | "ja",
+  titleEn: string,
+  titleJa: string,
+  summaryEn: string,
+  summaryJa: string,
+  data: Record<string, unknown>,
+): SkillResult {
+  return {
+    status: "error",
+    title: locale === "ja" ? titleJa : titleEn,
+    summary: locale === "ja" ? summaryJa : summaryEn,
+    outputs: {},
+    data,
+    suggestions: [],
+  };
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}

package/builtin-skills/service-restart/skill.yaml

@@ -0,0 +1,49 @@
+# Builtin: service-restart
+# Agent-Sin の常駐サービスを再起動する。Discord / Telegram から設定反映が必要なときに使う。
+
+id: service-restart
+name: Agent-Sin Restart
+name_i18n:
+  en: Agent-Sin Restart
+  ja: Agent-Sin再起動
+description: Agent-Sinの常駐サービスを再起動する
+description_i18n:
+  en: Restart the Agent-Sin background service
+  ja: Agent-Sinの常駐サービスを再起動する
+runtime: typescript
+entry: main.ts
+handler: run
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: service.restart
+  phrases:
+    - Agent-Sinを再起動して
+    - agent-sinを再起動して
+    - 再起動して
+    - ボットを再起動して
+  phrases_i18n:
+    en:
+      - restart agent-sin
+      - restart the bot
+      - restart the service
+    ja:
+      - Agent-Sinを再起動して
+      - agent-sinを再起動して
+      - 再起動して
+      - ボットを再起動して
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      delay_ms:
+        type: integer
+        minimum: 12000
+        maximum: 30000
+        description: Restart delay in milliseconds
+        description_i18n:
+          en: Restart delay in milliseconds
+          ja: 再起動までの待ち時間（ミリ秒）

package/builtin-skills/todo-add/main.py

@@ -19,6 +19,7 @@ from datetime import datetime
 
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
 from i18n import localizer  # noqa: E402
+from _todo_lib import sync_todos, flush_todos  # noqa: E402
 
 
 async def run(ctx, input):
@@ -30,7 +31,7 @@ async def run(ctx, input):
     if not text:
         return result_skipped(loc.t("No ToDo", "ToDoなし"), loc.t("There is nothing to add.", "追加する内容がありません"))
 
-    items = list((await ctx.memory.get("items")) or [])
+    items = await sync_todos(ctx, input)
     now = input.get("trigger", {}).get("time") or datetime.now().isoformat()
     item = {
         "id": secrets.token_hex(3),
@@ -42,6 +43,7 @@ async def run(ctx, input):
         item["due"] = due
     items.append(item)
     await ctx.memory.set("items", items)
+    await flush_todos(ctx, input, items)
     ctx.log.info(f"todo-add: id={item['id']} total={len(items)}")
 
     summary = loc.t(f"Added: {text}", f"追加: {text}")

package/builtin-skills/todo-delete/main.py

@@ -16,6 +16,7 @@ import sys
 
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
 from i18n import localizer  # noqa: E402
+from _todo_lib import sync_todos, flush_todos  # noqa: E402
 
 
 async def run(ctx, input):
@@ -26,7 +27,7 @@ async def run(ctx, input):
     if not target_id:
         return error_result(loc.t("ID is missing", "IDが指定されていません"), loc.t("Specify the ToDo ID to delete.", "削除するToDoのIDを指定してください"))
 
-    items = list((await ctx.memory.get("items")) or [])
+    items = await sync_todos(ctx, input)
     if not items:
         return error_result(loc.t("No ToDos", "ToDoがありません"), loc.t("There are no registered ToDos yet.", "ToDoがまだ登録されていません"))
 
@@ -42,6 +43,7 @@ async def run(ctx, input):
     target = matches[0]
     remaining = [i for i in items if i is not target]
     await ctx.memory.set("items", remaining)
+    await flush_todos(ctx, input, remaining)
     ctx.log.info(f"todo-delete: id={target.get('id')} remaining={len(remaining)}")
 
     return {

package/builtin-skills/todo-done/main.py

@@ -16,6 +16,7 @@ from datetime import datetime
 
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
 from i18n import localizer  # noqa: E402
+from _todo_lib import sync_todos, flush_todos  # noqa: E402
 
 
 async def run(ctx, input):
@@ -26,7 +27,7 @@ async def run(ctx, input):
     if not target_id:
         return error_result(loc.t("ID is missing", "IDが指定されていません"), loc.t("Specify the ToDo ID to complete.", "完了するToDoのIDを指定してください"))
 
-    items = list((await ctx.memory.get("items")) or [])
+    items = await sync_todos(ctx, input)
     if not items:
         return error_result(loc.t("No ToDos", "ToDoがありません"), loc.t("There are no registered ToDos yet.", "ToDoがまだ登録されていません"))
 
@@ -48,6 +49,7 @@ async def run(ctx, input):
     target["status"] = "done"
     target["completed_at"] = now
     await ctx.memory.set("items", items)
+    await flush_todos(ctx, input, items)
     ctx.log.info(f"todo-done: id={target.get('id')}")
 
     return result_ok(loc.t("Done", "完了"), loc.t(f"Done: {text}", f"完了: {text}"), target)

package/builtin-skills/todo-list/main.py

@@ -18,6 +18,7 @@ from datetime import datetime, timezone
 
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
 from i18n import localizer  # noqa: E402
+from _todo_lib import sync_todos  # noqa: E402
 
 
 async def run(ctx, input):
@@ -25,7 +26,9 @@ async def run(ctx, input):
     args = input.get("args", {})
     status = str(args.get("status", "open")).strip() or "open"
 
-    items = list((await ctx.memory.get("items")) or [])
+    # todo-list は read-only スキル。Obsidian 側のマージ結果を表示するだけで、
+    # memory / ファイルへの永続化は行わない (次の write 可能スキルで反映される)。
+    items = await sync_todos(ctx, input)
     open_items = [i for i in items if i.get("status") == "open"]
     done_items = [i for i in items if i.get("status") == "done"]
     if status == "open":

package/builtin-skills/todo-tick/main.py

@@ -20,6 +20,7 @@ from datetime import datetime, timezone
 
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
 from i18n import localizer  # noqa: E402
+from _todo_lib import sync_todos, flush_todos  # noqa: E402
 
 
 async def run(ctx, input):
@@ -27,7 +28,7 @@ async def run(ctx, input):
     args = input.get("args", {})
     channel = str(args.get("channel", "auto")).strip() or "auto"
 
-    items = list((await ctx.memory.get("items")) or [])
+    items = await sync_todos(ctx, input)
     if not items:
         return result_ok(loc.t("Nothing due", "対象なし"), loc.t("There are no ToDos.", "ToDoはありません"), [], 0)
 
@@ -70,6 +71,7 @@ async def run(ctx, input):
 
     if fired:
         await ctx.memory.set("items", items)
+    await flush_todos(ctx, input, items)
 
     pending = sum(
         1 for i in items

package/builtin-skills/topic-knowledge-read/main.py

@@ -0,0 +1,118 @@
+"""Builtin: topic-knowledge-read
+
+Read full per-topic knowledge files produced by nightly-topic-knowledge.
+
+Read-only. The chat engine includes a short topic index on every turn; the AI
+calls this skill to load the full content of the few topics it actually needs.
+Missing / unsanitizable ids are reported in `data.missing` rather than failing
+the whole call so the model can still use what it got.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import sys
+from typing import Any
+
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "_shared"))
+from i18n import localizer  # noqa: E402
+
+
+TOPIC_ID_PATTERN = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {}) or {}
+    sources = input.get("sources", {}) or {}
+    memory_dir = sources.get("memory_dir")
+    if not memory_dir:
+        return _err(
+            loc.t("Workspace unavailable", "ワークスペース不明"),
+            loc.t("memory_dir is not provided.", "memory_dir が取得できません"),
+        )
+
+    raw_ids = args.get("topic_ids")
+    if not isinstance(raw_ids, list) or not raw_ids:
+        return _err(
+            loc.t("Missing input", "入力不足"),
+            loc.t("topic_ids is required and must not be empty.", "topic_ids は必須かつ空にできません"),
+        )
+
+    topics_root = os.path.join(memory_dir, "topic-knowledge", "topics")
+    found: list[dict[str, Any]] = []
+    missing: list[str] = []
+    seen: set[str] = set()
+    for raw in raw_ids:
+        tid = _sanitize(raw)
+        if not tid or tid in seen:
+            if isinstance(raw, str) and raw.strip():
+                missing.append(raw.strip())
+            continue
+        seen.add(tid)
+        file_path = os.path.join(topics_root, f"{tid}.json")
+        if not os.path.isfile(file_path):
+            missing.append(tid)
+            continue
+        try:
+            with open(file_path, "r", encoding="utf-8") as f:
+                data = json.load(f)
+        except Exception as e:
+            ctx.log.warn(f"topic-knowledge-read: failed to read {tid}: {e}")
+            missing.append(tid)
+            continue
+        found.append({"topic_id": tid, "path": file_path, "data": data})
+
+    if not found:
+        return {
+            "status": "skipped",
+            "title": loc.t("No topics found", "該当なし"),
+            "summary": loc.t(
+                f"No knowledge files found for: {', '.join(missing) or '(none)'}",
+                f"該当するトピックナレッジが見つかりません: {', '.join(missing) or '(なし)'}",
+            ),
+            "outputs": {},
+            "data": {"found": [], "missing": missing},
+            "suggestions": [],
+        }
+
+    ctx.log.info(
+        f"topic-knowledge-read: loaded {len(found)} topic(s), missing={len(missing)}"
+    )
+    missing_joined = ", ".join(missing)
+    en_suffix = f" (missing: {missing_joined})" if missing else ""
+    ja_suffix = f"（不在: {missing_joined}）" if missing else ""
+    return {
+        "status": "ok",
+        "title": loc.t("Topics loaded", "読み込み完了"),
+        "summary": loc.t(
+            f"Loaded {len(found)} topic(s){en_suffix}",
+            f"{len(found)}件のトピックを読み込みました{ja_suffix}",
+        ),
+        "outputs": {},
+        "data": {"found": found, "missing": missing},
+        "suggestions": [],
+    }
+
+
+def _sanitize(raw: object) -> str | None:
+    if not isinstance(raw, str):
+        return None
+    text = raw.strip().lower()
+    text = re.sub(r"[^a-z0-9]+", "-", text).strip("-")
+    if not text or not TOPIC_ID_PATTERN.match(text):
+        return None
+    return text
+
+
+def _err(title: str, summary: str) -> dict[str, Any]:
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/topic-knowledge-read/skill.yaml

@@ -0,0 +1,49 @@
+# Builtin: topic-knowledge-read
+# Read one or more per-topic knowledge files generated by nightly-topic-knowledge.
+# The chat engine surfaces a short topic index on every turn; the model uses this
+# read skill to pull full details for the few topics that look relevant.
+
+id: topic-knowledge-read
+name: Topic Knowledge Read
+name_i18n:
+  en: Topic Knowledge Read
+  ja: トピックナレッジ参照
+description: Read full knowledge files for the given topic ids
+description_i18n:
+  en: Read full knowledge files for the given topic ids
+  ja: 指定したトピックIDのナレッジ本文を読み出す
+runtime: python
+side_effect: false
+
+invocation:
+  command: knowledge.read
+  phrases:
+    - read topic knowledge
+    - load topic details
+  phrases_i18n:
+    en:
+      - read topic knowledge
+      - load topic details
+    ja:
+      - トピックナレッジを読んで
+      - トピックの詳細を見せて
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      topic_ids:
+        type: array
+        minItems: 1
+        maxItems: 8
+        items:
+          type: string
+          minLength: 1
+          maxLength: 64
+        description: Topic ids to load. See `<topic-knowledge-index>` in the chat context for the available ids.
+        description_i18n:
+          en: Topic ids to load. See `<topic-knowledge-index>` in the chat context for the available ids.
+          ja: 読み込むトピックIDの配列。利用可能なIDは会話コンテキストの `<topic-knowledge-index>` を参照
+    required:
+      - topic_ids

package/dist/builder/build-action-classifier.d.ts

@@ -10,9 +10,27 @@ export interface BuildModeActionDecision {
     action: "exit" | "register" | "test" | "continue";
     reason?: string;
 }
+export interface ScheduleRequestPayload {
+    id: string;
+    cron: string;
+    skill: string;
+    description?: string;
+    args?: Record<string, unknown>;
+    enabled?: boolean;
+    approve?: boolean;
+}
+export type ScheduleRequestDecision = {
+    matched: false;
+    reason?: string;
+} | {
+    matched: true;
+    payload: ScheduleRequestPayload;
+    reason?: string;
+};
 interface ClassifyOptions {
     modelId?: string;
 }
 export declare function classifyHandoffApproval(config: AppConfig, userText: string, history: ChatTurn[], pending: PendingHandoff, options?: ClassifyOptions): Promise<HandoffApprovalDecision>;
 export declare function classifyBuildModeAction(config: AppConfig, userText: string, history: ChatTurn[], build: BuildModeState, options?: ClassifyOptions): Promise<BuildModeActionDecision>;
+export declare function classifyScheduleRequest(config: AppConfig, userText: string, history: ChatTurn[], build: BuildModeState, options?: ClassifyOptions): Promise<ScheduleRequestDecision>;
 export {};