narai-primitives 2.1.2 → 2.2.0

package/plugins/db-agent/hooks/hooks.json

@@ -1,61 +0,0 @@
-{
-  "SessionStart": [
-    {
-      "hooks": [
-        {
-          "type": "command",
-          "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (mkdir -p \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/\" && cd \"${CLAUDE_PLUGIN_DATA}\" && npm install --no-audit --no-fund) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""
-        },
-        {
-          "type": "command",
-          "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/reminder.mjs\" 2>/dev/null || true"
-        },
-        {
-          "type": "command",
-          "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/stale-summarize.mjs\" 2>/dev/null || true",
-          "env": { "USAGE_CONNECTOR_NAME": "db" }
-        }
-      ]
-    }
-  ],
-  "PreToolUse": [
-    {
-      "matcher": "Bash",
-      "hooks": [
-        {
-          "type": "command",
-          "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/db-guard.mjs",
-          "env": {
-            "DB_AGENT_GUARDRAILS": "${user_config.install_guardrails}"
-          }
-        }
-      ]
-    }
-  ],
-  "PostToolUse": [
-    {
-      "matcher": "Bash",
-      "hooks": [
-        {
-          "type": "command",
-          "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/usage-record.mjs\" 2>/dev/null || true",
-          "env": {
-            "USAGE_CONNECTOR_NAME": "db",
-            "USAGE_BIN_HINT": "narai-primitives/dist/connectors/db"
-          }
-        }
-      ]
-    }
-  ],
-  "SessionEnd": [
-    {
-      "hooks": [
-        {
-          "type": "command",
-          "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/session-summary.mjs\" 2>/dev/null || true",
-          "env": { "USAGE_CONNECTOR_NAME": "db" }
-        }
-      ]
-    }
-  ]
-}

package/plugins/db-agent/hooks/reminder.mjs

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * SessionStart curation reminder for the db-agent connector.
- */
-try {
-  const data = process.env.CLAUDE_PLUGIN_DATA;
-  if (!data) process.exit(0);
-  const toolkitEntry = `${data}/node_modules/narai-primitives/dist/toolkit/plugin/reminder.js`;
-  const mod = await import(toolkitEntry);
-  const decision = mod.evaluateNudge({ connectors: ["db"] });
-  if (decision.nudge) {
-    process.stdout.write(decision.banner + "\n");
-  }
-} catch {
-  // best-effort — reminder never blocks startup
-}

package/plugins/db-agent/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "db-agent-plugin-runtime",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-    "narai-primitives": "^2.0.0"
-  }
-}

package/plugins/gcp-agent/commands/gcp-agent.md

@@ -1,6 +0,0 @@
----
-description: Run a read-only GCP query via the gcp-agent connector
-argument-hint: "<action> <params-json>"
----
-
-Invoke the `gcp-agent` skill with the user's $ARGUMENTS as the action name and params JSON. Return the connector's JSON envelope verbatim.

package/plugins/gcp-agent/hooks/reminder.mjs

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * SessionStart curation reminder for the GCP connector.
- */
-try {
-  const data = process.env.CLAUDE_PLUGIN_DATA;
-  if (!data) process.exit(0);
-  const toolkitEntry = `${data}/node_modules/narai-primitives/dist/toolkit/plugin/reminder.js`;
-  const mod = await import(toolkitEntry);
-  const decision = mod.evaluateNudge({ connectors: ["gcp"] });
-  if (decision.nudge) {
-    process.stdout.write(decision.banner + "\n");
-  }
-} catch {
-  // best-effort — reminder never blocks startup
-}

package/plugins/gcp-agent/package.json

@@ -1,9 +0,0 @@
-{
-  "name": "gcp-agent-plugin-runtime",
-  "version": "1.0.0",
-  "private": true,
-  "description": "Runtime manifest for gcp-agent-plugin. The SessionStart hook runs `npm install` on this manifest into ${CLAUDE_PLUGIN_DATA}.",
-  "dependencies": {
-    "narai-primitives": "^2.0.0"
-  }
-}

package/plugins/github-agent/README.md

@@ -1,13 +0,0 @@
-# github-agent-plugin
-
-Claude Code plugin wrapping `narai-primitives/github`. Same layout as the other platform plugins.
-
-## Credentials
-
-```bash
-export GITHUB_TOKEN="ghp_…"
-```
-
-## License
-
-MIT

package/plugins/github-agent/commands/github-agent.md

@@ -1,6 +0,0 @@
----
-description: Run a read-only GitHub query via the github-agent connector
-argument-hint: "<action> <params-json>"
----
-
-Invoke the `github-agent` skill with the user's $ARGUMENTS as the action name and params JSON. Return the connector's JSON envelope verbatim.

package/plugins/github-agent/hooks/reminder.mjs

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * SessionStart curation reminder for the GitHub connector.
- */
-try {
-  const data = process.env.CLAUDE_PLUGIN_DATA;
-  if (!data) process.exit(0);
-  const toolkitEntry = `${data}/node_modules/narai-primitives/dist/toolkit/plugin/reminder.js`;
-  const mod = await import(toolkitEntry);
-  const decision = mod.evaluateNudge({ connectors: ["github"] });
-  if (decision.nudge) {
-    process.stdout.write(decision.banner + "\n");
-  }
-} catch {
-  // best-effort — reminder never blocks startup
-}

package/plugins/github-agent/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "github-agent-plugin-runtime",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-    "narai-primitives": "^2.0.0"
-  }
-}

package/plugins/github-agent/skills/github-agent/SKILL.md

@@ -1,41 +0,0 @@
----
-name: github-agent
-description: |
-  Use when the user asks about read-only GitHub data — repository info,
-  code search, issue/PR listing, or single-file retrieval. Never
-  modifies GitHub.
-context: fork
----
-
-# GitHub Agent
-
-Answer the user's question by invoking the `github-agent` binary
-exposed by this plugin. It delegates to
-`narai-primitives/github` via GitHub's REST v3 + GraphQL APIs.
-
-## Invocation
-
-```
-github-agent --action <action> --params '<json>'
-```
-
-Return the connector's JSON envelope verbatim.
-
-## Supported actions
-
-| Action | Required params |
-|---|---|
-| `repo_info` | `owner`, `repo` |
-| `search_code` | `query`, optional `max_results` |
-| `get_issues` | `owner`, `repo`, optional `state`, `max_results` |
-| `get_pulls` | `owner`, `repo`, optional `state`, `max_results` |
-| `get_file` | `owner`, `repo`, `path`, optional `ref` |
-
-## Credentials
-
-Export `GITHUB_TOKEN` (PAT with `repo` / `read:org` as needed).
-
-## Safety
-
-Read-only — only GET (REST) and POST /graphql (read-only queries)
-are permitted.

package/plugins/jira-agent/.claude-plugin/plugin.json

@@ -1,6 +0,0 @@
-{
-  "name": "jira-agent-plugin",
-  "version": "1.1.0",
-  "description": "Read-only Jira connector for Claude Code. Built on narai-primitives (subpath ./jira).",
-  "author": "narai"
-}

package/plugins/jira-agent/commands/jira-agent.md

@@ -1,6 +0,0 @@
----
-description: Run a read-only Jira query via the jira-agent connector
-argument-hint: "<action> <params-json>"
----
-
-Invoke the `jira-agent` skill with the user's $ARGUMENTS as the action name and params JSON. Return the connector's JSON envelope verbatim.

package/plugins/jira-agent/hooks/reminder.mjs

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * SessionStart curation reminder for the Jira connector.
- */
-try {
-  const data = process.env.CLAUDE_PLUGIN_DATA;
-  if (!data) process.exit(0);
-  const toolkitEntry = `${data}/node_modules/narai-primitives/dist/toolkit/plugin/reminder.js`;
-  const mod = await import(toolkitEntry);
-  const decision = mod.evaluateNudge({ connectors: ["jira"] });
-  if (decision.nudge) {
-    process.stdout.write(decision.banner + "\n");
-  }
-} catch {
-  // best-effort — reminder never blocks startup
-}

package/plugins/jira-agent/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "jira-agent-plugin-runtime",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-    "narai-primitives": "^2.0.0"
-  }
-}

package/plugins/jira-agent/skills/jira-agent/SKILL.md

@@ -1,37 +0,0 @@
----
-name: jira-agent
-description: |
-  Use when the user asks about read-only Jira data — JQL search, single
-  issue details, or project metadata. Never modifies Jira.
-context: fork
----
-
-# Jira Agent
-
-Answer the user's question by invoking the `jira-agent` binary exposed
-by this plugin. It delegates to `narai-primitives/jira` via
-Atlassian's Jira REST v3.
-
-## Invocation
-
-```
-jira-agent --action <action> --params '<json>'
-```
-
-Return the connector's JSON envelope verbatim.
-
-## Supported actions
-
-| Action | Required params |
-|---|---|
-| `jql_search` | `jql`, optional `max_results` (default 50, max 500) |
-| `get_issue` | `issue_key` (e.g. `FOO-123`), optional `expand` |
-| `get_project` | `project_key` (e.g. `FOO`) |
-
-## Credentials
-
-Set `JIRA_SITE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN` before use.
-
-## Safety
-
-Read-only — only GET requests permitted.

package/plugins/notion-agent/.claude-plugin/plugin.json

@@ -1,6 +0,0 @@
-{
-  "name": "notion-agent-plugin",
-  "version": "1.1.0",
-  "description": "Read-only Notion connector for Claude Code. Built on narai-primitives (subpath ./notion).",
-  "author": "narai"
-}

package/plugins/notion-agent/commands/notion-agent.md

@@ -1,6 +0,0 @@
----
-description: Run a read-only Notion query via the notion-agent connector
-argument-hint: "<action> <params-json>"
----
-
-Invoke the `notion-agent` skill with the user's $ARGUMENTS as the action name and params JSON. Return the connector's JSON envelope verbatim.

package/plugins/notion-agent/hooks/hooks.json

@@ -1,49 +0,0 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (mkdir -p \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/\" && cd \"${CLAUDE_PLUGIN_DATA}\" && npm install --no-audit --no-fund) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/reminder.mjs\" 2>/dev/null || true"
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/stale-summarize.mjs\" 2>/dev/null || true",
-            "env": { "USAGE_CONNECTOR_NAME": "notion" }
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/usage-record.mjs\" 2>/dev/null || true",
-            "env": {
-              "USAGE_CONNECTOR_NAME": "notion",
-              "USAGE_BIN_HINT": "narai-primitives/dist/connectors/notion"
-            }
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_DATA}/node_modules/narai-primitives/plugin-hooks/session-summary.mjs\" 2>/dev/null || true",
-            "env": { "USAGE_CONNECTOR_NAME": "notion" }
-          }
-        ]
-      }
-    ]
-  }
-}

package/plugins/notion-agent/hooks/reminder.mjs

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-/**
- * SessionStart curation reminder for the Notion connector.
- * See Confluence connector for pattern docs.
- */
-try {
-  const data = process.env.CLAUDE_PLUGIN_DATA;
-  if (!data) process.exit(0);
-  const toolkitEntry = `${data}/node_modules/narai-primitives/dist/toolkit/plugin/reminder.js`;
-  const mod = await import(toolkitEntry);
-  const decision = mod.evaluateNudge({ connectors: ["notion"] });
-  if (decision.nudge) {
-    process.stdout.write(decision.banner + "\n");
-  }
-} catch {
-  // best-effort — reminder never blocks startup
-}

package/plugins/notion-agent/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "notion-agent-plugin-runtime",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-    "narai-primitives": "^2.0.0"
-  }
-}

package/plugins/notion-agent/skills/notion-agent/SKILL.md

@@ -1,48 +0,0 @@
----
-name: notion-agent
-description: |
-  Use when the user asks about read-only Notion workspace content — search,
-  page contents, database schema, or database queries. Never modifies Notion.
-context: fork
----
-
-# Notion Agent
-
-Answer the user's question by invoking the `notion-agent` binary exposed
-by this plugin. It delegates to `narai-primitives/notion`, which
-speaks to the Notion Public API with a `NOTION_TOKEN` integration secret.
-
-## Invocation
-
-```
-notion-agent --action <action> --params '<json>'
-```
-
-Return the JSON envelope from the CLI verbatim.
-
-## Supported actions
-
-| Action | Required params |
-|---|---|
-| `search` | `query`, optional `filter_type` (`page`/`database`), optional `max_results` (default 25, max 100) |
-| `get_page` | `page_id` (UUID) |
-| `get_database` | `database_id` (UUID) |
-| `query_database` | `database_id`, optional `filter` object, optional `max_results` |
-
-Example:
-
-```bash
-notion-agent --action search --params '{"query":"architecture","filter_type":"page"}'
-```
-
-## Credentials
-
-Set `NOTION_TOKEN` to a Notion internal integration secret. The
-integration must be invited to the pages/databases you want to read.
-
-## Safety
-
-Read-only by construction: the connector's HTTP method whitelist allows
-`GET` plus only two narrow `POST` endpoints (`/v1/search` and
-`/v1/databases/{id}/query`, which Notion requires `POST` for despite
-being read). No other endpoints can be reached.