@telvine/cli 0.1.0

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@telvine/cli",
+  "version": "0.1.0",
+  "description": "Telvine CLI - instrument SKILL.md capabilities inside agent plugins",
+  "homepage": "https://telvine.com",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telvinehq/telvine.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/telvinehq/telvine/issues"
+  },
+  "keywords": [
+    "agent-plugin",
+    "ai-agent",
+    "plugin-telemetry",
+    "plugin-analytics",
+    "copilot-cowork",
+    "codex-plugin",
+    "claude-plugin",
+    "mcp",
+    "skill-md",
+    "llm-tools"
+  ],
+  "type": "module",
+  "bin": {
+    "telvine": "./dist/telvine.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "bun build src/telvine.ts --target=node --outdir=dist --banner='#!/usr/bin/env node'",
+    "dev": "tsx src/telvine.ts",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/telvine.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "clipanion": "^4.0.0-rc.4",
+    "gray-matter": "^4.0.3",
+    "keytar": "^7.9.0",
+    "open": "^10.1.0",
+    "picocolors": "^1.1.1",
+    "typanion": "^3.14.0"
+  },
+  "devDependencies": {
+    "@telvine/schema": "workspace:0.1.0",
+    "@types/node": "^22.7.5",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.3"
+  }
+}

package/src/templates/wrapper.py

@@ -0,0 +1,75 @@
+"""Telvine script wrapper. Generated by `telvine publish` — do not edit by hand."""
+import os, sys, time, uuid, json, urllib.request, urllib.error
+from contextlib import contextmanager
+from pathlib import Path
+
+_TELVINE_API = "https://api.telvine.com/v1/events"
+_TELVINE_INSTALL_FILE = Path.home() / ".telvine" / "install_id"
+
+
+def _install_id() -> str:
+    try:
+        if _TELVINE_INSTALL_FILE.exists():
+            return _TELVINE_INSTALL_FILE.read_text().strip()
+        _TELVINE_INSTALL_FILE.parent.mkdir(parents=True, exist_ok=True)
+        new_id = f"inst_{uuid.uuid4().hex[:16]}"
+        _TELVINE_INSTALL_FILE.write_text(new_id)
+        return new_id
+    except Exception:
+        return f"inst_{uuid.uuid4().hex[:16]}"
+
+
+def _post(event: dict) -> None:
+    key = os.environ.get("TELVINE_WRITE_KEY")
+    if not key:
+        return
+    req = urllib.request.Request(
+        _TELVINE_API,
+        data=json.dumps(event).encode("utf-8"),
+        headers={
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {key}",
+        },
+        method="POST",
+    )
+    try:
+        urllib.request.urlopen(req, timeout=2).read()
+    except (urllib.error.URLError, TimeoutError, Exception):
+        pass
+
+
+@contextmanager
+def _telvine_track(script_name: str):
+    start_ns = time.monotonic_ns()
+    exit_code = 0
+    try:
+        yield
+    except SystemExit as e:
+        exit_code = int(e.code) if isinstance(e.code, int) else (0 if e.code is None else 1)
+        raise
+    except Exception:
+        exit_code = 1
+        raise
+    finally:
+        event = {
+            "event_type": "skill.script.invoked",
+            "skill_id": os.environ.get("TELVINE_SKILL_ID", "skl_unknown"),
+            "version": os.environ.get("TELVINE_SKILL_VERSION", "0.0.0"),
+            "installation_id": _install_id(),
+            "occurred_at": time.strftime("%Y-%m-%dT%H:%M:%S+00:00", time.gmtime()),
+            "idempotency_key": str(uuid.uuid4()),
+            "properties": {
+                "script_name": script_name,
+                "exit_code": exit_code,
+                "duration_ms": (time.monotonic_ns() - start_ns) // 1_000_000,
+            },
+        }
+        if os.environ.get("TELVINE_PLUGIN_ID"):
+            event["plugin_id"] = os.environ["TELVINE_PLUGIN_ID"]
+        _post(event)
+
+
+if __name__ == "__main__":
+    target = sys.argv[1] if len(sys.argv) > 1 else __file__
+    with _telvine_track(os.path.basename(target)):
+        exec(compile(open(target).read(), target, "exec"), {"__name__": "__main__"})

package/src/templates/wrapper.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Telvine script wrapper. Generated by `telvine publish` — do not edit by hand.
+set +e
+
+_TELVINE_API="https://api.telvine.com/v1/events"
+_TELVINE_INSTALL_FILE="${HOME}/.telvine/install_id"
+_TELVINE_START_NS=$(date +%s%N 2>/dev/null || python3 -c 'import time; print(int(time.monotonic_ns()))')
+
+_telvine_install_id() {
+  if [[ -f "$_TELVINE_INSTALL_FILE" ]]; then
+    cat "$_TELVINE_INSTALL_FILE"
+  else
+    mkdir -p "$(dirname "$_TELVINE_INSTALL_FILE")"
+    local id="inst_$(LC_ALL=C tr -dc 'a-z0-9' </dev/urandom | head -c 16)"
+    printf "%s" "$id" >"$_TELVINE_INSTALL_FILE"
+    printf "%s" "$id"
+  fi
+}
+
+_telvine_post() {
+  local script_name="$1" exit_code="$2"
+  [[ -z "${TELVINE_WRITE_KEY:-}" ]] && return 0
+  local end_ns now duration_ms
+  end_ns=$(date +%s%N 2>/dev/null || python3 -c 'import time; print(int(time.monotonic_ns()))')
+  duration_ms=$(( (end_ns - _TELVINE_START_NS) / 1000000 ))
+  now=$(date -u +"%Y-%m-%dT%H:%M:%S+00:00")
+  local idem plugin_line
+  idem=$(LC_ALL=C tr -dc 'a-f0-9' </dev/urandom | head -c 32)
+  plugin_line=""
+  [[ -n "${TELVINE_PLUGIN_ID:-}" ]] && plugin_line="  \"plugin_id\": \"${TELVINE_PLUGIN_ID}\","
+  curl -sS --max-time 2 -o /dev/null \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer ${TELVINE_WRITE_KEY}" \
+    -X POST "$_TELVINE_API" \
+    -d "$(cat <<EOF
+{
+  "event_type": "skill.script.invoked",
+  "skill_id": "${TELVINE_SKILL_ID:-skl_unknown}",
+${plugin_line}
+  "version": "${TELVINE_SKILL_VERSION:-0.0.0}",
+  "installation_id": "$(_telvine_install_id)",
+  "occurred_at": "${now}",
+  "idempotency_key": "${idem}",
+  "properties": {
+    "script_name": "${script_name}",
+    "exit_code": ${exit_code},
+    "duration_ms": ${duration_ms}
+  }
+}
+EOF
+)" || true
+}
+
+_telvine_target="$1"
+shift || true
+bash "$_telvine_target" "$@"
+_telvine_exit=$?
+_telvine_post "$(basename "$_telvine_target")" "$_telvine_exit"
+exit $_telvine_exit