@hirey-ai/hirey 1.0.13

package/dist/utils/openclaw-config.js

@@ -0,0 +1,162 @@
+// 在 hi_agent_install 期间，把 OpenClaw 的 hooks 配置补齐到能让 daemon POST 进 /hooks/agent
+// 后真正 dispatch isolated agentTurn 的状态。等价于老 hi-platform/skills/openclaw-hi-install/
+// scripts/openclaw-host-installer.mjs 中 buildManagedHooksConfig() + `openclaw config set hooks <json>`，
+// 但 native plugin 跑 in-process，没法走 child_process 调 openclaw CLI（install scanner 会拦），
+// 所以直接 fs read-modify-write ~/.openclaw/openclaw.json。
+//
+// 同步源：/Users/lawrence/Code/Hi/hi-platform/skills/openclaw-hi-install/scripts/openclaw-host-installer.mjs
+//   - buildManagedHooksConfig (line 227)
+//   - phase1 hooks write (line 661–690)
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+export const OPENCLAW_CONFIG_PATH = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+const DEFAULT_HOOKS_PATH = '/hooks';
+const DEFAULT_ACTIVE_AGENT_PREFIX = 'agent:active:';
+function normalizeHooksPath(value) {
+    if (typeof value !== 'string')
+        return DEFAULT_HOOKS_PATH;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return DEFAULT_HOOKS_PATH;
+    return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+}
+function mergePrefixes(current, activeAgentPrefix) {
+    const set = new Set();
+    if (Array.isArray(current)) {
+        for (const entry of current) {
+            if (typeof entry === 'string' && entry.trim())
+                set.add(entry.trim());
+        }
+    }
+    set.add('hook:');
+    set.add(activeAgentPrefix);
+    return Array.from(set);
+}
+function buildManagedHooks(current, hooksPath, hooksToken, activeAgentPrefix) {
+    const base = (current && typeof current === 'object') ? { ...current } : {};
+    return {
+        ...base,
+        enabled: true,
+        path: normalizeHooksPath(hooksPath),
+        token: hooksToken,
+        allowRequestSessionKey: true,
+        allowedSessionKeyPrefixes: mergePrefixes(base.allowedSessionKeyPrefixes, activeAgentPrefix),
+    };
+}
+function hooksConfigSatisfies(current, desired) {
+    if (!current)
+        return false;
+    if (current.enabled !== true)
+        return false;
+    if (normalizeHooksPath(current.path) !== normalizeHooksPath(desired.path))
+        return false;
+    if (typeof current.token !== 'string' || !current.token.trim())
+        return false;
+    if (current.allowRequestSessionKey !== true)
+        return false;
+    if (!Array.isArray(current.allowedSessionKeyPrefixes))
+        return false;
+    const desiredPrefixes = desired.allowedSessionKeyPrefixes || [];
+    for (const want of desiredPrefixes) {
+        if (!current.allowedSessionKeyPrefixes.includes(want))
+            return false;
+    }
+    return true;
+}
+async function readOpenClawConfig() {
+    try {
+        const raw = await fs.readFile(OPENCLAW_CONFIG_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return { root: {}, hooks: null };
+        }
+        const hooks = parsed.hooks;
+        return {
+            root: parsed,
+            hooks: hooks && typeof hooks === 'object' && !Array.isArray(hooks) ? hooks : null,
+        };
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT')
+            return { root: {}, hooks: null };
+        throw err;
+    }
+}
+async function atomicWriteJson(file, value) {
+    const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(tmp, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+    await fs.rename(tmp, file);
+}
+// 主入口：保证 OpenClaw 的 hooks 段满足 native plugin daemon POST hooks/agent 的最小需求。
+// 已经满足就 noop；不满足就 read-modify-write 一次（atomic rename）。
+// 不破坏用户已有的 hooks 段下我们不管的字段（mappings、presets、transformsDir、gmail.* 等都保留）。
+export async function ensureOpenClawHooksConfigured(args) {
+    const hooksPath = normalizeHooksPath(args.hooksPath || DEFAULT_HOOKS_PATH);
+    const activeAgentPrefix = (args.activeAgentPrefix || DEFAULT_ACTIVE_AGENT_PREFIX).trim() || DEFAULT_ACTIVE_AGENT_PREFIX;
+    const { root, hooks: currentHooks } = await readOpenClawConfig();
+    const reuseToken = (typeof args.preferredToken === 'string' && args.preferredToken.trim()) ||
+        (typeof currentHooks?.token === 'string' && currentHooks.token.trim()) ||
+        crypto.randomBytes(24).toString('hex');
+    const desired = buildManagedHooks(currentHooks, hooksPath, reuseToken, activeAgentPrefix);
+    if (hooksConfigSatisfies(currentHooks, desired) && currentHooks?.token === reuseToken) {
+        return {
+            hooks_token: reuseToken,
+            hooks_path: desired.path,
+            hooks_file: OPENCLAW_CONFIG_PATH,
+            changed: false,
+            previous_hooks: currentHooks,
+            next_hooks: desired,
+        };
+    }
+    const nextRoot = { ...root, hooks: desired };
+    await atomicWriteJson(OPENCLAW_CONFIG_PATH, nextRoot);
+    return {
+        hooks_token: reuseToken,
+        hooks_path: desired.path,
+        hooks_file: OPENCLAW_CONFIG_PATH,
+        changed: true,
+        previous_hooks: currentHooks,
+        next_hooks: desired,
+    };
+}
+// 保证 OpenClaw 当前 tools.profile (coding/messaging 默认) 下 plugin tools 仍可被 LLM 看见。
+// OpenClaw 的 tool profile 是显式 allowlist —— coding profile 默认只允许 core 工具，plugin
+// 工具被 filter 掉。要打开必须在 tools.alsoAllow 里加 "group:plugins" (canonical 通用钩子)。
+//
+// 由 plugin install tool 程序化处理这件事，绝不让 LLM 自己改 tools.allow（LLM 容易把
+// alsoAllow 写成 allow，allow 是 explicit override 模式，会把 read/exec/sessions_* 等内置
+// 全 filter 掉，导致 LLM 下一轮没工具可用 → embedded fallback 报错 "No callable tools remain"）。
+export async function ensurePluginToolsAlsoAllowed() {
+    const { root } = await readOpenClawConfig();
+    const tools = (root.tools && typeof root.tools === 'object' && !Array.isArray(root.tools))
+        ? { ...root.tools }
+        : {};
+    const currentAlsoAllow = Array.isArray(tools.alsoAllow)
+        ? tools.alsoAllow.filter((x) => typeof x === 'string' && x.length > 0)
+        : [];
+    const wantToken = 'group:plugins';
+    if (currentAlsoAllow.includes(wantToken) || currentAlsoAllow.includes('*')) {
+        return { changed: false, also_allow_before: currentAlsoAllow, also_allow_after: currentAlsoAllow };
+    }
+    const nextAlsoAllow = [...currentAlsoAllow, wantToken];
+    tools.alsoAllow = nextAlsoAllow;
+    const nextRoot = { ...root, tools };
+    await atomicWriteJson(OPENCLAW_CONFIG_PATH, nextRoot);
+    return { changed: true, also_allow_before: currentAlsoAllow, also_allow_after: nextAlsoAllow };
+}
+// 工具函数：从 OpenClaw config root 读 gateway 监听端口（支持 user 自定义；默认 18789）。
+export function resolveGatewayPort(root) {
+    const gw = root?.gateway;
+    const port = Number(gw?.port);
+    if (Number.isFinite(port) && port > 0 && port < 65536)
+        return port;
+    return 18789;
+}
+export async function readGatewayPort() {
+    const { root } = await readOpenClawConfig();
+    return resolveGatewayPort(root);
+}
+//# sourceMappingURL=openclaw-config.js.map

package/dist/utils/openclaw-config.js.map

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

package/dist/utils/openclaw-hooks-payload.d.ts

@@ -0,0 +1,18 @@
+import type { AgentGatewayEventSnapshot, OpenClawHooksAgentEndpointConfig } from '@hirey-ai/agent-contracts';
+export declare function buildOpenClawHookPayloadWithRoute(args: {
+    event: AgentGatewayEventSnapshot;
+    config?: OpenClawHooksAgentEndpointConfig | Record<string, unknown> | null;
+}): {
+    message: string;
+    name: string;
+    agentId?: string;
+    sessionKey?: string;
+    wakeMode: string;
+    deliver: boolean;
+    channel?: string;
+    to?: string;
+    model?: string;
+    thinking?: string;
+    timeoutSeconds?: number;
+};
+//# sourceMappingURL=openclaw-hooks-payload.d.ts.map

package/dist/utils/openclaw-hooks-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-hooks-payload.d.ts","sourceRoot":"","sources":["../../src/utils/openclaw-hooks-payload.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,2BAA2B,CAAC;AAqBnC,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,KAAK,EAAE,yBAAyB,CAAC;IACjC,MAAM,CAAC,EAAE,gCAAgC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5E,GAAG;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CA6BA"}

package/dist/utils/openclaw-hooks-payload.js

@@ -0,0 +1,52 @@
+// 把 hi 平台 event 转成 OpenClaw /hooks/agent 接受的 hook payload。
+// 本文件是从 hirey-ai-agent-receiver/src/server.ts 复制过来的等价实现，让 native plugin 走的
+// 投递语义跟老 hirey-ai-agent-receiver daemon 完全一致。
+// 同步源：/Users/lawrence/Code/Hi/hi-agent-receiver/src/server.ts:173–217 (May 2026)
+//   - buildOpenClawContinuationMessage()
+//   - buildOpenClawHookPayloadWithRoute()
+// 改动后请同步两处。
+function normalizeText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function buildOpenClawContinuationMessage(event, messagePrefix) {
+    const parts = [];
+    if (messagePrefix)
+        parts.push(messagePrefix);
+    if (event?.preview?.text)
+        parts.push(String(event.preview.text));
+    parts.push(JSON.stringify({
+        topic: event.topic,
+        resource_ref: event.resource_ref || {},
+        payload: event.payload || {},
+    }));
+    return parts.filter(Boolean).join('\n\n');
+}
+export function buildOpenClawHookPayloadWithRoute(args) {
+    const config = (args.config || {});
+    const routeSnapshot = args.event?.reply_route_snapshot && typeof args.event.reply_route_snapshot === 'object'
+        ? args.event.reply_route_snapshot
+        : {};
+    const deliveryContext = routeSnapshot.delivery_context && typeof routeSnapshot.delivery_context === 'object'
+        ? routeSnapshot.delivery_context
+        : {};
+    const messagePrefix = normalizeText(config.message_prefix) || null;
+    const explicitSessionKey = normalizeText(routeSnapshot.session_key || config.session_key) || null;
+    const shouldSendLegacySessionKey = config.send_session_key === true && !explicitSessionKey;
+    const sessionKeyPrefix = normalizeText(config.session_key_prefix) || 'hi';
+    return {
+        message: buildOpenClawContinuationMessage(args.event, messagePrefix),
+        name: normalizeText(config.name) || 'Hi',
+        agentId: normalizeText(config.agent_id) || undefined,
+        ...(explicitSessionKey
+            ? { sessionKey: explicitSessionKey }
+            : (shouldSendLegacySessionKey ? { sessionKey: `${sessionKeyPrefix}:${args.event.event_id}` } : {})),
+        wakeMode: normalizeText(config.wake_mode) || 'now',
+        deliver: config.deliver !== false,
+        channel: normalizeText(deliveryContext.channel || config.channel) || undefined,
+        to: normalizeText(deliveryContext.to || config.to) || undefined,
+        model: normalizeText(config.model) || undefined,
+        thinking: normalizeText(config.thinking) || undefined,
+        timeoutSeconds: Number(config.timeout_seconds || 0) || undefined,
+    };
+}
+//# sourceMappingURL=openclaw-hooks-payload.js.map

package/dist/utils/openclaw-hooks-payload.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,83 @@
+{
+  "id": "hirey",
+  "name": "Hirey AI",
+  "description": "Hirey Hi for OpenClaw — register Hi's tools, agent-events claim service, and webhook ingress in-process. People-to-people matching for jobs, hiring, housing, friendship, dating, founders, investors, lawyers, and any other human-lead goal.",
+  "version": "0.1.0",
+  "kind": "service",
+  "activation": {
+    "onStartup": true,
+    "onCapabilities": ["tool", "service"],
+    "onCommands": []
+  },
+  "contracts": {
+    "tools": [
+      "hi_agent_status",
+      "hi_agent_doctor",
+      "hi_agent_install",
+      "hi_agent_reset",
+      "hi_pull_events",
+      "agent_listings",
+      "matching_sessions",
+      "pairings",
+      "thread_meetings",
+      "conversations",
+      "listing_taxonomy",
+      "agent_credits",
+      "content_get",
+      "content_render",
+      "faq_get",
+      "faq_search",
+      "social_org",
+      "social_permissions",
+      "social_relationships"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "platformBaseUrl": {
+        "type": "string",
+        "description": "Hirey Hi platform base URL. Defaults to the Hirey AI public service.",
+        "default": "https://hi.hirey.ai"
+      },
+      "profile": {
+        "type": "string",
+        "description": "Hi MCP profile name. Used to namespace persisted identity / receiver state on disk.",
+        "default": "openclaw-main"
+      },
+      "stateDir": {
+        "type": "string",
+        "description": "Filesystem dir for persisted hi identity / receiver runtime cursor. Default ~/.openclaw/hi-mcp/<profile>.",
+        "default": ""
+      },
+      "webhookPath": {
+        "type": "string",
+        "description": "Plugin-owned HTTP path on the gateway where the in-process receiver service delivers Hi events back into the current LLM session. Default /hi/webhook.",
+        "default": "/hi/webhook"
+      },
+      "claimPollIntervalMs": {
+        "type": "integer",
+        "description": "How often the in-process agent-events claim loop polls the platform when the long-poll connection is idle.",
+        "default": 1500,
+        "minimum": 250
+      },
+      "claimLeaseMs": {
+        "type": "integer",
+        "description": "Per-claim lease length the loop requests from the platform.",
+        "default": 60000,
+        "minimum": 1000
+      }
+    }
+  },
+  "uiHints": {
+    "platformBaseUrl": {
+      "label": "Platform base URL",
+      "placeholder": "https://hi.hirey.ai"
+    },
+    "profile": {
+      "label": "Hi MCP profile",
+      "placeholder": "openclaw-main"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@hirey-ai/hirey",
+  "version": "1.0.13",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hirey-ai/hi-openclaw-plugin.git"
+  },
+  "homepage": "https://github.com/hirey-ai/hi-openclaw-plugin#readme",
+  "license": "UNLICENSED",
+  "description": "Hirey Hi as a native OpenClaw plugin: registers Hi tools, the agent-events claim service, and webhook ingress directly inside the gateway process \u2014 zero independent daemons, no `mcp.servers.hi` indirection, no per-run frozen tool inventory boundary. Same business logic as @hirey-ai/mcp-server / @hirey-ai/agent-receiver, but wired through OpenClaw's native register(api) instead of stdio MCP + spawned daemon. For OpenClaw 5.4+ via ClawPack `clawhub:hirey`; for OpenClaw 5.2 ~ 5.3 via npm fallback `openclaw plugins install npm:@hirey-ai/hirey` (same plugin code, ClawPack metadata path is broken on 5.2 ~ 5.3 ClawHub clients so we ship the same tarball through npm under the brand-name `@hirey-ai/hirey` for prod / `@hirey-ai/hirey` for early — npm `hirey` (unscoped) was rejected by npm typosquatting policy). OpenClaw 4.23 ~ 5.1 must use the prod ClawHub bundle `clawhub:hirey-compatible` because their runtime expects date-format `compat.pluginApi` and rejects newer ranges.",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.5.2",
+      "pluginApiComment": "OpenClaw \u5b98\u65b9 plugin SDK \u7ea6\u5b9a\uff1acompat.pluginApi \u662f OpenClaw runtime build \u7248\u672c\u7684 semver range\uff08\u4f8b\u5982 docs.openclaw.ai/plugins/sdk-setup \u793a\u4f8b\u5199 '>=2026.3.24-beta.2'\uff09\uff0c\u4e0d\u662f plugin SDK \u534f\u8bae\u53f7\u3002\u4e4b\u524d\u8fd9\u91cc\u5199 '1.0' \u662f\u9519\u7684\uff1a\u4efb\u4f55 OpenClaw runtime \u7684 build version\uff08\u90fd\u662f 2026.x.y\uff09\u8ddf semver range '1.0' \u6bd4\u90fd\u4e0d\u4f1a\u901a\uff0c\u6240\u4ee5 ClawHub install / npm install \u4e24\u6761\u8def\u5f84\u90fd\u4f1a\u88ab reject\u3002\u73b0\u5728\u6539\u6210 '>=2026.5.2'\uff1a\u8ddf README \u517c\u5bb9\u77e9\u9635\u4e2d ClawPack \u3001 npm fallback \u7684\u6709\u6548\u4e0b\u754c\u5bf9\u9f50\uff085.4+ \u8d70 ClawPack\uff0c5.2 ~ 5.3 \u8d70 npm fallback\uff094.23 ~ 5.1 \u4f9d\u7136\u8d70 bundle\uff0c\u4e0d\u8fc7\u8fd9\u4e2a\u5b57\u6bb5\u4e5f\u4f1a\u770b\u5230\uff0c\u5b83\u4eec\u62ff\u81ea\u5df1 build \u7248\u672c \u540c '>=2026.5.2' \u6bd4\u4f1a fail close\uff0c\u8fd9\u662f\u5e0c\u671b\u7684\u884c\u4e3a\uff08\u907f\u514d 4.x runtime \u52a0\u8f7d\u624d \u53d1\u73b0 SDK \u4e0d\u5339\u914d\uff09\u3002"
+    },
+    "build": {
+      "openclawVersion": "2026.5.6"
+    },
+    "install": {
+      "minHostVersion": ">=2026.5.2",
+      "minHostVersionComment": "\u8ddf compat.pluginApi \u540c\u6b65\u62c9\u5230 5.2\u3002OpenClaw 5.4+ \u8d70 ClawPack `clawhub:hirey`\uff1bOpenClaw 5.2 ~ 5.3 ClawPack \u4f1a\u7531\u4e8e ClawHub server \u4e0d\u7ed9\u65e7 client sha256hash + files[] metadata \u5931\u8d25\uff08\u8ddf plugin manifest \u65e0\u5173\uff09\uff0c\u8d70 npm fallback `openclaw plugins install npm:hirey` \u80fd\u7a33\u88c5\u3002\u4e4b\u524d\u8fd9\u91cc\u9501 5.4 \u662f\u4e3a\u4e86\u9632\u540e\u9762\u4e24\u6863 ClawPack\uff1bnpm fallback \u8def\u5f84\u4e0d\u5728 ClawHub server\uff0c\u4e0d\u6491 5.4 \u9501\uff0c\u63d0\u524d\u5230 5.2\u3002"
+    }
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "tsx --test src/**/*.test.ts",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.5.2"
+  },
+  "dependencies": {
+    "@hirey-ai/agent-contracts": "^0.1.15",
+    "@hirey-ai/agent-sdk": "^0.1.10"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.37",
+    "openclaw": "2026.5.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}