agent-sin 0.1.0

package/builtin-skills/memo-vector-search/skill.yaml

@@ -0,0 +1,53 @@
+# Builtin: memo-vector-search
+# memo-index で索引化した Chroma DB を意味検索する (multilingual MiniLM L12 経由)。
+# memo-search (substring grep) との使い分け:
+#   memo-search        → 完全一致・タグ検索向き、軽量
+#   memo-vector-search → 意味検索 (類義語・別表現を拾える)、要索引化
+
+id: memo-vector-search
+name: Memo Vector Search
+name_i18n:
+  en: Memo Vector Search
+  ja: メモ意味検索
+description: 索引化されたメモを意味検索する (Chroma)
+description_i18n:
+  en: Semantically search indexed memos with Chroma
+  ja: 索引化されたメモを意味検索する (Chroma)
+runtime: python
+
+invocation:
+  command: memo.vsearch
+  phrases:
+    - 意味検索
+    - ベクター検索
+  phrases_i18n:
+    en:
+      - semantic memo search
+      - vector search
+    ja:
+      - 意味検索
+      - ベクター検索
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      query:
+        type: string
+        minLength: 1
+      limit:
+        type: integer
+        minimum: 1
+        maximum: 50
+        default: 5
+      collection:
+        type: string
+        default: memo
+    required:
+      - query
+
+memory:
+  namespace: memo-index
+  read: true
+  write: false

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

@@ -0,0 +1,180 @@
+"""Builtin: model-add
+
+models.yaml にモデル定義を1件追加する。set_as が指定されていれば、
+追加と同時に chat / builder ロールの既定モデルにする。
+同じIDが既に同等の内容で登録されていれば idempotent に「登録済み」を返す。
+"""
+
+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
+from _models_lib import (  # noqa: E402
+    build_entry,
+    default_effort_for,
+    derive_id,
+    entries_equivalent,
+    entry_summary,
+    find_provider,
+    load_models,
+    models_path,
+    normalize_effort,
+    save_models,
+    unique_id,
+)
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {}) or {}
+    workspace = input.get("sources", {}).get("workspace", "")
+    if not workspace:
+        return _err(loc.t("Workspace unavailable", "ワークスペース不明"),
+                    loc.t("The workspace path is unavailable.", "workspace パスが取得できません"))
+
+    provider_raw = str(args.get("provider", "")).strip()
+    if not provider_raw:
+        return _err(loc.t("Provider missing", "プロバイダ未指定"),
+                    loc.t("Specify provider (codex / claude-code / openai / gemini / anthropic / ollama).",
+                          "provider を指定してください (codex / claude-code / openai / gemini / anthropic / ollama)"))
+    catalog = find_provider(provider_raw)
+    if not catalog:
+        return _err(loc.t("Unknown provider", "不明なプロバイダ"),
+                    loc.t(f"Unknown provider: {provider_raw}", f"不明なプロバイダです: {provider_raw}"))
+
+    model_raw = str(args.get("model", "")).strip()
+    model = model_raw or catalog.get("default_model")
+
+    set_as = str(args.get("set_as", "")).strip().lower() or None
+    if set_as and set_as not in ("chat", "builder"):
+        return _err(loc.t("Invalid set_as", "set_as 不正"),
+                    loc.t('set_as must be "chat" or "builder".', 'set_as は "chat" か "builder" を指定してください'))
+
+    try:
+        effort = normalize_effort(args.get("effort"))
+    except ValueError as e:
+        return _err(loc.t("Invalid effort", "effort 不正"), str(e))
+    if catalog.get("needs_effort") and not effort:
+        # ロール優先度: set_as があればそれ、無ければ chat の既定を使う
+        effort = default_effort_for(catalog, set_as or "chat")
+    if not catalog.get("needs_effort") and effort:
+        effort = None  # API 系では effort を持たない
+
+    try:
+        models = load_models(workspace)
+    except Exception as e:
+        return _err(loc.t("Load failed", "読込失敗"),
+                    loc.t(f"Could not read models.yaml: {e}", f"models.yaml を読めませんでした: {e}"))
+
+    existing_ids = set(models["models"].keys())
+    requested_id = str(args.get("id", "")).strip() or None
+    new_entry = build_entry(catalog, model, effort)
+
+    # 冪等性: 既存のエントリに内容一致するものがあれば、それを再利用する。
+    # requested_id があるときは、その ID が等価エントリでない限り別物として扱う。
+    equivalent_id = None
+    for eid, e in models["models"].items():
+        if entries_equivalent(e, new_entry):
+            equivalent_id = eid
+            break
+
+    if equivalent_id and (not requested_id or requested_id == equivalent_id):
+        existing = models["models"][equivalent_id]
+        roles_changed = False
+        if set_as and models["roles"].get(set_as) != equivalent_id:
+            models["roles"][set_as] = equivalent_id
+            roles_changed = True
+        if roles_changed:
+            try:
+                save_models(workspace, models)
+            except Exception as e:
+                return _err(loc.t("Save failed", "保存失敗"),
+                            loc.t(f"Failed to write models.yaml: {e}", f"models.yaml への書き込みに失敗しました: {e}"))
+            summary = loc.t(
+                f"{equivalent_id} already existed; set as {set_as} model.",
+                f"{equivalent_id} は既に登録済みでした。{set_as} の既定モデルに設定しました。")
+        else:
+            summary = loc.t(
+                f"Already registered: {entry_summary(equivalent_id, existing)}",
+                f"登録済みです: {entry_summary(equivalent_id, existing)}")
+        ctx.log.info(f"model-add: equivalent entry exists id={equivalent_id} set_as={set_as}")
+        return {
+            "status": "ok",
+            "title": loc.t("Already registered", "登録済み"),
+            "summary": summary,
+            "outputs": {},
+            "data": {
+                "id": equivalent_id,
+                "entry": existing,
+                "set_as": set_as,
+                "already_registered": True,
+                "path": models_path(workspace),
+            },
+            "suggestions": [],
+        }
+
+    # ID 決定: 明示指定があればそれを使う。なければ provider/effort から導出。
+    if requested_id:
+        new_id = requested_id
+        if new_id in existing_ids:
+            # 等価なら上で return 済み。ここに来るのは「同じIDで内容違い」のケース
+            return _err(
+                loc.t("ID conflict", "ID重複"),
+                loc.t(
+                    f'Model ID "{new_id}" already exists with different settings. Remove it first or use a different id.',
+                    f'モデルID "{new_id}" は別の内容で既に登録されています。先に削除するか、別の id を指定してください'),
+            )
+    else:
+        base = derive_id(catalog["id"], effort, catalog["type"])
+        new_id = unique_id(base, existing_ids)
+
+    models["models"][new_id] = new_entry
+    if set_as:
+        models["roles"][set_as] = new_id
+
+    try:
+        path = save_models(workspace, models)
+    except Exception as e:
+        return _err(loc.t("Save failed", "保存失敗"),
+                    loc.t(f"Failed to write models.yaml: {e}", f"models.yaml への書き込みに失敗しました: {e}"))
+
+    ctx.log.info(f"model-add: id={new_id} provider={catalog['id']} model={model} effort={effort} set_as={set_as}")
+
+    if set_as:
+        summary = loc.t(
+            f"Added {entry_summary(new_id, new_entry)} and set as {set_as} model.",
+            f"追加しました: {entry_summary(new_id, new_entry)}。{set_as} の既定モデルに設定しました。",
+        )
+    else:
+        summary = loc.t(
+            f"Added {entry_summary(new_id, new_entry)}.",
+            f"追加しました: {entry_summary(new_id, new_entry)}",
+        )
+
+    return {
+        "status": "ok",
+        "title": loc.t("Added", "追加"),
+        "summary": summary,
+        "outputs": {},
+        "data": {
+            "id": new_id,
+            "entry": new_entry,
+            "set_as": set_as,
+            "path": path,
+        },
+        "suggestions": [],
+    }
+
+
+def _err(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

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

@@ -0,0 +1,112 @@
+# Builtin: model-add
+# ~/.agent-sin/models.yaml にモデル定義を1件追加する。set_as を渡せば
+# chat / builder のロールにも同時に割り当てる。
+
+id: model-add
+name: Model Add
+name_i18n:
+  en: Model Add
+  ja: モデル追加
+description: >-
+  AIモデル定義を models.yaml に追加する。provider は codex / claude-code /
+  openai / gemini / anthropic / ollama のいずれか。model 名を省略すると
+  各プロバイダの既定値を使う。codex / claude-code は effort
+  (low/medium/high/xhigh) を受け付ける。set_as=chat または builder を渡すと
+  追加と同時にそのロールの既定モデルにする。
+description_i18n:
+  en: >-
+    Add an AI model definition to models.yaml. provider must be one of
+    codex / claude-code / openai / gemini / anthropic / ollama. When model
+    is omitted, the per-provider default is used. codex / claude-code
+    accept an effort (low/medium/high/xhigh). When set_as=chat or builder
+    is given, the new model is also assigned to that role.
+  ja: >-
+    AIモデル定義を models.yaml に追加する。provider は codex / claude-code /
+    openai / gemini / anthropic / ollama のいずれか。model 名を省略すると
+    各プロバイダの既定値を使う。codex / claude-code は effort
+    (low/medium/high/xhigh) を受け付ける。set_as=chat または builder を渡すと
+    追加と同時にそのロールの既定モデルにする。
+runtime: python
+entry: main.py
+handler: run
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: model.add
+  phrases:
+    - モデルを追加
+    - モデル追加
+    - openaiモデルを追加して
+    - anthropicを使えるようにして
+    - geminiを追加
+    - ollamaモデルを登録
+  phrases_i18n:
+    en:
+      - add a model
+      - register a model
+      - enable openai
+      - add anthropic
+      - add gemini
+      - register ollama model
+    ja:
+      - モデルを追加
+      - モデル追加
+      - openaiモデルを追加して
+      - anthropicを使えるようにして
+      - geminiを追加
+      - ollamaモデルを登録
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      provider:
+        type: string
+        enum:
+          - codex
+          - claude-code
+          - openai
+          - gemini
+          - anthropic
+          - ollama
+        description: 追加するモデルのプロバイダ
+        description_i18n:
+          en: Provider of the model to add
+          ja: 追加するモデルのプロバイダ
+      model:
+        type: string
+        description: モデル名 (省略時はプロバイダ既定値)
+        description_i18n:
+          en: Model name (uses provider default when omitted)
+          ja: モデル名 (省略時はプロバイダ既定値)
+      effort:
+        type: string
+        enum:
+          - low
+          - medium
+          - high
+          - xhigh
+        description: effort 設定 (codex / claude-code のみ)
+        description_i18n:
+          en: effort setting (codex / claude-code only)
+          ja: effort 設定 (codex / claude-code のみ)
+      id:
+        type: string
+        minLength: 1
+        description: 任意のエントリID (省略時は自動生成)
+        description_i18n:
+          en: Optional entry ID (auto-derived when omitted)
+          ja: 任意のエントリID (省略時は自動生成)
+      set_as:
+        type: string
+        enum:
+          - chat
+          - builder
+        description: 追加後にこのロールの既定モデルに設定する
+        description_i18n:
+          en: Also set as the default for this role after adding
+          ja: 追加後にこのロールの既定モデルに設定する
+    required:
+      - provider

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

@@ -0,0 +1,93 @@
+"""Builtin: model-list
+
+models.yaml の登録モデル一覧と、chat / builder ロールの現在の割当を返す。
+副作用なし。
+"""
+
+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
+from _models_lib import load_models, models_path  # noqa: E402
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    workspace = input.get("sources", {}).get("workspace", "")
+    if not workspace:
+        return _err(loc.t("Workspace unavailable", "ワークスペース不明"),
+                    loc.t("The workspace path is unavailable.", "workspace パスが取得できません"))
+
+    try:
+        models = load_models(workspace)
+    except Exception as e:
+        return _err(loc.t("Load failed", "読込失敗"),
+                    loc.t(f"Could not read models.yaml: {e}", f"models.yaml を読めませんでした: {e}"))
+
+    chat_id = models["roles"].get("chat")
+    builder_id = models["roles"].get("builder")
+
+    items = []
+    lines = []
+    for entry_id, entry in models["models"].items():
+        roles = []
+        if entry_id == chat_id:
+            roles.append("chat")
+        if entry_id == builder_id:
+            roles.append("builder")
+        item = {
+            "id": entry_id,
+            "type": entry.get("type"),
+            "provider": entry.get("provider"),
+            "model": entry.get("model"),
+            "effort": entry.get("effort"),
+            "enabled": entry.get("enabled", True),
+            "roles": roles,
+        }
+        items.append(item)
+        parts = []
+        parts.append(entry.get("provider") or entry.get("type") or "-")
+        if entry.get("model"):
+            parts.append(str(entry["model"]))
+        if entry.get("effort"):
+            parts.append(f"effort={entry['effort']}")
+        if entry.get("enabled") is False:
+            parts.append("disabled")
+        suffix = f"  <- {','.join(roles)}" if roles else ""
+        lines.append(f"- {entry_id}: {' / '.join(parts)}{suffix}")
+
+    role_summary = loc.t(
+        f"chat: {chat_id or '-'} / builder: {builder_id or '-'}",
+        f"chat: {chat_id or '-'} / builder: {builder_id or '-'}",
+    )
+    if items:
+        summary = role_summary + "\n" + "\n".join(lines)
+    else:
+        summary = loc.t("No models registered.", "登録モデルはありません")
+
+    return {
+        "status": "ok",
+        "title": loc.t("Models", "モデル一覧"),
+        "summary": summary,
+        "outputs": {},
+        "data": {
+            "roles": {"chat": chat_id, "builder": builder_id},
+            "models": items,
+            "path": models_path(workspace),
+        },
+        "suggestions": [],
+    }
+
+
+def _err(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

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

@@ -0,0 +1,48 @@
+# Builtin: model-list
+# models.yaml の登録モデル一覧と、chat / builder の現在の割当を返す。
+
+id: model-list
+name: Model List
+name_i18n:
+  en: Model List
+  ja: モデル一覧
+description: >-
+  models.yaml に登録されているモデル一覧と、chat / builder ロールの現在の
+  割当を返す。「今のモデルは何?」「使えるモデルは?」に答えるのに使う。
+description_i18n:
+  en: >-
+    Returns the list of models registered in models.yaml and the
+    current chat / builder role bindings.
+  ja: >-
+    models.yaml に登録されているモデル一覧と、chat / builder ロールの現在の
+    割当を返す。「今のモデルは何?」「使えるモデルは?」に答えるのに使う。
+runtime: python
+entry: main.py
+handler: run
+output_mode: raw
+side_effect: false
+
+invocation:
+  command: model.list
+  phrases:
+    - 今のモデルは
+    - 使えるモデル
+    - モデル一覧
+    - 登録モデル
+  phrases_i18n:
+    en:
+      - which model
+      - available models
+      - list models
+      - registered models
+    ja:
+      - 今のモデルは
+      - 使えるモデル
+      - モデル一覧
+      - 登録モデル
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties: {}

package/builtin-skills/model-set/main.py

@@ -0,0 +1,123 @@
+"""Builtin: model-set
+
+models.yaml.roles の chat / builder ロールに、登録済みのモデルIDを割り当てる。
+未登録IDが渡された場合は候補一覧をエラーで返す。
+"""
+
+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
+from _models_lib import (  # noqa: E402
+    ALLOWED_ROLES,
+    entry_summary,
+    load_models,
+    models_path,
+    save_models,
+)
+
+
+async def run(ctx, input):
+    loc = localizer(input)
+    args = input.get("args", {}) or {}
+    workspace = input.get("sources", {}).get("workspace", "")
+    if not workspace:
+        return _err(loc.t("Workspace unavailable", "ワークスペース不明"),
+                    loc.t("The workspace path is unavailable.", "workspace パスが取得できません"))
+
+    role = str(args.get("role", "")).strip().lower()
+    if role not in ALLOWED_ROLES:
+        return _err(loc.t("Invalid role", "role 不正"),
+                    loc.t('role must be "chat" or "builder".', 'role は "chat" か "builder" を指定してください'))
+
+    target_id = str(args.get("id", "")).strip()
+    if not target_id:
+        return _err(loc.t("ID missing", "ID未指定"),
+                    loc.t("Specify the model id to assign.", "割り当てるモデルIDを指定してください"))
+
+    try:
+        models = load_models(workspace)
+    except Exception as e:
+        return _err(loc.t("Load failed", "読込失敗"),
+                    loc.t(f"Could not read models.yaml: {e}", f"models.yaml を読めませんでした: {e}"))
+
+    if target_id not in models["models"]:
+        known = ", ".join(models["models"].keys()) or "-"
+        return _err(
+            loc.t("Unknown model", "未登録モデル"),
+            loc.t(
+                f"Model id not found: {target_id}. Available: {known}. Call model-add first to register it.",
+                f"未登録のモデルIDです: {target_id}。登録済み: {known}。先に model-add で登録してください",
+            ),
+        )
+
+    current_id = models["roles"].get(role)
+    entry = models["models"][target_id]
+
+    if current_id == target_id:
+        return {
+            "status": "ok",
+            "title": loc.t("No change", "変更なし"),
+            "summary": loc.t(
+                f"{role} model is already {entry_summary(target_id, entry)}.",
+                f"{role} は既に {entry_summary(target_id, entry)} です",
+            ),
+            "outputs": {},
+            "data": {
+                "role": role,
+                "id": target_id,
+                "entry": entry,
+                "changed": False,
+                "path": models_path(workspace),
+            },
+            "suggestions": [],
+        }
+
+    # 該当エントリが disabled だった場合、ロール割当と同時に enabled=true にする
+    # (setRoleModel の TS 実装と挙動を合わせる)
+    if entry.get("enabled") is False:
+        entry["enabled"] = True
+        models["models"][target_id] = entry
+
+    models["roles"][role] = target_id
+
+    try:
+        path = save_models(workspace, models)
+    except Exception as e:
+        return _err(loc.t("Save failed", "保存失敗"),
+                    loc.t(f"Failed to write models.yaml: {e}", f"models.yaml への書き込みに失敗しました: {e}"))
+
+    ctx.log.info(f"model-set: role={role} id={target_id} (was {current_id or '-'})")
+
+    return {
+        "status": "ok",
+        "title": loc.t("Switched", "切り替え"),
+        "summary": loc.t(
+            f"{role} model -> {entry_summary(target_id, entry)}",
+            f"{role} のモデルを {entry_summary(target_id, entry)} に切り替えました",
+        ),
+        "outputs": {},
+        "data": {
+            "role": role,
+            "id": target_id,
+            "previous_id": current_id,
+            "entry": entry,
+            "changed": True,
+            "path": path,
+        },
+        "suggestions": [],
+    }
+
+
+def _err(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/model-set/skill.yaml

@@ -0,0 +1,69 @@
+# Builtin: model-set
+# models.yaml.roles の chat / builder を既存のモデルIDに付け替える。
+
+id: model-set
+name: Model Set
+name_i18n:
+  en: Model Set
+  ja: モデル切替
+description: >-
+  chat または builder のロールに、models.yaml に登録済みのモデルIDを割り当てる。
+  まだ登録されていないモデルを使いたい場合は model-add を先に呼ぶこと。
+description_i18n:
+  en: >-
+    Assign an already-registered model ID to the chat or builder role.
+    For a not-yet-registered provider, call model-add first.
+  ja: >-
+    chat または builder のロールに、models.yaml に登録済みのモデルIDを割り当てる。
+    まだ登録されていないモデルを使いたい場合は model-add を先に呼ぶこと。
+runtime: python
+entry: main.py
+handler: run
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: model.set
+  phrases:
+    - モデルを切り替えて
+    - chatをXに
+    - builderをXに
+    - 既定モデルを変更
+    - モデル変更
+  phrases_i18n:
+    en:
+      - switch the model
+      - set chat model
+      - set builder model
+      - change default model
+    ja:
+      - モデルを切り替えて
+      - chatをXに
+      - builderをXに
+      - 既定モデルを変更
+      - モデル変更
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      role:
+        type: string
+        enum:
+          - chat
+          - builder
+        description: 切り替え対象のロール
+        description_i18n:
+          en: Role to switch
+          ja: 切り替え対象のロール
+      id:
+        type: string
+        minLength: 1
+        description: 割り当てる既存のモデルID
+        description_i18n:
+          en: Existing model ID to assign
+          ja: 割り当てる既存のモデルID
+    required:
+      - role
+      - id