agent-sin 0.1.0

package/builtin-skills/profile-delete/_profile_lib.py

@@ -0,0 +1,98 @@
+"""Shared helpers for profile-edit / profile-delete skills.
+
+soul.md / user.md / memory.md は profile-save が `\n## <timestamp>\n\n<text>\n`
+形式で追記する。これを「ヘッダー = '## ...' を境にしたエントリ列」として
+扱うためのパーサと再シリアライズを提供する。
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import tempfile
+from typing import List, Optional, Tuple
+
+
+_HEADER_RE = re.compile(r"^##\s+(.+?)\s*$")
+
+
+def profile_file(workspace: str, target: str) -> str:
+    return os.path.join(workspace, "memory", "profile", f"{target}.md")
+
+
+def parse_profile(raw: str) -> Tuple[str, List[dict]]:
+    """Split into (preamble, entries[{ timestamp, text }]).
+
+    preamble は最初の '## ' より前の部分(ファイル冒頭のコメント等)。
+    各 entry の `text` は本文のみ(前後の改行は trim 済み)。
+    """
+    lines = raw.splitlines(keepends=False)
+    pre: List[str] = []
+    entries: List[dict] = []
+    current: Optional[dict] = None
+    for line in lines:
+        m = _HEADER_RE.match(line)
+        if m:
+            if current is not None:
+                current["text"] = "\n".join(current["_body"]).strip()
+                del current["_body"]
+                entries.append(current)
+            current = {"timestamp": m.group(1).strip(), "_body": []}
+            continue
+        if current is None:
+            pre.append(line)
+        else:
+            current["_body"].append(line)
+    if current is not None:
+        current["text"] = "\n".join(current["_body"]).strip()
+        del current["_body"]
+        entries.append(current)
+    preamble = "\n".join(pre).rstrip("\n")
+    return preamble, entries
+
+
+def serialize_profile(preamble: str, entries: List[dict]) -> str:
+    out: List[str] = []
+    if preamble:
+        out.append(preamble)
+    for entry in entries:
+        out.append("")
+        out.append(f"## {entry['timestamp']}")
+        out.append("")
+        out.append(entry["text"])
+    text = "\n".join(out)
+    if not text.endswith("\n"):
+        text += "\n"
+    return text
+
+
+def write_atomic(path: str, content: str) -> None:
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    fd, tmp = tempfile.mkstemp(
+        prefix=".profile.", suffix=".md.tmp", dir=os.path.dirname(path),
+    )
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8") as f:
+            f.write(content)
+        os.replace(tmp, path)
+    except Exception:
+        try:
+            os.unlink(tmp)
+        except Exception:
+            pass
+        raise
+
+
+def find_entry_index(entries: List[dict], *, index: Optional[int], timestamp: Optional[str]) -> int:
+    if timestamp:
+        for i, entry in enumerate(entries):
+            if entry["timestamp"] == timestamp:
+                return i
+        raise LookupError(f'timestamp "{timestamp}" にマッチするエントリがありません')
+    if index is not None:
+        if index < 1 or index > len(entries):
+            raise LookupError(
+                f"index {index} は範囲外です (entries={len(entries)})",
+            )
+        return index - 1
+    raise LookupError("index か timestamp のどちらかを指定してください")

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

@@ -0,0 +1,98 @@
+"""Builtin: profile-delete
+
+soul.md / user.md / memory.md の既存エントリを削除する。
+"""
+
+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"))
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from i18n import localizer  # noqa: E402
+from _profile_lib import (  # noqa: E402
+    find_entry_index,
+    parse_profile,
+    profile_file,
+    serialize_profile,
+    write_atomic,
+)
+
+
+VALID_TARGETS = {"soul", "user", "memory"}
+
+
+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 パスが取得できません"))
+
+    target = str(args.get("target", "")).strip()
+    index = args.get("index")
+    timestamp = args.get("timestamp")
+    timestamp = str(timestamp).strip() if timestamp else None
+
+    if target not in VALID_TARGETS:
+        return _err(loc.t("Invalid target", "対象不正"), loc.t("target must be soul, user, or memory.", "target は soul / user / memory のいずれかを指定してください"))
+    if index is not None and not isinstance(index, int):
+        return _err(loc.t("Invalid index", "index不正"), loc.t("index must be a positive integer.", "index は正の整数で指定してください"))
+    if index is None and not timestamp:
+        return _err(loc.t("Cannot identify entry", "特定不可"), loc.t("Specify either index or timestamp.", "index か timestamp のどちらかを指定してください"))
+
+    path = profile_file(workspace, target)
+    if not os.path.exists(path):
+        return _err(loc.t("File not found", "対象ファイルなし"), loc.t(f"{target}.md does not exist.", f"{target}.md が存在しません"))
+
+    with open(path, "r", encoding="utf-8") as f:
+        raw = f.read()
+    preamble, entries = parse_profile(raw)
+
+    if not entries:
+        return _err(loc.t("No entries", "エントリなし"), loc.t(f"{target}.md has no entries to delete.", f"{target}.md に削除対象のエントリがありません"))
+
+    try:
+        i = find_entry_index(entries, index=index, timestamp=timestamp)
+    except LookupError as e:
+        return _err(loc.t("Cannot identify entry", "特定不可"), str(e))
+
+    removed = entries.pop(i)
+
+    try:
+        write_atomic(path, serialize_profile(preamble, entries))
+    except Exception as e:
+        return _err(loc.t("Save failed", "保存失敗"), loc.t(f"Failed to write {target}.md: {e}", f"{target}.md への書き込みに失敗しました: {e}"))
+
+    ctx.log.info(f"profile-delete: {target}.md index={i + 1} removed")
+
+    preview = removed["text"]
+    if len(preview) > 60:
+        preview = preview[:57] + "..."
+    return {
+        "status": "ok",
+        "title": loc.t("Deleted", "削除"),
+        "summary": loc.t(f"Deleted entry {i + 1} from {target}.md: {preview}", f"{target}.md の {i + 1}番目を削除しました: {preview}"),
+        "outputs": {},
+        "data": {
+            "target": target,
+            "index": i + 1,
+            "timestamp": removed["timestamp"],
+            "removed": removed,
+            "remaining": len(entries),
+            "path": path,
+        },
+        "suggestions": [],
+    }
+
+
+def _err(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

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

@@ -0,0 +1,64 @@
+# Builtin: profile-delete
+# soul.md / user.md / memory.md の既存エントリを削除する。
+
+id: profile-delete
+name: Profile Delete
+name_i18n:
+  en: Profile Delete
+  ja: プロフィール削除
+description: 長期プロフィールのエントリを削除する
+description_i18n:
+  en: Delete a long-term profile entry
+  ja: 長期プロフィールのエントリを削除する
+runtime: python
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: profile.delete
+  phrases:
+    - プロフィールを消して
+    - soul.mdから消して
+    - user.mdから消して
+    - memory.mdから消して
+    - 長期メモを削除
+  phrases_i18n:
+    en:
+      - delete profile
+      - delete from soul.md
+      - delete from user.md
+      - delete from memory.md
+      - delete long-term memory
+    ja:
+      - プロフィールを消して
+      - soul.mdから消して
+      - user.mdから消して
+      - memory.mdから消して
+      - 長期メモを削除
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      target:
+        type: string
+        enum:
+          - soul
+          - user
+          - memory
+      index:
+        type: integer
+        minimum: 1
+        description: 上から数えた1始まりのエントリ番号
+        description_i18n:
+          en: 1-based entry number counted from the top
+          ja: 上から数えた1始まりのエントリ番号
+      timestamp:
+        type: string
+        description: エントリの '## <timestamp>' ヘッダ値で特定する場合に指定
+        description_i18n:
+          en: Use the entry's '## <timestamp>' header value to identify it
+          ja: エントリの '## <timestamp>' ヘッダ値で特定する場合に指定
+    required:
+      - target

package/builtin-skills/profile-edit/_profile_lib.py

@@ -0,0 +1,98 @@
+"""Shared helpers for profile-edit / profile-delete skills.
+
+soul.md / user.md / memory.md は profile-save が `\n## <timestamp>\n\n<text>\n`
+形式で追記する。これを「ヘッダー = '## ...' を境にしたエントリ列」として
+扱うためのパーサと再シリアライズを提供する。
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import tempfile
+from typing import List, Optional, Tuple
+
+
+_HEADER_RE = re.compile(r"^##\s+(.+?)\s*$")
+
+
+def profile_file(workspace: str, target: str) -> str:
+    return os.path.join(workspace, "memory", "profile", f"{target}.md")
+
+
+def parse_profile(raw: str) -> Tuple[str, List[dict]]:
+    """Split into (preamble, entries[{ timestamp, text }]).
+
+    preamble は最初の '## ' より前の部分(ファイル冒頭のコメント等)。
+    各 entry の `text` は本文のみ(前後の改行は trim 済み)。
+    """
+    lines = raw.splitlines(keepends=False)
+    pre: List[str] = []
+    entries: List[dict] = []
+    current: Optional[dict] = None
+    for line in lines:
+        m = _HEADER_RE.match(line)
+        if m:
+            if current is not None:
+                current["text"] = "\n".join(current["_body"]).strip()
+                del current["_body"]
+                entries.append(current)
+            current = {"timestamp": m.group(1).strip(), "_body": []}
+            continue
+        if current is None:
+            pre.append(line)
+        else:
+            current["_body"].append(line)
+    if current is not None:
+        current["text"] = "\n".join(current["_body"]).strip()
+        del current["_body"]
+        entries.append(current)
+    preamble = "\n".join(pre).rstrip("\n")
+    return preamble, entries
+
+
+def serialize_profile(preamble: str, entries: List[dict]) -> str:
+    out: List[str] = []
+    if preamble:
+        out.append(preamble)
+    for entry in entries:
+        out.append("")
+        out.append(f"## {entry['timestamp']}")
+        out.append("")
+        out.append(entry["text"])
+    text = "\n".join(out)
+    if not text.endswith("\n"):
+        text += "\n"
+    return text
+
+
+def write_atomic(path: str, content: str) -> None:
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    fd, tmp = tempfile.mkstemp(
+        prefix=".profile.", suffix=".md.tmp", dir=os.path.dirname(path),
+    )
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8") as f:
+            f.write(content)
+        os.replace(tmp, path)
+    except Exception:
+        try:
+            os.unlink(tmp)
+        except Exception:
+            pass
+        raise
+
+
+def find_entry_index(entries: List[dict], *, index: Optional[int], timestamp: Optional[str]) -> int:
+    if timestamp:
+        for i, entry in enumerate(entries):
+            if entry["timestamp"] == timestamp:
+                return i
+        raise LookupError(f'timestamp "{timestamp}" にマッチするエントリがありません')
+    if index is not None:
+        if index < 1 or index > len(entries):
+            raise LookupError(
+                f"index {index} は範囲外です (entries={len(entries)})",
+            )
+        return index - 1
+    raise LookupError("index か timestamp のどちらかを指定してください")

package/builtin-skills/profile-edit/main.py

@@ -0,0 +1,97 @@
+"""Builtin: profile-edit
+
+soul.md / user.md / memory.md の既存エントリ本文を置き換える。
+"""
+
+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"))
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from i18n import localizer  # noqa: E402
+from _profile_lib import (  # noqa: E402
+    find_entry_index,
+    parse_profile,
+    profile_file,
+    serialize_profile,
+    write_atomic,
+)
+
+
+VALID_TARGETS = {"soul", "user", "memory"}
+
+
+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 パスが取得できません"))
+
+    target = str(args.get("target", "")).strip()
+    text = str(args.get("text", "")).strip()
+    index = args.get("index")
+    timestamp = args.get("timestamp")
+    timestamp = str(timestamp).strip() if timestamp else None
+
+    if target not in VALID_TARGETS:
+        return _err(loc.t("Invalid target", "対象不正"), loc.t("target must be soul, user, or memory.", "target は soul / user / memory のいずれかを指定してください"))
+    if not text:
+        return _err(loc.t("No text", "本文なし"), loc.t("Specify the replacement text.", "置き換える本文を指定してください"))
+    if index is not None and not isinstance(index, int):
+        return _err(loc.t("Invalid index", "index不正"), loc.t("index must be a positive integer.", "index は正の整数で指定してください"))
+
+    path = profile_file(workspace, target)
+    if not os.path.exists(path):
+        return _err(loc.t("File not found", "対象ファイルなし"), loc.t(f"{target}.md does not exist.", f"{target}.md が存在しません"))
+
+    with open(path, "r", encoding="utf-8") as f:
+        raw = f.read()
+    preamble, entries = parse_profile(raw)
+
+    if not entries:
+        return _err(loc.t("No entries", "エントリなし"), loc.t(f"{target}.md has no entries to edit.", f"{target}.md に編集対象のエントリがありません"))
+
+    try:
+        i = find_entry_index(entries, index=index, timestamp=timestamp)
+    except LookupError as e:
+        return _err(loc.t("Cannot identify entry", "特定不可"), str(e))
+
+    before = entries[i]["text"]
+    entries[i]["text"] = text
+
+    try:
+        write_atomic(path, serialize_profile(preamble, entries))
+    except Exception as e:
+        return _err(loc.t("Save failed", "保存失敗"), loc.t(f"Failed to write {target}.md: {e}", f"{target}.md への書き込みに失敗しました: {e}"))
+
+    ctx.log.info(f"profile-edit: {target}.md index={i + 1} updated")
+
+    return {
+        "status": "ok",
+        "title": loc.t("Updated", "更新"),
+        "summary": loc.t(f"Updated entry {i + 1} in {target}.md", f"{target}.md の {i + 1}番目を更新しました"),
+        "outputs": {},
+        "data": {
+            "target": target,
+            "index": i + 1,
+            "timestamp": entries[i]["timestamp"],
+            "before": before,
+            "after": text,
+            "path": path,
+        },
+        "suggestions": [],
+    }
+
+
+def _err(title, summary):
+    return {
+        "status": "error",
+        "title": title,
+        "summary": summary,
+        "outputs": {},
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/profile-edit/skill.yaml

@@ -0,0 +1,72 @@
+# Builtin: profile-edit
+# soul.md / user.md / memory.md の既存エントリを書き換える。
+
+id: profile-edit
+name: Profile Edit
+name_i18n:
+  en: Profile Edit
+  ja: プロフィール編集
+description: 長期プロフィールの既存エントリを編集する
+description_i18n:
+  en: Edit an existing long-term profile entry
+  ja: 長期プロフィールの既存エントリを編集する
+runtime: python
+output_mode: raw
+side_effect: true
+
+invocation:
+  command: profile.edit
+  phrases:
+    - プロフィールを修正
+    - soul.mdを編集
+    - user.mdを編集
+    - memory.mdを編集
+    - 長期メモを直して
+  phrases_i18n:
+    en:
+      - edit profile
+      - edit soul.md
+      - edit user.md
+      - edit memory.md
+      - fix long-term memory
+    ja:
+      - プロフィールを修正
+      - soul.mdを編集
+      - user.mdを編集
+      - memory.mdを編集
+      - 長期メモを直して
+
+input:
+  schema:
+    type: object
+    additionalProperties: false
+    properties:
+      target:
+        type: string
+        enum:
+          - soul
+          - user
+          - memory
+      index:
+        type: integer
+        minimum: 1
+        description: 上から数えた1始まりのエントリ番号
+        description_i18n:
+          en: 1-based entry number counted from the top
+          ja: 上から数えた1始まりのエントリ番号
+      timestamp:
+        type: string
+        description: エントリの '## <timestamp>' ヘッダ値で特定する場合に指定
+        description_i18n:
+          en: Use the entry's '## <timestamp>' header value to identify it
+          ja: エントリの '## <timestamp>' ヘッダ値で特定する場合に指定
+      text:
+        type: string
+        minLength: 1
+        description: 置き換える本文
+        description_i18n:
+          en: Replacement text
+          ja: 置き換える本文
+    required:
+      - target
+      - text

package/builtin-skills/profile-save/main.py

@@ -0,0 +1,52 @@
+"""Builtin: profile-save
+
+soul.md / user.md / memory.md に長期プロフィールを追記する。
+Runtime が outputs の保存先に従って書き込むため、このスキル自身は content を返すだけ。
+"""
+
+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 = str(args.get("target", "")).strip()
+    text = str(args.get("text", "")).strip()
+
+    if target not in {"soul", "user", "memory"}:
+        return result("error", loc.t("Cannot save", "保存できません"), loc.t("target must be soul, user, or memory.", "target は soul / user / memory のいずれかを指定してください"), {})
+    if not text:
+        ctx.log.warn("profile-save: empty text, skipping")
+        return result("skipped", loc.t("Nothing saved", "保存なし"), loc.t("There is no text to save.", "保存する本文がありません"), {})
+
+    timestamp = input.get("trigger", {}).get("time") or ctx.now()
+    content = f"\n## {timestamp}\n\n{text}\n"
+    ctx.log.info(f"profile-save: saving {len(text)} chars to {target}.md")
+    return result(
+        "ok",
+        loc.t("Saved", "保存しました"),
+        loc.t(f"Saved to {target}.md", f"{target}.md に保存しました"),
+        {
+            target: {
+                "content": content,
+                "frontmatter": {},
+            }
+        },
+    )
+
+
+def result(status, title, summary, outputs):
+    return {
+        "status": status,
+        "title": title,
+        "summary": summary,
+        "outputs": outputs,
+        "data": {},
+        "suggestions": [],
+    }

package/builtin-skills/profile-save/skill.yaml

@@ -0,0 +1,69 @@
+# Builtin: profile-save
+# soul.md / user.md / memory.md に、ユーザーが明示した長期プロフィールを追記する。
+
+id: profile-save
+name: Profile Save
+name_i18n:
+  en: Profile Save
+  ja: プロフィール保存
+description: soul.md、user.md、memory.mdへ長期プロフィールを保存する
+description_i18n:
+  en: Save long-term profile entries to soul.md, user.md, or memory.md
+  ja: soul.md、user.md、memory.mdへ長期プロフィールを保存する
+runtime: python
+side_effect: true
+
+invocation:
+  command: profile.save
+  phrases:
+    - soul.mdに書いて
+    - user.mdに書いて
+    - memory.mdに書いて
+    - 長期記憶に保存
+    - プロフィールに記録
+  phrases_i18n:
+    en:
+      - write to soul.md
+      - write to user.md
+      - write to memory.md
+      - save to long-term memory
+      - record profile
+    ja:
+      - soul.mdに書いて
+      - user.mdに書いて
+      - memory.mdに書いて
+      - 長期記憶に保存
+      - プロフィールに記録
+
+input:
+  schema:
+    type: object
+    properties:
+      target:
+        type: string
+        enum:
+          - soul
+          - user
+          - memory
+      text:
+        type: string
+    required:
+      - target
+      - text
+
+outputs:
+  - id: soul
+    type: markdown
+    path: memory/profile
+    filename: soul.md
+    append: true
+  - id: user
+    type: markdown
+    path: memory/profile
+    filename: user.md
+    append: true
+  - id: memory
+    type: markdown
+    path: memory/profile
+    filename: memory.md
+    append: true