agent-sin 0.1.0

package/install.ps1

@@ -0,0 +1,132 @@
+# Agent-Sin installer for Windows.
+#
+# Usage:
+#   irm https://<install-host>/install.ps1 | iex
+#   $args = @('--yes'); irm https://<install-host>/install.ps1 | iex
+#
+# Or after downloading:
+#   powershell -ExecutionPolicy Bypass -File .\install.ps1 -Yes
+#
+# Equivalent of install.sh: installs the agent-sin command globally,
+# runs `agent-sin setup`, and registers the Task Scheduler logon task.
+
+[CmdletBinding()]
+param(
+  [switch]$Yes,
+  [string]$Model,
+  [string]$Builder,
+  [switch]$Help
+)
+
+$ErrorActionPreference = 'Stop'
+
+$AppName = 'agent-sin'
+$NpmPackage = if ($env:AGENT_SIN_NPM_PACKAGE) { $env:AGENT_SIN_NPM_PACKAGE } else { 'agent-sin' }
+$MinNodeMajor = 22
+
+function Use-Japanese {
+  if ($env:AGENT_SIN_LOCALE -match '^ja') { return $true }
+  if ($env:AGENT_SIN_LOCALE -match '^en') { return $false }
+  $locale = if ($env:LC_ALL) { $env:LC_ALL } elseif ($env:LANG) { $env:LANG } else { [System.Globalization.CultureInfo]::CurrentUICulture.Name }
+  return $locale -match '^ja'
+}
+
+function Msg([string]$En, [string]$Ja) {
+  if (Use-Japanese) { $Ja } else { $En }
+}
+
+function Show-Usage {
+if (Use-Japanese) {
+@'
+Agent-Sin installer (Windows)
+
+使い方:
+  irm https://<install-host>/install.ps1 | iex
+  powershell -ExecutionPolicy Bypass -File .\install.ps1 [-Yes] [-Model <id>] [-Builder <id>]
+
+オプション:
+  -Yes               setup をプロンプトなしで実行
+  -Model <id>        agent-sin setup に既定モデルを渡す
+  -Builder <id>      agent-sin setup に builder モデルを渡す
+  -Help              このヘルプを表示
+
+環境変数:
+  AGENT_SIN_NPM_PACKAGE   インストールする npm package (既定: agent-sin)
+'@
+} else {
+@'
+Agent-Sin installer (Windows)
+
+Usage:
+  irm https://<install-host>/install.ps1 | iex
+  powershell -ExecutionPolicy Bypass -File .\install.ps1 [-Yes] [-Model <id>] [-Builder <id>]
+
+Options:
+  -Yes               Run setup without prompts
+  -Model <id>        Pass default model to agent-sin setup
+  -Builder <id>      Pass builder model to agent-sin setup
+  -Help              Show this help
+
+Environment:
+  AGENT_SIN_NPM_PACKAGE   npm package to install (default: agent-sin)
+'@
+}
+}
+
+if ($Help) {
+  Show-Usage
+  exit 0
+}
+
+function Require-Command([string]$Name) {
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    Write-Error (Msg "agent-sin install: missing required command: $Name" "agent-sin install: 必要なコマンドが見つかりません: $Name")
+    exit 1
+  }
+}
+
+Require-Command 'node'
+Require-Command 'npm'
+
+$nodeVersion = (& node -p "process.versions.node").Trim()
+$nodeMajor = [int]($nodeVersion.Split('.')[0])
+if ($nodeMajor -lt $MinNodeMajor) {
+  Write-Error (Msg "agent-sin install: Node.js $MinNodeMajor or newer is required. Current: v$nodeVersion" "agent-sin install: Node.js $MinNodeMajor 以上が必要です。現在: v$nodeVersion")
+  exit 1
+}
+
+Write-Host (Msg "agent-sin install: installing $NpmPackage globally..." "agent-sin install: $NpmPackage をグローバルインストールしています...")
+& npm install -g $NpmPackage
+if ($LASTEXITCODE -ne 0) {
+  Write-Error (Msg "agent-sin install: npm install failed." "agent-sin install: npm install に失敗しました。")
+  exit 1
+}
+
+if (-not (Get-Command $AppName -ErrorAction SilentlyContinue)) {
+  Write-Warning (Msg "agent-sin install: installed, but '$AppName' is not on PATH." "agent-sin install: インストール済みですが '$AppName' が PATH にありません。")
+  Write-Host (Msg "Check your npm global bin path with: npm bin -g" "npm bin -g で npm の global bin path を確認してください。")
+  Write-Host (Msg "You may need to open a new PowerShell so PATH refreshes." "PATH を反映するには新しい PowerShell を開く必要がある場合があります。")
+  exit 1
+}
+
+$setupArgs = New-Object System.Collections.Generic.List[string]
+if ($Yes) { $setupArgs.Add('--yes') }
+if ($Model) { $setupArgs.Add('--model'); $setupArgs.Add($Model) }
+if ($Builder) { $setupArgs.Add('--builder'); $setupArgs.Add($Builder) }
+
+Write-Host (Msg "agent-sin install: running setup..." "agent-sin install: setup を実行しています...")
+& $AppName setup @setupArgs
+if ($LASTEXITCODE -ne 0) {
+  Write-Error (Msg "agent-sin install: setup failed." "agent-sin install: setup に失敗しました。")
+  exit 1
+}
+
+Write-Host (Msg "agent-sin install: installing service..." "agent-sin install: service をインストールしています...")
+& $AppName service install
+if ($LASTEXITCODE -ne 0) {
+  Write-Warning (Msg "agent-sin install: service install reported a non-zero exit. Run 'agent-sin service status' for details." "agent-sin install: service install が非ゼロで終了しました。詳細は 'agent-sin service status' を実行してください。")
+}
+
+Write-Host ''
+Write-Host (Msg 'agent-sin install: ready' 'agent-sin install: 準備完了')
+Write-Host (Msg 'Next: agent-sin service status' '次: agent-sin service status')

package/install.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+APP_NAME="agent-sin"
+NPM_PACKAGE="${AGENT_SIN_NPM_PACKAGE:-agent-sin}"
+MIN_NODE_MAJOR=22
+
+setup_args=()
+
+locale_is_ja() {
+  case "${AGENT_SIN_LOCALE:-}" in
+    ja|ja_*) return 0 ;;
+    en|en_*) return 1 ;;
+  esac
+  case "${LC_ALL:-${LANG:-}}" in
+    ja*|JA*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+msg() {
+  if locale_is_ja; then
+    printf '%s\n' "$2"
+  else
+    printf '%s\n' "$1"
+  fi
+}
+
+usage() {
+  if locale_is_ja; then
+    cat <<'EOF'
+Agent-Sin installer
+
+使い方:
+  curl -fsSL https://<install-host>/install.sh | bash
+  curl -fsSL https://<install-host>/install.sh | bash -s -- --yes
+
+agent-sin コマンドをインストールし、setup を実行してログインサービスを登録します。
+
+オプション:
+  --yes, --defaults, --no-input  setup をプロンプトなしで実行
+  --model <id>                   agent-sin setup に既定モデルを渡す
+  --builder <id>                 agent-sin setup に builder モデルを渡す
+  --help                         このヘルプを表示
+
+環境変数:
+  AGENT_SIN_NPM_PACKAGE          インストールする npm package (既定: agent-sin)
+EOF
+  else
+    cat <<'EOF'
+Agent-Sin installer
+
+Usage:
+  curl -fsSL https://<install-host>/install.sh | bash
+  curl -fsSL https://<install-host>/install.sh | bash -s -- --yes
+
+Installs the agent-sin command, runs setup, and registers the login service.
+
+Options:
+  --yes, --defaults, --no-input  Run setup without prompts
+  --model <id>                   Pass default model to agent-sin setup
+  --builder <id>                 Pass builder model to agent-sin setup
+  --help                         Show this help
+
+Environment:
+  AGENT_SIN_NPM_PACKAGE          npm package to install (default: agent-sin)
+EOF
+  fi
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    --yes|--defaults|--no-input)
+      setup_args+=("$1")
+      shift
+      ;;
+    --model|--builder)
+      if [[ $# -lt 2 ]]; then
+        msg "agent-sin install: $1 requires a value" "agent-sin install: $1 には値が必要です" >&2
+        exit 1
+      fi
+      setup_args+=("$1" "$2")
+      shift 2
+      ;;
+    *)
+      msg "agent-sin install: unknown option: $1" "agent-sin install: 不明なオプションです: $1" >&2
+      msg "Run with --help for usage." "--help で使い方を確認してください。" >&2
+      exit 1
+      ;;
+  esac
+done
+
+need_cmd() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    msg "agent-sin install: missing required command: $1" "agent-sin install: 必要なコマンドが見つかりません: $1" >&2
+    return 1
+  fi
+}
+
+need_cmd node
+need_cmd npm
+
+node_major="$(node -p "Number(process.versions.node.split('.')[0])")"
+if [[ "$node_major" -lt "$MIN_NODE_MAJOR" ]]; then
+  msg "agent-sin install: Node.js $MIN_NODE_MAJOR or newer is required. Current: $(node -v)" "agent-sin install: Node.js $MIN_NODE_MAJOR 以上が必要です。現在: $(node -v)" >&2
+  exit 1
+fi
+
+msg "agent-sin install: installing $NPM_PACKAGE globally..." "agent-sin install: $NPM_PACKAGE をグローバルインストールしています..."
+npm install -g "$NPM_PACKAGE"
+
+if ! command -v "$APP_NAME" >/dev/null 2>&1; then
+  msg "agent-sin install: installed, but '$APP_NAME' is not on PATH." "agent-sin install: インストール済みですが '$APP_NAME' が PATH にありません。" >&2
+  msg "Check your npm global bin path with: npm bin -g" "npm bin -g で npm の global bin path を確認してください。" >&2
+  exit 1
+fi
+
+msg "agent-sin install: running setup..." "agent-sin install: setup を実行しています..."
+"$APP_NAME" setup "${setup_args[@]}"
+
+msg "agent-sin install: installing service..." "agent-sin install: service をインストールしています..."
+"$APP_NAME" service install
+
+echo ""
+msg "agent-sin install: ready" "agent-sin install: 準備完了"
+msg "Next: agent-sin service status" "次: agent-sin service status"

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "agent-sin",
+  "version": "0.1.0",
+  "description": "Program Skill-first personal AI agent OS CLI.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Agent-Sin contributors",
+  "homepage": "https://agent.shingoirie.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iritec/agent-sin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iritec/agent-sin/issues"
+  },
+  "main": "./dist/cli/index.js",
+  "types": "./dist/skills-sdk/types.d.ts",
+  "bin": {
+    "agent-sin": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "assets/",
+    "install.sh",
+    "install.ps1",
+    "builtin-skills/",
+    "templates/",
+    "!builtin-skills/**/__pycache__",
+    "!builtin-skills/**/*.pyc",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build-dist.mjs",
+    "setup": "npm ci --include=dev && npm run build && node scripts/local-cli.mjs setup",
+    "setup:global": "npm ci --include=dev && npm run build && npm link && agent-sin setup && agent-sin service install",
+    "start": "npm run build && node scripts/local-cli.mjs chat",
+    "demo": "npm run build && node scripts/local-cli.mjs setup && node scripts/local-cli.mjs run memo-save --text test-memo",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "smoke:providers": "npm run build && node scripts/smoke-providers.mjs",
+    "prepack": "npm run build",
+    "pack:check": "npm pack --dry-run",
+    "release:check": "npm test && npm run pack:check"
+  },
+  "dependencies": {
+    "nodemailer": "^8.0.7",
+    "typescript": "^5.9.3",
+    "ws": "^8.20.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/nodemailer": "^8.0.0",
+    "@types/ws": "^8.18.1"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/templates/skill-python/main.py

@@ -0,0 +1,74 @@
+"""Agent-Sin Skill (Python) - template
+
+The entry point is run(ctx, input). Runtime provides:
+
+  ctx.log.info(msg) / warn / error  : writes to logs/runs/<run-id>.json and events.jsonl
+  ctx.memory.get(key) / set(key, v) : persists under skill.yaml memory.namespace
+  ctx.ai.run(step_id, payload)      : calls an ai_steps entry declared in skill.yaml
+  ctx.notify(args)                  : notifies Discord/Telegram/macOS/Mail/Slack/stderr (auto recommended)
+  ctx.now()                         : returns the current time as an ISO8601 string
+
+input format:
+  {
+    "args":    arguments validated by skill.yaml input.schema,
+    "trigger": {"type": "manual", "id": ..., "time": "ISO8601"},
+    "sources": {"workspace": ..., "notes_dir": ..., ...},
+    "memory":  current ctx.memory snapshot,
+  }
+
+Return a SkillResult. outputs.<id> maps to outputs[id] in skill.yaml.
+Runtime saves outputs, so the skill should not write files directly.
+"""
+
+from __future__ import annotations
+
+
+def _locale(input):
+    locale = str((input.get("sources", {}) or {}).get("locale") or "").lower()
+    return "ja" if locale.startswith("ja") else "en"
+
+
+def _t(input, en, ja):
+    return ja if _locale(input) == "ja" else en
+
+
+async def run(ctx, input):
+    args = input.get("args", {})
+    text = str(args.get("text", "")).strip()
+
+    # Return status: skipped for empty input. Runtime logs it without saving outputs.
+    if not text:
+        return {
+            "status": "skipped",
+            "title": _t(input, "No input", "入力なし"),
+            "summary": _t(input, "Skipped because text is empty.", "text が空のためスキップしました"),
+            "outputs": {},
+            "data": {},
+            "suggestions": [],
+        }
+
+    # ctx.log also writes to events.jsonl, which is useful for debugging.
+    ctx.log.info(f"example-skill: processing {len(text)} chars")
+
+    # ctx.memory is persisted per namespace. Use it for small state such as run counts.
+    # Reads can use the input["memory"] snapshot; writes use await ctx.memory.set.
+    runs = int(input.get("memory", {}).get("runs", 0)) + 1
+    await ctx.memory.set("runs", runs)
+
+    timestamp = input.get("trigger", {}).get("time") or ctx.now()
+    content = f"- {timestamp} {text}\n"
+
+    # outputs.note maps to outputs[id=note] in skill.yaml. Runtime saves it by path/filename.
+    return {
+        "status": "ok",
+        "title": _t(input, "Processed", "処理しました"),
+        "summary": _t(input, f"Saved text (total {runs} run(s))", f"text を保存しました (累計 {runs} 回)"),
+        "outputs": {
+            "note": {
+                "content": content,
+                "frontmatter": {"tags": ["example"]},
+            }
+        },
+        "data": {"length": len(text), "runs": runs},
+        "suggestions": [],
+    }

package/templates/skill-python/skill.yaml

@@ -0,0 +1,48 @@
+# Agent-Sin Skill manifest (Python)
+# Required fields: id, runtime
+# entry/handler default to main.py / run, so they can usually be omitted.
+# Common optional: name, description, input, outputs, memory, ai_steps, required_env
+# See https://agent.shingoirie.com/skill-authoring for the full reference.
+
+id: example-skill           # Unique skill ID (kebab-case)
+name: Example Skill         # Human-readable name
+description: Example skill generated from the template
+runtime: python             # python | typescript
+
+# Hints for chat invocation (optional)
+invocation:
+  command: example.run
+  phrases:
+    - run the example
+    - sample
+
+# input.schema validates args passed to run(). Explicit required fields are safer.
+input:
+  schema:
+    type: object
+    properties:
+      text:
+        type: string
+        description: Text to process
+    required:
+      - text
+
+# Declare outputs when you want Runtime to save Markdown/JSON files.
+# This sample appends a Markdown note. {{yyyy}}/{{MM}}/{{date}} are available.
+outputs:
+  - id: note
+    type: markdown
+    path: notes/examples
+    filename: "{{date}}-example.md"
+    append: true
+
+# Persistent memory namespace used by ctx.memory.get/set.
+memory:
+  namespace: example
+  read: true
+  write: true
+
+# Optional: set "raw" only when you want to return the summary directly to users.
+# By default, the LLM receives the result and formats a natural-language reply.
+# See https://agent.shingoirie.com/skill-authoring for details.
+# output_mode: raw

package/templates/skill-typescript/main.ts

@@ -0,0 +1,87 @@
+// Agent-Sin Skill (TypeScript) - template
+//
+// Export run(ctx, input) directly; do not default-export it.
+// Runtime provides:
+//
+//   ctx.log.info(msg) / warn / error    writes to logs/runs/<run-id>.json and events.jsonl
+//   ctx.memory.get(key) / set(key, v)   persists under skill.yaml memory.namespace
+//   ctx.ai.run(step_id, payload)        calls an ai_steps entry declared in skill.yaml
+//   ctx.notify(args)                    notifies Discord/Telegram/macOS/Mail/Slack/stderr (auto recommended)
+//   ctx.now()                           current time as an ISO8601 string
+//
+// See src/skills-sdk/types.ts for SkillInput / SkillResult.
+// Runtime handles saving, notifications, and cron; skills should not touch fs directly.
+
+interface SkillCtx {
+  log: { info: (m: string) => void; warn: (m: string) => void; error: (m: string) => void };
+  // Prefer input.memory for reads; writes use await ctx.memory.set.
+  memory: {
+    get: (key: string) => Promise<unknown>;
+    set: (key: string, value: unknown) => Promise<boolean>;
+  };
+  ai: { run: (stepId: string, payload: unknown) => Promise<unknown> };
+  notify: (args: {
+    title: string;
+    body: string;
+    subtitle?: string;
+    sound?: boolean;
+    channel?: "auto" | "macos" | "discord" | "telegram" | "slack" | "mail" | "stderr";
+    to?: string;
+    discordThreadId?: string;
+    telegramThreadId?: string;
+  }) => Promise<{ ok: boolean; channel: string; detail?: string }>;
+  now: () => string;
+}
+
+interface SkillInput {
+  args: Record<string, unknown>;
+  trigger: { type: string; id: string; time: string };
+  sources: Record<string, unknown> & { locale?: string };
+  memory: Record<string, unknown>;
+}
+
+function locale(input: SkillInput): "en" | "ja" {
+  return String(input.sources?.locale || "").toLowerCase().startsWith("ja") ? "ja" : "en";
+}
+
+function tr(input: SkillInput, en: string, ja: string): string {
+  return locale(input) === "ja" ? ja : en;
+}
+
+export async function run(ctx: SkillCtx, input: SkillInput) {
+  const text = String(input.args?.text ?? "").trim();
+
+  if (!text) {
+    return {
+      status: "skipped" as const,
+      title: tr(input, "No input", "入力なし"),
+      summary: tr(input, "Skipped because text is empty.", "text が空のためスキップしました"),
+      outputs: {},
+      data: {},
+      suggestions: [],
+    };
+  }
+
+  ctx.log.info(`example-ts-skill: processing ${text.length} chars`);
+
+  const previous = Number(input.memory?.runs ?? 0);
+  const runs = previous + 1;
+  await ctx.memory.set("runs", runs);
+
+  const timestamp = input.trigger?.time || ctx.now();
+  const content = `- ${timestamp} ${text}\n`;
+
+  return {
+    status: "ok" as const,
+    title: tr(input, "Processed", "処理しました"),
+    summary: tr(input, `Saved text (total ${runs} run(s))`, `text を保存しました (累計 ${runs} 回)`),
+    outputs: {
+      note: {
+        content,
+        frontmatter: { tags: ["example-ts"] },
+      },
+    },
+    data: { length: text.length, runs },
+    suggestions: [],
+  };
+}

package/templates/skill-typescript/skill.yaml

@@ -0,0 +1,42 @@
+# Agent-Sin Skill manifest (TypeScript)
+# Required fields: id, runtime
+# entry/handler default to main.ts / run, so they can usually be omitted.
+# Common optional: name, description, input, outputs, memory, ai_steps, required_env
+# See https://agent.shingoirie.com/skill-authoring for the full reference.
+
+id: example-ts-skill        # Unique skill ID (kebab-case)
+name: Example TypeScript Skill
+description: Example TypeScript skill generated from the template
+runtime: typescript         # python | typescript
+
+invocation:
+  command: example.ts.run
+  phrases:
+    - run the TypeScript example
+
+input:
+  schema:
+    type: object
+    properties:
+      text:
+        type: string
+        description: Text to process
+    required:
+      - text
+
+outputs:
+  - id: note
+    type: markdown
+    path: notes/examples
+    filename: "{{date}}-example-ts.md"
+    append: true
+
+memory:
+  namespace: example-ts
+  read: true
+  write: true
+
+# Optional: set "raw" only when you want to return the summary directly to users.
+# By default, the LLM receives the result and formats a natural-language reply.
+# See https://agent.shingoirie.com/skill-authoring for details.
+# output_mode: raw