agent-sin 0.1.0

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

@@ -0,0 +1,68 @@
+"""Builtin: todo-add
+
+ToDo を1件追加する。memory.todo namespace の "items" リストに append する。
+
+入力:
+  args.text: ToDoの本文 (必須)
+  args.due:  ISO8601 日時 (任意)
+出力:
+  data.item: 追加したToDo
+  data.total: 追加後の総件数
+"""
+
+from __future__ import annotations
+
+import secrets
+import os
+import sys
+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
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {})
+    text = str(args.get("text", "")).strip()
+    due = str(args.get("due", "")).strip() or None
+
+    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 [])
+    now = input.get("trigger", {}).get("time") or datetime.now().isoformat()
+    item = {
+        "id": secrets.token_hex(3),
+        "text": text,
+        "status": "open",
+        "created_at": now,
+    }
+    if due:
+        item["due"] = due
+    items.append(item)
+    await ctx.memory.set("items", items)
+    ctx.log.info(f"todo-add: id={item['id']} total={len(items)}")
+
+    summary = loc.t(f"Added: {text}", f"追加: {text}")
+    if due:
+        summary += loc.t(f" (due {due})", f" (期限 {due})")
+    return {
+        "status": "ok",
+        "title": loc.t("Added", "追加"),
+        "summary": summary,
+        "outputs": {},
+        "data": {"item": item, "total": len(items)},
+        "suggestions": [],
+    }
+
+
+def result_skipped(title, summary):
+    return {
+        "status": "skipped",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/todo-add/skill.yaml

@@ -0,0 +1,53 @@
+# Builtin: todo-add
+# ToDo を1件追加する。状態は memory.todo namespace に保存される。
+
+id: todo-add
+name: ToDo Add
+name_i18n:
+  en: ToDo Add
+  ja: ToDo追加
+description: ToDoを1件追加する
+description_i18n:
+  en: Add one ToDo item
+  ja: ToDoを1件追加する
+runtime: python
+output_mode: raw  # スキル結果をそのままユーザーに返し、LLM 再整形ターンを挟まない
+side_effect: true
+
+invocation:
+  command: todo.add
+  phrases:
+    - todo追加
+    - やることを追加
+    - タスク追加
+  phrases_i18n:
+    en:
+      - add todo
+      - add a task
+      - create todo
+    ja:
+      - todo追加
+      - やることを追加
+      - タスク追加
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      text:
+        type: string
+        minLength: 1
+      due:
+        type: string
+        description: ISO8601 日時 (任意, 例 2026-05-17T18:00:00+09:00)。日付だけでなく時刻まで指定でき、todo-tick が到達時にctx.notifyで通知する
+        description_i18n:
+          en: Optional ISO8601 date-time, e.g. 2026-05-17T18:00:00+09:00. Include a time so todo-tick can notify when it arrives
+          ja: ISO8601 日時 (任意, 例 2026-05-17T18:00:00+09:00)。日付だけでなく時刻まで指定でき、todo-tick が到達時にctx.notifyで通知する
+    required:
+      - text
+
+memory:
+  namespace: todo
+  read: true
+  write: true

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

@@ -0,0 +1,65 @@
+"""Builtin: todo-delete
+
+ToDoを削除する。argsで渡されたidの完全一致または先頭一致で1件特定する。
+
+入力:
+  args.id: 対象ToDoのID (先頭一致可)
+出力:
+  data.removed: 削除したToDo
+  data.total:   削除後の総件数
+"""
+
+from __future__ import annotations
+
+import os
+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
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {})
+    target_id = str(args.get("id", "")).strip()
+
+    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 [])
+    if not items:
+        return error_result(loc.t("No ToDos", "ToDoがありません"), loc.t("There are no registered ToDos yet.", "ToDoがまだ登録されていません"))
+
+    matches = [i for i in items if i.get("id") == target_id]
+    if not matches:
+        matches = [i for i in items if str(i.get("id", "")).startswith(target_id)]
+    if not matches:
+        return error_result(loc.t("Not found", "見つかりません"), loc.t(f"No ToDo was found for ID {target_id}.", f"ID {target_id} のToDoは見つかりませんでした"))
+    if len(matches) > 1:
+        ids = ", ".join(str(i.get("id")) for i in matches)
+        return error_result(loc.t("Ambiguous ID", "IDが曖昧です"), loc.t(f"Multiple ToDos match: {ids}", f"複数のToDoが該当します: {ids}"))
+
+    target = matches[0]
+    remaining = [i for i in items if i is not target]
+    await ctx.memory.set("items", remaining)
+    ctx.log.info(f"todo-delete: id={target.get('id')} remaining={len(remaining)}")
+
+    return {
+        "status": "ok",
+        "title": loc.t("Deleted", "削除"),
+        "summary": loc.t(f"Deleted: {target.get('text', '')}", f"削除: {target.get('text', '')}"),
+        "outputs": {},
+        "data": {"removed": target, "total": len(remaining)},
+        "suggestions": [],
+    }
+
+
+def error_result(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/todo-delete/skill.yaml

@@ -0,0 +1,47 @@
+# Builtin: todo-delete
+# 指定したToDoを削除する。
+
+id: todo-delete
+name: ToDo Delete
+name_i18n:
+  en: ToDo Delete
+  ja: ToDo削除
+description: ToDoを削除する
+description_i18n:
+  en: Delete a ToDo item
+  ja: ToDoを削除する
+runtime: python
+output_mode: raw  # スキル結果をそのままユーザーに返し、LLM 再整形ターンを挟まない
+side_effect: true
+
+invocation:
+  command: todo.delete
+  phrases:
+    - todo削除
+    - 削除
+    - 消して
+  phrases_i18n:
+    en:
+      - delete todo
+      - remove task
+      - delete task
+    ja:
+      - todo削除
+      - 削除
+      - 消して
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      id:
+        type: string
+        minLength: 1
+    required:
+      - id
+
+memory:
+  namespace: todo
+  read: true
+  write: true

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

@@ -0,0 +1,75 @@
+"""Builtin: todo-done
+
+ToDoを完了状態に更新する。argsで渡されたidの完全一致または先頭一致で1件特定する。
+
+入力:
+  args.id: 対象ToDoのID (先頭一致可)
+出力:
+  data.item: 更新後のToDo
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+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
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {})
+    target_id = str(args.get("id", "")).strip()
+
+    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 [])
+    if not items:
+        return error_result(loc.t("No ToDos", "ToDoがありません"), loc.t("There are no registered ToDos yet.", "ToDoがまだ登録されていません"))
+
+    matches = [i for i in items if i.get("id") == target_id]
+    if not matches:
+        matches = [i for i in items if str(i.get("id", "")).startswith(target_id)]
+    if not matches:
+        return error_result(loc.t("Not found", "見つかりません"), loc.t(f"No ToDo was found for ID {target_id}.", f"ID {target_id} のToDoは見つかりませんでした"))
+    if len(matches) > 1:
+        ids = ", ".join(str(i.get("id")) for i in matches)
+        return error_result(loc.t("Ambiguous ID", "IDが曖昧です"), loc.t(f"Multiple ToDos match: {ids}", f"複数のToDoが該当します: {ids}"))
+
+    target = matches[0]
+    text = target.get("text", "")
+    if target.get("status") == "done":
+        return result_ok(loc.t("Already done", "既に完了済み"), loc.t(f"Already done: {text}", f"既に完了済み: {text}"), target)
+
+    now = input.get("trigger", {}).get("time") or datetime.now().isoformat()
+    target["status"] = "done"
+    target["completed_at"] = now
+    await ctx.memory.set("items", 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)
+
+
+def result_ok(title, summary, item):
+    return {
+        "status": "ok",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {"item": item},
+        "suggestions": [],
+    }
+
+
+def error_result(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/todo-done/skill.yaml

@@ -0,0 +1,47 @@
+# Builtin: todo-done
+# 指定したToDoを完了状態に更新する。idの先頭一致でも対応。
+
+id: todo-done
+name: ToDo Done
+name_i18n:
+  en: ToDo Done
+  ja: ToDo完了
+description: ToDoを完了済みにする
+description_i18n:
+  en: Mark a ToDo item as done
+  ja: ToDoを完了済みにする
+runtime: python
+output_mode: raw  # スキル結果をそのままユーザーに返し、LLM 再整形ターンを挟まない
+side_effect: true
+
+invocation:
+  command: todo.done
+  phrases:
+    - todo完了
+    - 完了
+    - チェック
+  phrases_i18n:
+    en:
+      - complete todo
+      - mark todo done
+      - check off task
+    ja:
+      - todo完了
+      - 完了
+      - チェック
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      id:
+        type: string
+        minLength: 1
+    required:
+      - id
+
+memory:
+  namespace: todo
+  read: true
+  write: true

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

@@ -0,0 +1,91 @@
+"""Builtin: todo-list
+
+memory.todo namespace の ToDo を一覧表示する。
+status=open(default) / done / all で絞り込める。
+
+入力:
+  args.status: open | done | all (default: open)
+出力:
+  data.items: 該当ToDoの配列
+  data.counts: { open, done, total }
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+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
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {})
+    status = str(args.get("status", "open")).strip() or "open"
+
+    items = list((await ctx.memory.get("items")) or [])
+    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":
+        shown = open_items
+    elif status == "done":
+        shown = done_items
+    else:
+        shown = items
+
+    counts = {"open": len(open_items), "done": len(done_items), "total": len(items)}
+
+    if not shown:
+        if status == "open":
+            return result_ok(loc.t("No ToDos", "ToDoなし"), loc.t("There are no open ToDos.", "未完了のToDoはありません"), shown, counts)
+        if status == "done":
+            return result_ok(loc.t("No ToDos", "ToDoなし"), loc.t("There are no completed ToDos.", "完了済みのToDoはありません"), shown, counts)
+        return result_ok(loc.t("No ToDos", "ToDoなし"), loc.t("There are no ToDos yet.", "ToDoがまだありません"), shown, counts)
+
+    now = parse_iso(input.get("trigger", {}).get("time")) or datetime.now(timezone.utc)
+
+    lines = []
+    for item in shown:
+        mark = "x" if loc.locale != "ja" and item.get("status") == "done" else "✔" if item.get("status") == "done" else "・"
+        line = f"{mark} {item.get('text', '')}"
+        due = item.get("due")
+        if due:
+            due_dt = parse_iso(due)
+            suffix = ""
+            if item.get("status") == "open" and due_dt and due_dt <= now:
+                suffix = loc.t(" overdue", " ⚠期限切れ")
+            elif item.get("notified_at"):
+                suffix = loc.t(" notified", " 🔔通知済")
+            line += loc.t(f" (due {due}){suffix}", f" (期限 {due}){suffix}")
+        item_id = item.get("id")
+        if item_id:
+            line += f"  ·  {item_id}"
+        lines.append(line)
+
+    title = loc.t(f"{len(shown)} ToDos", f"ToDo {len(shown)}件")
+    return result_ok(title, "\n".join(lines), shown, counts)
+
+
+def parse_iso(value):
+    if not value:
+        return None
+    try:
+        parsed = datetime.fromisoformat(str(value).replace("Z", "+00:00"))
+    except ValueError:
+        return None
+    if parsed.tzinfo is None:
+        parsed = parsed.replace(tzinfo=timezone.utc)
+    return parsed
+
+
+def result_ok(title, summary, items, counts):
+    return {
+        "status": "ok",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {"items": items, "counts": counts},
+        "suggestions": [],
+    }

package/builtin-skills/todo-list/skill.yaml

@@ -0,0 +1,48 @@
+# Builtin: todo-list
+# memory.todo namespace に保存された ToDo を一覧表示する読み取り専用スキル。
+
+id: todo-list
+name: ToDo List
+name_i18n:
+  en: ToDo List
+  ja: ToDo一覧
+description: ToDoの一覧を表示する
+description_i18n:
+  en: List ToDo items
+  ja: ToDoの一覧を表示する
+runtime: python
+output_mode: raw  # スキル結果をそのままユーザーに返し、LLM 再整形ターンを挟まない
+
+invocation:
+  command: todo.list
+  phrases:
+    - todo一覧
+    - todo
+    - やること
+    - タスク一覧
+  phrases_i18n:
+    en:
+      - list todos
+      - show todos
+      - task list
+    ja:
+      - todo一覧
+      - todo
+      - やること
+      - タスク一覧
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      status:
+        type: string
+        enum: [open, done, all]
+        default: open
+    required: []
+
+memory:
+  namespace: todo
+  read: true
+  write: false

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

@@ -0,0 +1,125 @@
+"""Builtin: todo-tick
+
+memory.todo namespace の open ToDo を走査し、due が現在時刻に達したものを
+ctx.notify で通知する。重複通知を避けるため notified_at を打つ。
+同じ期限時刻(分単位)のToDoは1通にまとめて通知する。
+
+入力:
+  args.channel: 通知チャネル (auto/macos/discord/telegram/slack/mail/stderr, default: auto)
+出力:
+  data.fired:   通知したToDoの配列
+  data.pending: 未通知のopen ToDo件数(due未設定 or 未到達も含む)
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from collections import OrderedDict
+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
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {})
+    channel = str(args.get("channel", "auto")).strip() or "auto"
+
+    items = list((await ctx.memory.get("items")) or [])
+    if not items:
+        return result_ok(loc.t("Nothing due", "対象なし"), loc.t("There are no ToDos.", "ToDoはありません"), [], 0)
+
+    now_str = input.get("trigger", {}).get("time")
+    now = parse_iso(now_str) or datetime.now(timezone.utc)
+
+    # 同じ期限(分単位)のToDoをまとめて1通にする
+    groups: "OrderedDict[str, list]" = OrderedDict()
+    for item in items:
+        if item.get("status") != "open":
+            continue
+        if item.get("notified_at"):
+            continue
+        due = parse_iso(item.get("due"))
+        if not due or due > now:
+            continue
+        key = due.replace(second=0, microsecond=0).isoformat()
+        groups.setdefault(key, []).append(item)
+
+    fired = []
+    failed = []
+    for group in groups.values():
+        body = "\n".join(i.get("text", "ToDo") for i in group)
+        outcome = await ctx.notify({
+            "title": loc.t("ToDo due", "ToDoの期限"),
+            "body": body,
+            "channel": channel,
+        })
+        if outcome.get("ok"):
+            stamp = now.isoformat()
+            for item in group:
+                item["notified_at"] = stamp
+                fired.append(item)
+                ctx.log.info(f"todo-tick: fired id={item.get('id')}")
+        else:
+            detail = outcome.get("detail") or "unknown"
+            for item in group:
+                failed.append({"id": item.get("id"), "error": detail})
+                ctx.log.warn(f"todo-tick: notify failed id={item.get('id')} - {detail}")
+
+    if fired:
+        await ctx.memory.set("items", items)
+
+    pending = sum(
+        1 for i in items
+        if i.get("status") == "open" and not i.get("notified_at")
+    )
+
+    if not fired and not failed:
+        return result_ok(loc.t("No notifications", "通知なし"), loc.t("No ToDos are due.", "期限到達のToDoはありません"), [], pending)
+    if failed and not fired:
+        return {
+            "status": "error",
+            "title": loc.t("Notification failed", "通知に失敗しました"),
+            "summary": loc.t(f"{len(failed)} notifications failed.", f"{len(failed)}件の通知に失敗しました"),
+            "outputs": {},
+            "data": {"fired": [], "failed": failed, "pending": pending},
+            "suggestions": [],
+        }
+
+    title = loc.t(f"Sent {len(fired)} notifications", f"{len(fired)}件を通知しました")
+    lines = [f"- {i.get('text', '')}" for i in fired]
+    if failed:
+        lines.append(loc.t(f"({len(failed)} failed)", f"(失敗 {len(failed)}件)"))
+    return {
+        "status": "ok",
+        "title": title,
+        "summary": "\n".join(lines),
+        "outputs": {},
+        "data": {"fired": fired, "failed": failed, "pending": pending},
+        "suggestions": [],
+    }
+
+
+def parse_iso(value):
+    if not value:
+        return None
+    try:
+        parsed = datetime.fromisoformat(str(value).replace("Z", "+00:00"))
+    except ValueError:
+        return None
+    if parsed.tzinfo is None:
+        parsed = parsed.replace(tzinfo=timezone.utc)
+    return parsed
+
+
+def result_ok(title, summary, fired, pending):
+    return {
+        "status": "ok",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {"fired": fired, "pending": pending},
+        "suggestions": [],
+    }

package/builtin-skills/todo-tick/skill.yaml

@@ -0,0 +1,48 @@
+# Builtin: todo-tick
+# 期限を過ぎた open ToDo を通知して notified_at を打つ。
+# schedules.yaml に毎分実行で登録するか、手動で `agent-sin run todo-tick` を呼ぶ。
+
+id: todo-tick
+name: ToDo Tick
+name_i18n:
+  en: ToDo Tick
+  ja: ToDo期限通知
+description: 期限が到達したToDoを通知する
+description_i18n:
+  en: Notify when ToDo due times are reached
+  ja: 期限が到達したToDoを通知する
+runtime: python
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: todo.tick
+  phrases:
+    - 期限のToDoを確認
+    - ToDo通知をチェック
+    - todoの期限チェック
+  phrases_i18n:
+    en:
+      - check due todos
+      - todo notifications
+      - check todo deadlines
+    ja:
+      - 期限のToDoを確認
+      - ToDo通知をチェック
+      - todoの期限チェック
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      channel:
+        type: string
+        enum: [auto, macos, discord, telegram, slack, mail, stderr]
+        default: auto
+    required: []
+
+memory:
+  namespace: todo
+  read: true
+  write: true

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

@@ -0,0 +1,18 @@
+import type { AppConfig } from "../core/config.js";
+import type { ChatTurn } from "../core/chat-engine.js";
+import type { BuildModeState, PendingHandoff } from "./build-flow.js";
+export interface HandoffApprovalDecision {
+    decision: "approve" | "reject" | "discuss";
+    carry_over_text?: string;
+    reason?: string;
+}
+export interface BuildModeActionDecision {
+    action: "exit" | "register" | "test" | "continue";
+    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 {};