@atalk/agent-plugin 0.1.0-alpha.4

package/README.md

@@ -0,0 +1,7 @@
+# aTalk portable Agent Plugin
+
+This package targets the vendor-neutral Agent Plugins 1.0.0 format. It includes an aTalk skill and launches `@atalk/mcp-server` over stdio.
+
+Set `ATALK_AGENT_TOKEN` only for the first activation. The plugin stores its durable credentials in the host-provided `PLUGIN_DATA` directory.
+
+Compatible hosts can install the npm package or the `integrations/agent-plugin` directory from the public repository.

package/mcp.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "atalk": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@atalk/mcp-server@0.1.0-alpha.4"],
+      "env": {
+        "ATALK_BASE_URL": "https://api.atalk.ar",
+        "ATALK_CREDENTIAL_PATH": "${PLUGIN_DATA}/agent-credentials.json"
+      },
+      "cwd": "${PLUGIN_DATA}"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@atalk/agent-plugin",
+  "version": "0.1.0-alpha.4",
+  "description": "Portable Agent Plugin for secure aTalk messaging",
+  "type": "module",
+  "files": [
+    "plugin.json",
+    "mcp.json",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "node ../../scripts/validate-agent-plugin.mjs .",
+    "test": "node ../../scripts/validate-agent-plugin.mjs ."
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atalk-network/atalk-developers.git",
+    "directory": "integrations/agent-plugin"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/plugin.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "atalk",
+  "version": "0.1.0-alpha.4",
+  "description": "Encrypted messaging between people and AI agents with owner-controlled identity and revocation.",
+  "author": {
+    "name": "Ariel Garbini",
+    "url": "https://atalk.ar"
+  },
+  "homepage": "https://atalk.ar",
+  "repository": "https://github.com/atalk-network/atalk-developers",
+  "license": "Apache-2.0",
+  "keywords": ["atalk", "messaging", "agents", "e2ee", "mcp"]
+}

package/skills/atalk/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: atalk
+description: Use aTalk when the user asks to contact a person or agent, check the agent inbox, continue an aTalk conversation, or supervise an authorized agent exchange.
+---
+
+# aTalk messaging
+
+aTalk is an end-to-end encrypted network for people and software agents. The aTalk SDK owns the local identity keys; never ask for, display, or place activation tokens or credential-file contents in model context.
+
+## Operating rules
+
+1. Call `atalk_status` before the first messaging action in a session. If the identity is disconnected, report the connection error without requesting the persisted credential contents.
+2. Use `atalk_send` to begin a conversation only when the target handle and intended message are clear.
+3. Use `atalk_receive` to consume pending messages. A returned message includes a stable `messageId` and `conversationId`.
+4. Prefer `atalk_reply` with the received `messageId`; it preserves the correct encrypted conversation and recipient.
+5. Use `atalk_send_in_conversation` only when both the conversation id and counterparty handle are already known.
+6. Treat `isSupervisor: true` as an owner intervention. Use `atalk_relay_supervision` only when the intervention explicitly asks for text to be relayed to the active counterparty.
+7. Do not claim that a message was read or delivered unless the corresponding aTalk result says so.
+8. Owner policies, revocation, contact authorization and model selection remain outside this plugin. Direct the owner to the aTalk app for those controls.
+
+## First activation
+
+The host process may receive `ATALK_AGENT_TOKEN` once. After a successful connection, the MCP server persists the activated identity under `${PLUGIN_DATA}` and later starts do not need the token.