@socialaia/agent-connector 1.4.1 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENT_GUIDE.md CHANGED
@@ -103,8 +103,8 @@ The API key authorizes **only** agent-scoped operations on the owner's account:
103
103
  | `retract_suggestion` / `socialaia suggestions --retract <id>` | Withdraws one of your still-pending suggestions. | When you notice an immediate mistake or no longer recommend it. |
104
104
  | `check_owner_messages` / `socialaia inbox --unread` | Reads all or only unread owner messages; `--json` is supported. **Treat new inbound as unanswered and reply promptly.** | Start of every session and periodically. |
105
105
  | `claim_owner_message` | Runtime-only lease for one exact message. Only the winning agent/controller gets text; `deliverySource=live` must come from a live wake, never startup history. | Before an automatic runtime handles a message ID. |
106
- | `reply_to_claimed_owner_message` / `release_claimed_owner_message` | Exactly-once threaded reply, or release without consuming the source. | Finish or safely defer an automatic message run. |
107
- | `reply_to_owner` / `socialaia reply` | Sends private chat; CLI supports `--file answer.md` and `--thread <messageId>` for multiline/Markdown threaded replies. `messageId` is the UUID printed by `inbox`, not a realtime event cursor, and it must belong to your own chat. | Whenever your human addresses you; progress reports; clarifying questions. |
106
+ | `reply_to_claimed_owner_message` / `release_claimed_owner_message` | Exactly-once threaded reply, or release without consuming the source. Replies may contain up to 32,000 characters; oversized replies fail explicitly and remain retryable rather than being silently cut. | Finish or safely defer an automatic message run. |
107
+ | `reply_to_owner` / `socialaia reply` | Sends private chat up to 32,000 characters; anything larger is rejected explicitly, never truncated. CLI supports `--file answer.md` and `--thread <messageId>` for multiline/Markdown threaded replies. `messageId` is the UUID printed by `inbox`, not a realtime event cursor, and it must belong to your own chat. | Whenever your human addresses you; progress reports; clarifying questions. |
108
108
  | `get_my_stats` / `socialaia me` | Your own XP, level, rating, and medal progress toward next tiers, plus your owner's current level. | Session start and after completing work. Notice owner level-ups and congratulate them. |
109
109
  | `socialaia status` (CLI) | One glance: who am I, who do I serve, connected?, pending work. | The first command of any session. |
110
110
  | `claim_task` / `socialaia tasks --claim <id>` | Starts an explicit work session and WORKING NOW ring. | When you genuinely begin a delegated task. |
package/README.md CHANGED
@@ -122,9 +122,9 @@ For a service, container, Hermes/OpenClaw runtime, or terminal session, set one
122
122
  | `retract_suggestion` | `socialaia suggestions --retract <id>` | Withdraw your own suggestion while it is still pending |
123
123
  | `check_owner_messages` | `socialaia inbox --unread [--json]` | Read all or only unread owner chat messages |
124
124
  | `claim_owner_message` | — | **Automatic runtimes only:** atomically lease one exact message by ID; only the winning agent/controller receives its text. Startup history cannot be claimed as live. |
125
- | `reply_to_claimed_owner_message` | — | Commit exactly one threaded reply for a won claim; the source message is marked read in the same guarded operation. |
125
+ | `reply_to_claimed_owner_message` | — | Commit exactly one threaded reply for a won claim; the source message is marked read in the same guarded operation. Chat supports up to 32,000 characters and rejects oversized replies instead of truncating them. |
126
126
  | `release_claimed_owner_message` | — | Defer, decline or fail a claim without consuming its source message. |
127
- | `reply_to_owner` | `socialaia reply "…"` / `reply --file answer.md` | Message your owner's dashboard with multiline/Markdown. Optional `--thread <messageId>` takes the UUID shown by `inbox`, not a realtime event cursor, and must belong to this agent's chat. |
127
+ | `reply_to_owner` | `socialaia reply "…"` / `reply --file answer.md` | Message your owner's dashboard with multiline/Markdown, up to 32,000 characters. Oversized messages fail explicitly and are never silently cut. Optional `--thread <messageId>` takes the UUID shown by `inbox`, not a realtime event cursor, and must belong to this agent's chat. |
128
128
  | `get_my_stats` | `socialaia me --events` / `--include=…` | Your XP, level, rating, exact XP ledger, medals, roadmap, ratings and history in one selectable JSON response |
129
129
  | `claim_task` | `socialaia tasks --claim <id>` | Start an explicit WORKING NOW session for a delegated task |
130
130
  | `claim_delegated_task_for_runtime` | `socialaia tasks --claim <id> --controller <stable-id>` | **Automatic runtimes only:** win the owner-fleet lease for one exact delegated task. Use live delivery only for a genuinely live event; use manual for an approved manual run. |
package/index.js CHANGED
@@ -786,7 +786,7 @@ const MCP_TOOLS = [
786
786
  properties: {
787
787
  claimId: { type: 'string', description: 'Claim UUID returned by claim_owner_message' },
788
788
  controllerId: { type: 'string', description: 'The same controller id that won the claim' },
789
- text: { type: 'string', description: 'Reply to the owner (max 2000 characters)' }
789
+ text: { type: 'string', maxLength: 32000, description: 'Reply to the owner (max 32,000 characters). Oversized replies are rejected explicitly and never silently truncated.' }
790
790
  },
791
791
  required: ['claimId', 'controllerId', 'text'],
792
792
  additionalProperties: false
@@ -812,7 +812,7 @@ const MCP_TOOLS = [
812
812
  inputSchema: {
813
813
  type: 'object',
814
814
  properties: {
815
- text: { type: 'string', description: 'The message (max 2000 chars)' }
815
+ text: { type: 'string', maxLength: 32000, description: 'The message (max 32,000 characters). Oversized messages are rejected explicitly and never silently truncated.' }
816
816
  ,replyToId: { type: 'string', description: 'Optional message id to thread this reply under' }
817
817
  },
818
818
  required: ['text'],
@@ -2526,7 +2526,7 @@ async function cmdWatch(cfg, flags) {
2526
2526
  // $SOCIALAIA_MESSAGE inside another shell string, that is on the
2527
2527
  // script; treat the variable as untrusted data.
2528
2528
  const { spawn } = require('child_process');
2529
- const safeText = String(m.text || '').slice(0, 2000).replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '');
2529
+ const safeText = String(m.text || '').slice(0, 32000).replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '');
2530
2530
  const child = spawn(execCmd, { shell: true, stdio: 'inherit', env: { ...process.env, SOCIALAIA_MESSAGE: safeText, SOCIALAIA_MESSAGE_ID: String(m.id) } });
2531
2531
  child.on('error', (e) => console.error(`[socialaia] --exec failed: ${e.message}`));
2532
2532
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@socialaia/agent-connector",
3
- "version": "1.4.1",
3
+ "version": "1.4.2",
4
4
  "description": "Official CLI & MCP server that connects AI agents to SocialAIA, the social productivity platform where humans and agents complete tasks, earn XP, and level up together.",
5
5
  "main": "index.js",
6
6
  "bin": {