@honeybee-ai/waggle-cli 1.0.0

package/dist/lib/hooks.js

@@ -0,0 +1,75 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+function getHooksDir() {
+    // Resolve from the cli.js binary path (works for both tsc and esbuild output)
+    const cliPath = process.argv[1] || '';
+    return join(dirname(dirname(cliPath)), 'hooks');
+}
+function getSettingsPath() {
+    return join(process.cwd(), '.claude', 'settings.local.json');
+}
+function loadSettings() {
+    const path = getSettingsPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveSettings(settings) {
+    const path = getSettingsPath();
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(settings, null, 2) + '\n');
+}
+export function installHooks(timeout = 10) {
+    const hooksDir = getHooksDir();
+    const settings = loadSettings();
+    if (!settings.hooks)
+        settings.hooks = {};
+    const hookDefs = [
+        { event: 'SessionStart', script: 'session-start.sh' },
+        { event: 'PreToolUse', script: 'pre-tool-use.sh', matcher: 'Edit|Write' },
+        { event: 'PostToolUse', script: 'post-tool-use.sh', matcher: 'Edit|Write' },
+        { event: 'Stop', script: 'stop.sh' },
+        { event: 'UserPromptSubmit', script: 'prompt-submit.sh' },
+    ];
+    for (const def of hookDefs) {
+        const command = `bash ${join(hooksDir, def.script)}`;
+        if (!settings.hooks[def.event])
+            settings.hooks[def.event] = [];
+        // Don't add duplicates
+        const existing = settings.hooks[def.event].find(h => h.command.includes('waggle-cli') || h.command.includes('/cli/hooks/'));
+        if (existing) {
+            existing.command = command;
+            existing.timeout = timeout;
+            if (def.matcher)
+                existing.matcher = def.matcher;
+        }
+        else {
+            const entry = { type: 'command', command, timeout };
+            if (def.matcher)
+                entry.matcher = def.matcher;
+            settings.hooks[def.event].push(entry);
+        }
+    }
+    saveSettings(settings);
+}
+export function uninstallHooks() {
+    const settings = loadSettings();
+    if (!settings.hooks)
+        return;
+    for (const event of Object.keys(settings.hooks)) {
+        settings.hooks[event] = settings.hooks[event].filter(h => !h.command.includes('waggle-cli') && !h.command.includes('/cli/hooks/'));
+        if (settings.hooks[event].length === 0)
+            delete settings.hooks[event];
+    }
+    if (Object.keys(settings.hooks).length === 0)
+        delete settings.hooks;
+    saveSettings(settings);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/lib/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"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"}

package/dist/lib/id.d.ts

@@ -0,0 +1 @@
+export declare function generateAgentId(): string;

package/dist/lib/id.js

@@ -0,0 +1,5 @@
+import { randomBytes } from 'node:crypto';
+export function generateAgentId() {
+    return `wgl_${randomBytes(4).toString('hex')}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/lib/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/lib/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export interface WglConfig {
+    server: string;
+    namespace: string;
+    agentId: string;
+    role: string;
+    autoClaimFiles: boolean;
+    autoPublishDiscoveries: boolean;
+    hookTimeout: number;
+    lastEventCursor: number;
+}
+export interface HookInput {
+    hook_event_name: string;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+    prompt?: string;
+    transcript_path?: string;
+    session_id?: string;
+}
+export interface HookOutput {
+    decision?: 'block' | 'approve';
+    reason?: string;
+    additionalContext?: string;
+    hookSpecificOutput?: Record<string, unknown>;
+}
+export type { Claim, ClaimResult, IncubatorEvent, Discovery, Message, HelpRequest, RoleAssignment, ProgressReport, ControlStatus, ProtocolSpec, AcpClientConfig, } from '@agentcoordinationprotocol/sdk';
+export type { MarketplaceSpec, PaginatedResponse, PublishSpecInput, Swarm, CreateSwarmInput, ColonyApiKey, CreateKeyInput, ScanResult, ScanFinding, AuthProfile, AuthStore, } from '@honeybee-ai/sdk';

package/dist/types.js

@@ -0,0 +1,3 @@
+// CLI-specific types (not extracted to SDKs)
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C"}

package/hooks/post-tool-use.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# waggle-cli PostToolUse hook (Edit|Write)
+# Publishes discovery about file changes, reports progress
+set +x
+
+WGL_CONFIG="$(pwd)/.wgl.json"
+[ ! -f "$WGL_CONFIG" ] && exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$(dirname "$SCRIPT_DIR")/dist"
+
+INPUT=$(cat)
+echo "$INPUT" | node "$DIST_DIR/hook.js" post-tool-use "$WGL_CONFIG" 2>/dev/null || exit 0

package/hooks/pre-tool-use.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# waggle-cli PreToolUse hook (Edit|Write)
+# Checks halt status, auto-claims files before edits
+set +x
+
+WGL_CONFIG="$(pwd)/.wgl.json"
+[ ! -f "$WGL_CONFIG" ] && exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$(dirname "$SCRIPT_DIR")/dist"
+
+INPUT=$(cat)
+echo "$INPUT" | node "$DIST_DIR/hook.js" pre-tool-use "$WGL_CONFIG" 2>/dev/null || exit 0

package/hooks/prompt-submit.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# waggle-cli UserPromptSubmit hook
+# Checks halt status, fetches new events, injects summary
+set +x
+
+WGL_CONFIG="$(pwd)/.wgl.json"
+[ ! -f "$WGL_CONFIG" ] && exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$(dirname "$SCRIPT_DIR")/dist"
+
+INPUT=$(cat)
+echo "$INPUT" | node "$DIST_DIR/hook.js" prompt-submit "$WGL_CONFIG" 2>/dev/null || exit 0

package/hooks/session-start.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# waggle-cli SessionStart hook
+# Exports env vars, checks control status, injects coordination context
+set +x
+
+WGL_CONFIG="$(pwd)/.wgl.json"
+[ ! -f "$WGL_CONFIG" ] && exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$(dirname "$SCRIPT_DIR")/dist"
+
+INPUT=$(cat)
+echo "$INPUT" | node "$DIST_DIR/hook.js" session-start "$WGL_CONFIG" 2>/dev/null || exit 0

package/hooks/stop.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# waggle-cli Stop hook
+# Checks for unread messages, releases claims, publishes session complete
+set +x
+
+WGL_CONFIG="$(pwd)/.wgl.json"
+[ ! -f "$WGL_CONFIG" ] && exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$(dirname "$SCRIPT_DIR")/dist"
+
+INPUT=$(cat)
+echo "$INPUT" | node "$DIST_DIR/hook.js" stop "$WGL_CONFIG" 2>/dev/null || exit 0

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@honeybee-ai/waggle-cli",
+  "version": "1.0.0",
+  "description": "Bridge AI agents to ACP coordination servers",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "wgl": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "hooks",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "build:types": "tsc --emitDeclarationOnly",
+    "build:tsc": "tsc",
+    "test": "pnpm run build:tsc && node --test test/*.test.js",
+    "prepublishOnly": "pnpm run build"
+  },
+  "keywords": [
+    "acp",
+    "agent-coordination",
+    "claude-code",
+    "hooks",
+    "ai-agent",
+    "swarm",
+    "honeybee"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "author": "Honeybee AI <hello@honeyb.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/honeybee-ai/waggle-cli"
+  },
+  "peerDependencies": {
+    "@agentcoordinationprotocol/spec": ">=0.2.0",
+    "@honeybee-ai/carapace": ">=1.0.0",
+    "@honeybee-ai/incubator": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@honeybee-ai/carapace": {
+      "optional": true
+    },
+    "@honeybee-ai/incubator": {
+      "optional": true
+    },
+    "@agentcoordinationprotocol/spec": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@agentcoordinationprotocol/sdk": "^0.1.0",
+    "@honeybee-ai/sdk": "^0.1.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild"]
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.7.0"
+  }
+}