@agentchatme/openclaw 0.8.0 → 0.9.0

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.
Files changed (39) hide show
  1. package/CHANGELOG.md +32 -1
  2. package/README.md +72 -70
  3. package/RUNBOOK.md +54 -41
  4. package/SECURITY.md +8 -5
  5. package/dist/binding/agents-anchor.cjs +24 -20
  6. package/dist/binding/agents-anchor.cjs.map +1 -1
  7. package/dist/binding/agents-anchor.d.cts +38 -31
  8. package/dist/binding/agents-anchor.d.ts +38 -31
  9. package/dist/binding/agents-anchor.js +24 -18
  10. package/dist/binding/agents-anchor.js.map +1 -1
  11. package/dist/credentials/read-env.cjs +16 -7
  12. package/dist/credentials/read-env.cjs.map +1 -1
  13. package/dist/credentials/read-env.d.cts +26 -10
  14. package/dist/credentials/read-env.d.ts +26 -10
  15. package/dist/credentials/read-env.js +12 -6
  16. package/dist/credentials/read-env.js.map +1 -1
  17. package/dist/index.cjs +978 -1421
  18. package/dist/index.cjs.map +1 -1
  19. package/dist/index.d.cts +155 -721
  20. package/dist/index.d.ts +155 -721
  21. package/dist/index.js +969 -1415
  22. package/dist/index.js.map +1 -1
  23. package/dist/openclaw-layout.cjs.map +1 -1
  24. package/dist/openclaw-layout.d.cts +1 -1
  25. package/dist/openclaw-layout.d.ts +1 -1
  26. package/dist/openclaw-layout.js.map +1 -1
  27. package/dist/setup-entry-Dq5Dwg8O.d.cts +655 -0
  28. package/dist/setup-entry-Dq5Dwg8O.d.ts +655 -0
  29. package/dist/setup-entry.cjs +967 -1427
  30. package/dist/setup-entry.cjs.map +1 -1
  31. package/dist/setup-entry.d.cts +2 -1
  32. package/dist/setup-entry.d.ts +2 -1
  33. package/dist/setup-entry.js +968 -1428
  34. package/dist/setup-entry.js.map +1 -1
  35. package/openclaw.plugin.json +6 -12
  36. package/package.json +6 -6
  37. package/skills/agentchat/SKILL.md +132 -78
  38. package/dist/setup-entry-DU51IFUF.d.cts +0 -154
  39. package/dist/setup-entry-DU51IFUF.d.ts +0 -154
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/openclaw-layout.ts"],"names":["os","path","readOpenClawStateDirFromEnv","readOpenClawProfileFromEnv","readOpenClawWorkspaceDirFromEnv"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCO,IAAM,gBAAA,GAAmB;AAWhC,SAAS,SAAS,KAAA,EAAkD;AAClE,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAGO,SAAS,eAAe,KAAA,EAAuB;AACpD,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,IAAI,OAAA,KAAY,GAAA,EAAK,OAAUA,aAAA,CAAA,OAAA,EAAQ;AACvC,EAAA,IAAI,OAAA,CAAQ,UAAA,CAAW,IAAI,CAAA,IAAK,QAAQ,UAAA,CAAW,KAAK,CAAA,EAAG,OAAYC,qBAAQD,aAAA,CAAA,OAAA,EAAQ,EAAG,OAAA,CAAQ,KAAA,CAAM,CAAC,CAAC,CAAA;AAC1G,EAAA,OAAYC,wBAAQ,OAAO,CAAA;AAC7B;AAGO,SAAS,uBAAA,GAAkC;AAChD,EAAA,MAAM,WAAWC,sCAAA,EAA4B;AAC7C,EAAA,IAAI,QAAA,EAAU,OAAO,cAAA,CAAe,QAAQ,CAAA;AAC5C,EAAA,MAAM,UAAUC,qCAAA,EAA2B;AAC3C,EAAA,OAAYF,qBAAQD,aAAA,CAAA,OAAA,EAAQ,EAAG,UAAU,CAAA,UAAA,EAAa,OAAO,KAAK,WAAW,CAAA;AAC/E;AAGO,SAAS,kCAAA,GAA6C;AAC3D,EAAA,MAAM,WAAWI,0CAAA,EAAgC;AACjD,EAAA,IAAI,QAAA,EAAU,OAAYH,eAAA,CAAA,OAAA,CAAQ,QAAQ,CAAA;AAC1C,EAAA,OAAYA,eAAA,CAAA,IAAA,CAAK,uBAAA,EAAwB,EAAG,WAAW,CAAA;AACzD;AAGO,SAAS,yBAAyB,GAAA,EAA+C;AACtF,EAAA,MAAM,MAAA,GAAS,SAAS,GAAG,CAAA,IAAK,SAAS,GAAA,CAAI,MAAM,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,MAAA;AACpE,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,EAAC;AACrB,EAAA,IAAI,OAAO,MAAA,CAAO,MAAA,EAAQ,SAAS,CAAA,IAAK,MAAA,CAAO,YAAY,MAAA,EAAW;AACpE,IAAA,IAAI,CAAC,QAAA,CAAS,MAAA,CAAO,OAAO,CAAA,SAAU,EAAC;AACvC,IAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAA,CACjC,OAAO,CAAC,GAAG,KAAK,CAAA,KAAM,QAAA,CAAS,KAAK,CAAC,CAAA,CACrC,GAAA,CAAI,CAAC,CAAC,EAAA,EAAI,KAAK,CAAA,KAAM,OAAA,CAAQ,EAAA,EAAI,KAAgC,CAAC,CAAA;AAAA,EACvE;AACA,EAAA,IAAI,OAAO,MAAA,CAAO,MAAA,EAAQ,MAAM,CAAA,IAAK,MAAA,CAAO,SAAS,MAAA,EAAW;AAC9D,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,IAAI,CAAA,SAAU,EAAC;AACzC,IAAA,OAAO,MAAA,CAAO,KACX,MAAA,CAAO,CAAC,UAA4C,QAAA,CAAS,KAAK,KAAK,OAAO,KAAA,CAAM,OAAO,QAAQ,CAAA,CACnG,IAAI,CAAC,KAAA,KAAU,QAAQ,KAAA,CAAM,EAAA,EAAc,KAAK,CAAC,CAAA;AAAA,EACtD;AACA,EAAA,OAAO,EAAC;AACV;AAEA,SAAS,OAAA,CAAQ,IAAY,GAAA,EAAkD;AAC7E,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,EAAA,CAAG,IAAA,EAAK,CAAE,WAAA,EAAY;AAAA,IAC1B,GAAI,IAAI,OAAA,KAAY,IAAA,GAAO,EAAE,OAAA,EAAS,IAAA,KAAS,EAAC;AAAA,IAChD,GAAI,OAAO,GAAA,CAAI,SAAA,KAAc,YAAY,GAAA,CAAI,SAAA,CAAU,IAAA,EAAK,GAAI,EAAE,SAAA,EAAW,GAAA,CAAI,SAAA,KAAc;AAAC,GAClG;AACF;AAEA,SAAS,eAAe,GAAA,EAAkC;AACxD,EAAA,MAAM,MAAA,GAAS,SAAS,GAAG,CAAA,IAAK,SAAS,GAAA,CAAI,MAAM,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,MAAA;AACpE,EAAA,IAAI,CAAC,QAAQ,OAAO,KAAA;AACpB,EAAA,OAAQ,MAAA,CAAO,MAAA,CAAO,MAAA,EAAQ,SAAS,KAAK,MAAA,CAAO,OAAA,KAAY,MAAA,IAAe,MAAA,CAAO,MAAA,CAAO,MAAA,EAAQ,MAAM,CAAA,IAAK,OAAO,IAAA,KAAS,MAAA;AACjI;AAUO,SAAS,8BAA8B,GAAA,EAA6C;AACzF,EAAA,MAAM,MAAA,GAAS,SAAS,GAAG,CAAA,IAAK,SAAS,GAAA,CAAI,MAAM,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,MAAA;AACpE,EAAA,MAAM,OAAA,GAAU,yBAAyB,GAAG,CAAA;AAC5C,EAAA,IAAI,MAAA,EAAQ,cAAc,UAAA,EAAY;AACpC,IAAA,MAAM,SAAS,OAAA,CAAQ,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,YAAY,IAAI,CAAA;AAC/D,IAAA,IAAI,OAAO,MAAA,KAAW,CAAA,EAAG,OAAO,MAAA,CAAO,CAAC,CAAA,CAAG,EAAA;AAAA,EAC7C;AACA,EAAA,IAAI,QAAQ,MAAA,KAAW,CAAA,SAAU,cAAA,CAAe,GAAG,IAAI,MAAA,GAAY,gBAAA;AACnE,EAAA,OAAO,QAAQ,MAAA,KAAW,CAAA,GAAI,OAAA,CAAQ,CAAC,EAAG,EAAA,GAAK,MAAA;AACjD;AAQO,SAAS,mBAAA,CAAoB,GAAA,EAAyB,OAAA,EAAiB,SAAA,EAAmB,mBAAmB,SAAA,EAA+B;AACjJ,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAG,CAAA,GAAI,IAAI,QAAA,GAAW,MAAA;AAChD,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,QAAQ,GAAG,OAAO,MAAA;AACrC,EAAA,IAAI,QAAA;AACJ,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,IAAI,CAAC,QAAA,CAAS,OAAO,CAAA,IAAK,OAAO,OAAA,CAAQ,OAAA,KAAY,QAAA,IAAY,CAAC,QAAA,CAAS,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC3F,IAAA,MAAM,QAAQ,OAAA,CAAQ,KAAA;AACtB,IAAA,IAAI,KAAA,CAAM,YAAY,OAAA,EAAS;AAC/B,IAAA,IAAI,KAAA,CAAM,IAAA,KAAS,MAAA,IAAa,KAAA,CAAM,SAAS,IAAA,EAAM;AACrD,IAAA,MAAM,YAAA,GAAe,OAAO,KAAA,CAAM,SAAA,KAAc,WAAW,KAAA,CAAM,SAAA,CAAU,MAAK,GAAI,EAAA;AACpF,IAAA,IAAI,iBAAiB,SAAA,EAAW,OAAO,QAAQ,OAAA,CAAQ,IAAA,GAAO,WAAA,EAAY;AAC1E,IAAA,IAAI,YAAA,KAAiB,MAAM,SAAA,KAAc,gBAAA,SAAyB,OAAA,CAAQ,OAAA,CAAQ,IAAA,EAAK,CAAE,WAAA,EAAY;AACrG,IAAA,IAAI,YAAA,KAAiB,OAAO,QAAA,KAAa,MAAA,aAAsB,OAAA,CAAQ,OAAA,CAAQ,IAAA,EAAK,CAAE,WAAA,EAAY;AAAA,EACpG;AACA,EAAA,OAAO,QAAA;AACT;AAOO,SAAS,2BAAA,CAA4B,KAAyB,OAAA,EAA0B;AAC7F,EAAA,MAAM,EAAA,GAAA,CAAM,WAAW,6BAAA,CAA8B,GAAG,KAAK,gBAAA,EAAkB,IAAA,GAAO,WAAA,EAAY;AAClG,EAAA,MAAM,KAAA,GAAQ,yBAAyB,GAAG,CAAA,CAAE,KAAK,CAAC,SAAA,KAAc,SAAA,CAAU,EAAA,KAAO,EAAE,CAAA;AACnF,EAAA,IAAI,KAAA,EAAO,SAAA,EAAW,OAAO,cAAA,CAAe,MAAM,SAAS,CAAA;AAC3D,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAG,CAAA,IAAK,SAAS,GAAA,CAAI,MAAM,CAAA,IAAK,QAAA,CAAS,IAAI,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA,CAAI,OAAO,QAAA,GAAW,MAAA;AAChH,EAAA,MAAM,aAAa,QAAA,EAAU,SAAA;AAC7B,EAAA,IAAI,OAAO,UAAA,KAAe,QAAA,IAAY,UAAA,CAAW,IAAA,GAAO,MAAA,GAAS,CAAA,EAAG,OAAO,cAAA,CAAe,UAAU,CAAA;AACpG,EAAA,OAAO,kCAAA,EAAmC;AAC5C","file":"openclaw-layout.cjs","sourcesContent":["/**\n * Where OpenClaw keeps things — resolved the way OpenClaw resolves them.\n *\n * Pure: environment + config + `os.homedir()` in, paths and ids out. No\n * filesystem reads, no network. Every env read goes through\n * `credentials/read-env.ts`. One resolver, shared by the identity-line\n * placement (`binding/agents-anchor.ts`), the key placement\n * (`doorbell/placement.ts`), the gateway and the doctor, so the four never\n * disagree about which workspace or state dir an agent uses.\n *\n * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,\n * `src/agents/agent-roster.ts`, `src/config/paths.ts` in its dist):\n *\n * state dir = $OPENCLAW_STATE_DIR\n * | ~/.openclaw-<profile> when OPENCLAW_PROFILE is not \"default\"\n * | ~/.openclaw\n * workspace = agents.entries.<id>.workspace (or agents.list[].workspace)\n * | agents.defaults.workspace\n * | $OPENCLAW_WORKSPACE_DIR\n * | <state dir>/workspace\n * default agent = the one entry marked `default: true` (unless agents.ownership\n * is \"explicit\") | the sole entry | \"main\" when no roster exists\n */\n\nimport * as os from 'node:os'\nimport * as path from 'node:path'\n\nimport {\n readOpenClawProfileFromEnv,\n readOpenClawStateDirFromEnv,\n readOpenClawWorkspaceDirFromEnv,\n} from './credentials/read-env.js'\n\n/** OpenClaw's implicit agent id when no roster is configured. */\nexport const DEFAULT_AGENT_ID = 'main'\n\n/** The loosest config shape these readers need; the real `OpenClawConfig` satisfies it. */\nexport type OpenClawConfigLike = object | undefined\n\nexport interface OpenClawAgentEntry {\n readonly id: string\n readonly default?: boolean\n readonly workspace?: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** `~` and `~/…` → the home directory; anything else resolved as given. */\nexport function expandUserPath(value: string): string {\n const trimmed = value.trim()\n if (trimmed === '~') return os.homedir()\n if (trimmed.startsWith('~/') || trimmed.startsWith('~\\\\')) return path.join(os.homedir(), trimmed.slice(2))\n return path.resolve(trimmed)\n}\n\n/** OpenClaw's state dir: `$OPENCLAW_STATE_DIR`, else the profile dir, else `~/.openclaw`. */\nexport function resolveOpenClawStateDir(): string {\n const override = readOpenClawStateDirFromEnv()\n if (override) return expandUserPath(override)\n const profile = readOpenClawProfileFromEnv()\n return path.join(os.homedir(), profile ? `.openclaw-${profile}` : '.openclaw')\n}\n\n/** OpenClaw's default agent workspace: `$OPENCLAW_WORKSPACE_DIR`, else `<state dir>/workspace`. */\nexport function resolveOpenClawDefaultWorkspaceDir(): string {\n const override = readOpenClawWorkspaceDirFromEnv()\n if (override) return path.resolve(override)\n return path.join(resolveOpenClawStateDir(), 'workspace')\n}\n\n/** The agent roster from either representation OpenClaw accepts: `agents.entries` (record) or `agents.list` (array). */\nexport function listOpenClawAgentEntries(cfg: OpenClawConfigLike): OpenClawAgentEntry[] {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return []\n if (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) {\n if (!isRecord(agents.entries)) return []\n return Object.entries(agents.entries)\n .filter(([, entry]) => isRecord(entry))\n .map(([id, entry]) => toEntry(id, entry as Record<string, unknown>))\n }\n if (Object.hasOwn(agents, 'list') && agents.list !== undefined) {\n if (!Array.isArray(agents.list)) return []\n return agents.list\n .filter((entry): entry is Record<string, unknown> => isRecord(entry) && typeof entry.id === 'string')\n .map((entry) => toEntry(entry.id as string, entry))\n }\n return []\n}\n\nfunction toEntry(id: string, raw: Record<string, unknown>): OpenClawAgentEntry {\n return {\n id: id.trim().toLowerCase(),\n ...(raw.default === true ? { default: true } : {}),\n ...(typeof raw.workspace === 'string' && raw.workspace.trim() ? { workspace: raw.workspace } : {}),\n }\n}\n\nfunction hasAgentRoster(cfg: OpenClawConfigLike): boolean {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return false\n return (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) || (Object.hasOwn(agents, 'list') && agents.list !== undefined)\n}\n\n/**\n * The agent OpenClaw treats as the ambient default — the one `llm.complete`\n * uses when a plugin passes no `agentId`. Mirrors OpenClaw's\n * `tryResolveDefaultAgentId`: one entry marked `default: true` (unless the\n * roster declares `ownership: \"explicit\"`), else the sole entry, else `main`\n * when no roster exists. `undefined` when several agents exist and none is\n * marked — OpenClaw then has no single default either.\n */\nexport function resolveOpenClawDefaultAgentId(cfg: OpenClawConfigLike): string | undefined {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n const entries = listOpenClawAgentEntries(cfg)\n if (agents?.ownership !== 'explicit') {\n const marked = entries.filter((entry) => entry.default === true)\n if (marked.length === 1) return marked[0]!.id\n }\n if (entries.length === 0) return hasAgentRoster(cfg) ? undefined : DEFAULT_AGENT_ID\n return entries.length === 1 ? entries[0]!.id : undefined\n}\n\n/**\n * The agent an explicit `bindings[]` entry routes this channel account to,\n * if any. OpenClaw's `AgentBindingMatch`: `accountId` omitted/empty matches\n * only the channel default account, `\"*\"` matches every account, any other\n * string that account id.\n */\nexport function resolveBoundAgentId(cfg: OpenClawConfigLike, channel: string, accountId: string, defaultAccountId = 'default'): string | undefined {\n const bindings = isRecord(cfg) ? cfg.bindings : undefined\n if (!Array.isArray(bindings)) return undefined\n let wildcard: string | undefined\n for (const binding of bindings) {\n if (!isRecord(binding) || typeof binding.agentId !== 'string' || !isRecord(binding.match)) continue\n const match = binding.match\n if (match.channel !== channel) continue\n if (match.peer !== undefined && match.peer !== null) continue // peer-specific bindings route single conversations, not the account\n const matchAccount = typeof match.accountId === 'string' ? match.accountId.trim() : ''\n if (matchAccount === accountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '' && accountId === defaultAccountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '*' && wildcard === undefined) wildcard = binding.agentId.trim().toLowerCase()\n }\n return wildcard\n}\n\n/**\n * The workspace OpenClaw loads for `agentId` — the file `AGENTS.md` is read\n * from on every turn. Per-agent `workspace` first, then\n * `agents.defaults.workspace`, then the environment default.\n */\nexport function resolveOpenClawWorkspaceDir(cfg: OpenClawConfigLike, agentId?: string): string {\n const id = (agentId ?? resolveOpenClawDefaultAgentId(cfg) ?? DEFAULT_AGENT_ID).trim().toLowerCase()\n const entry = listOpenClawAgentEntries(cfg).find((candidate) => candidate.id === id)\n if (entry?.workspace) return expandUserPath(entry.workspace)\n const defaults = isRecord(cfg) && isRecord(cfg.agents) && isRecord(cfg.agents.defaults) ? cfg.agents.defaults : undefined\n const configured = defaults?.workspace\n if (typeof configured === 'string' && configured.trim().length > 0) return expandUserPath(configured)\n return resolveOpenClawDefaultWorkspaceDir()\n}\n"]}
1
+ {"version":3,"sources":["../src/openclaw-layout.ts"],"names":["os","path","readOpenClawStateDirFromEnv","readOpenClawProfileFromEnv","readOpenClawWorkspaceDirFromEnv"],"mappings":"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","file":"openclaw-layout.cjs","sourcesContent":["/**\n * Where OpenClaw keeps things — resolved the way OpenClaw resolves them.\n *\n * Pure: environment + config + `os.homedir()` in, paths and ids out. No\n * filesystem reads, no network. Every env read goes through\n * `credentials/read-env.ts`. One resolver, shared by the identity-line\n * placement (`binding/agents-anchor.ts`), the key placement\n * (`integration/placement.ts`), the gateway and the doctor, so the four never\n * disagree about which workspace or state dir an agent uses.\n *\n * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,\n * `src/agents/agent-roster.ts`, `src/config/paths.ts` in its dist):\n *\n * state dir = $OPENCLAW_STATE_DIR\n * | ~/.openclaw-<profile> when OPENCLAW_PROFILE is not \"default\"\n * | ~/.openclaw\n * workspace = agents.entries.<id>.workspace (or agents.list[].workspace)\n * | agents.defaults.workspace\n * | $OPENCLAW_WORKSPACE_DIR\n * | <state dir>/workspace\n * default agent = the one entry marked `default: true` (unless agents.ownership\n * is \"explicit\") | the sole entry | \"main\" when no roster exists\n */\n\nimport * as os from 'node:os'\nimport * as path from 'node:path'\n\nimport {\n readOpenClawProfileFromEnv,\n readOpenClawStateDirFromEnv,\n readOpenClawWorkspaceDirFromEnv,\n} from './credentials/read-env.js'\n\n/** OpenClaw's implicit agent id when no roster is configured. */\nexport const DEFAULT_AGENT_ID = 'main'\n\n/** The loosest config shape these readers need; the real `OpenClawConfig` satisfies it. */\nexport type OpenClawConfigLike = object | undefined\n\nexport interface OpenClawAgentEntry {\n readonly id: string\n readonly default?: boolean\n readonly workspace?: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** `~` and `~/…` → the home directory; anything else resolved as given. */\nexport function expandUserPath(value: string): string {\n const trimmed = value.trim()\n if (trimmed === '~') return os.homedir()\n if (trimmed.startsWith('~/') || trimmed.startsWith('~\\\\')) return path.join(os.homedir(), trimmed.slice(2))\n return path.resolve(trimmed)\n}\n\n/** OpenClaw's state dir: `$OPENCLAW_STATE_DIR`, else the profile dir, else `~/.openclaw`. */\nexport function resolveOpenClawStateDir(): string {\n const override = readOpenClawStateDirFromEnv()\n if (override) return expandUserPath(override)\n const profile = readOpenClawProfileFromEnv()\n return path.join(os.homedir(), profile ? `.openclaw-${profile}` : '.openclaw')\n}\n\n/** OpenClaw's default agent workspace: `$OPENCLAW_WORKSPACE_DIR`, else `<state dir>/workspace`. */\nexport function resolveOpenClawDefaultWorkspaceDir(): string {\n const override = readOpenClawWorkspaceDirFromEnv()\n if (override) return path.resolve(override)\n return path.join(resolveOpenClawStateDir(), 'workspace')\n}\n\n/** The agent roster from either representation OpenClaw accepts: `agents.entries` (record) or `agents.list` (array). */\nexport function listOpenClawAgentEntries(cfg: OpenClawConfigLike): OpenClawAgentEntry[] {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return []\n if (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) {\n if (!isRecord(agents.entries)) return []\n return Object.entries(agents.entries)\n .filter(([, entry]) => isRecord(entry))\n .map(([id, entry]) => toEntry(id, entry as Record<string, unknown>))\n }\n if (Object.hasOwn(agents, 'list') && agents.list !== undefined) {\n if (!Array.isArray(agents.list)) return []\n return agents.list\n .filter((entry): entry is Record<string, unknown> => isRecord(entry) && typeof entry.id === 'string')\n .map((entry) => toEntry(entry.id as string, entry))\n }\n return []\n}\n\nfunction toEntry(id: string, raw: Record<string, unknown>): OpenClawAgentEntry {\n return {\n id: id.trim().toLowerCase(),\n ...(raw.default === true ? { default: true } : {}),\n ...(typeof raw.workspace === 'string' && raw.workspace.trim() ? { workspace: raw.workspace } : {}),\n }\n}\n\nfunction hasAgentRoster(cfg: OpenClawConfigLike): boolean {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return false\n return (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) || (Object.hasOwn(agents, 'list') && agents.list !== undefined)\n}\n\n/**\n * The agent OpenClaw treats as the ambient default — the one `llm.complete`\n * uses when a plugin passes no `agentId`. Mirrors OpenClaw's\n * `tryResolveDefaultAgentId`: one entry marked `default: true` (unless the\n * roster declares `ownership: \"explicit\"`), else the sole entry, else `main`\n * when no roster exists. `undefined` when several agents exist and none is\n * marked — OpenClaw then has no single default either.\n */\nexport function resolveOpenClawDefaultAgentId(cfg: OpenClawConfigLike): string | undefined {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n const entries = listOpenClawAgentEntries(cfg)\n if (agents?.ownership !== 'explicit') {\n const marked = entries.filter((entry) => entry.default === true)\n if (marked.length === 1) return marked[0]!.id\n }\n if (entries.length === 0) return hasAgentRoster(cfg) ? undefined : DEFAULT_AGENT_ID\n return entries.length === 1 ? entries[0]!.id : undefined\n}\n\n/**\n * The agent an explicit `bindings[]` entry routes this channel account to,\n * if any. OpenClaw's `AgentBindingMatch`: `accountId` omitted/empty matches\n * only the channel default account, `\"*\"` matches every account, any other\n * string that account id.\n */\nexport function resolveBoundAgentId(cfg: OpenClawConfigLike, channel: string, accountId: string, defaultAccountId = 'default'): string | undefined {\n const bindings = isRecord(cfg) ? cfg.bindings : undefined\n if (!Array.isArray(bindings)) return undefined\n let wildcard: string | undefined\n for (const binding of bindings) {\n if (!isRecord(binding) || typeof binding.agentId !== 'string' || !isRecord(binding.match)) continue\n const match = binding.match\n if (match.channel !== channel) continue\n if (match.peer !== undefined && match.peer !== null) continue // peer-specific bindings route single conversations, not the account\n const matchAccount = typeof match.accountId === 'string' ? match.accountId.trim() : ''\n if (matchAccount === accountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '' && accountId === defaultAccountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '*' && wildcard === undefined) wildcard = binding.agentId.trim().toLowerCase()\n }\n return wildcard\n}\n\n/**\n * The workspace OpenClaw loads for `agentId` — the file `AGENTS.md` is read\n * from on every turn. Per-agent `workspace` first, then\n * `agents.defaults.workspace`, then the environment default.\n */\nexport function resolveOpenClawWorkspaceDir(cfg: OpenClawConfigLike, agentId?: string): string {\n const id = (agentId ?? resolveOpenClawDefaultAgentId(cfg) ?? DEFAULT_AGENT_ID).trim().toLowerCase()\n const entry = listOpenClawAgentEntries(cfg).find((candidate) => candidate.id === id)\n if (entry?.workspace) return expandUserPath(entry.workspace)\n const defaults = isRecord(cfg) && isRecord(cfg.agents) && isRecord(cfg.agents.defaults) ? cfg.agents.defaults : undefined\n const configured = defaults?.workspace\n if (typeof configured === 'string' && configured.trim().length > 0) return expandUserPath(configured)\n return resolveOpenClawDefaultWorkspaceDir()\n}\n"]}
@@ -5,7 +5,7 @@
5
5
  * filesystem reads, no network. Every env read goes through
6
6
  * `credentials/read-env.ts`. One resolver, shared by the identity-line
7
7
  * placement (`binding/agents-anchor.ts`), the key placement
8
- * (`doorbell/placement.ts`), the gateway and the doctor, so the four never
8
+ * (`integration/placement.ts`), the gateway and the doctor, so the four never
9
9
  * disagree about which workspace or state dir an agent uses.
10
10
  *
11
11
  * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,
@@ -5,7 +5,7 @@
5
5
  * filesystem reads, no network. Every env read goes through
6
6
  * `credentials/read-env.ts`. One resolver, shared by the identity-line
7
7
  * placement (`binding/agents-anchor.ts`), the key placement
8
- * (`doorbell/placement.ts`), the gateway and the doctor, so the four never
8
+ * (`integration/placement.ts`), the gateway and the doctor, so the four never
9
9
  * disagree about which workspace or state dir an agent uses.
10
10
  *
11
11
  * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/openclaw-layout.ts"],"names":[],"mappings":"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","file":"openclaw-layout.js","sourcesContent":["/**\n * Where OpenClaw keeps things — resolved the way OpenClaw resolves them.\n *\n * Pure: environment + config + `os.homedir()` in, paths and ids out. No\n * filesystem reads, no network. Every env read goes through\n * `credentials/read-env.ts`. One resolver, shared by the identity-line\n * placement (`binding/agents-anchor.ts`), the key placement\n * (`doorbell/placement.ts`), the gateway and the doctor, so the four never\n * disagree about which workspace or state dir an agent uses.\n *\n * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,\n * `src/agents/agent-roster.ts`, `src/config/paths.ts` in its dist):\n *\n * state dir = $OPENCLAW_STATE_DIR\n * | ~/.openclaw-<profile> when OPENCLAW_PROFILE is not \"default\"\n * | ~/.openclaw\n * workspace = agents.entries.<id>.workspace (or agents.list[].workspace)\n * | agents.defaults.workspace\n * | $OPENCLAW_WORKSPACE_DIR\n * | <state dir>/workspace\n * default agent = the one entry marked `default: true` (unless agents.ownership\n * is \"explicit\") | the sole entry | \"main\" when no roster exists\n */\n\nimport * as os from 'node:os'\nimport * as path from 'node:path'\n\nimport {\n readOpenClawProfileFromEnv,\n readOpenClawStateDirFromEnv,\n readOpenClawWorkspaceDirFromEnv,\n} from './credentials/read-env.js'\n\n/** OpenClaw's implicit agent id when no roster is configured. */\nexport const DEFAULT_AGENT_ID = 'main'\n\n/** The loosest config shape these readers need; the real `OpenClawConfig` satisfies it. */\nexport type OpenClawConfigLike = object | undefined\n\nexport interface OpenClawAgentEntry {\n readonly id: string\n readonly default?: boolean\n readonly workspace?: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** `~` and `~/…` → the home directory; anything else resolved as given. */\nexport function expandUserPath(value: string): string {\n const trimmed = value.trim()\n if (trimmed === '~') return os.homedir()\n if (trimmed.startsWith('~/') || trimmed.startsWith('~\\\\')) return path.join(os.homedir(), trimmed.slice(2))\n return path.resolve(trimmed)\n}\n\n/** OpenClaw's state dir: `$OPENCLAW_STATE_DIR`, else the profile dir, else `~/.openclaw`. */\nexport function resolveOpenClawStateDir(): string {\n const override = readOpenClawStateDirFromEnv()\n if (override) return expandUserPath(override)\n const profile = readOpenClawProfileFromEnv()\n return path.join(os.homedir(), profile ? `.openclaw-${profile}` : '.openclaw')\n}\n\n/** OpenClaw's default agent workspace: `$OPENCLAW_WORKSPACE_DIR`, else `<state dir>/workspace`. */\nexport function resolveOpenClawDefaultWorkspaceDir(): string {\n const override = readOpenClawWorkspaceDirFromEnv()\n if (override) return path.resolve(override)\n return path.join(resolveOpenClawStateDir(), 'workspace')\n}\n\n/** The agent roster from either representation OpenClaw accepts: `agents.entries` (record) or `agents.list` (array). */\nexport function listOpenClawAgentEntries(cfg: OpenClawConfigLike): OpenClawAgentEntry[] {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return []\n if (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) {\n if (!isRecord(agents.entries)) return []\n return Object.entries(agents.entries)\n .filter(([, entry]) => isRecord(entry))\n .map(([id, entry]) => toEntry(id, entry as Record<string, unknown>))\n }\n if (Object.hasOwn(agents, 'list') && agents.list !== undefined) {\n if (!Array.isArray(agents.list)) return []\n return agents.list\n .filter((entry): entry is Record<string, unknown> => isRecord(entry) && typeof entry.id === 'string')\n .map((entry) => toEntry(entry.id as string, entry))\n }\n return []\n}\n\nfunction toEntry(id: string, raw: Record<string, unknown>): OpenClawAgentEntry {\n return {\n id: id.trim().toLowerCase(),\n ...(raw.default === true ? { default: true } : {}),\n ...(typeof raw.workspace === 'string' && raw.workspace.trim() ? { workspace: raw.workspace } : {}),\n }\n}\n\nfunction hasAgentRoster(cfg: OpenClawConfigLike): boolean {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return false\n return (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) || (Object.hasOwn(agents, 'list') && agents.list !== undefined)\n}\n\n/**\n * The agent OpenClaw treats as the ambient default — the one `llm.complete`\n * uses when a plugin passes no `agentId`. Mirrors OpenClaw's\n * `tryResolveDefaultAgentId`: one entry marked `default: true` (unless the\n * roster declares `ownership: \"explicit\"`), else the sole entry, else `main`\n * when no roster exists. `undefined` when several agents exist and none is\n * marked — OpenClaw then has no single default either.\n */\nexport function resolveOpenClawDefaultAgentId(cfg: OpenClawConfigLike): string | undefined {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n const entries = listOpenClawAgentEntries(cfg)\n if (agents?.ownership !== 'explicit') {\n const marked = entries.filter((entry) => entry.default === true)\n if (marked.length === 1) return marked[0]!.id\n }\n if (entries.length === 0) return hasAgentRoster(cfg) ? undefined : DEFAULT_AGENT_ID\n return entries.length === 1 ? entries[0]!.id : undefined\n}\n\n/**\n * The agent an explicit `bindings[]` entry routes this channel account to,\n * if any. OpenClaw's `AgentBindingMatch`: `accountId` omitted/empty matches\n * only the channel default account, `\"*\"` matches every account, any other\n * string that account id.\n */\nexport function resolveBoundAgentId(cfg: OpenClawConfigLike, channel: string, accountId: string, defaultAccountId = 'default'): string | undefined {\n const bindings = isRecord(cfg) ? cfg.bindings : undefined\n if (!Array.isArray(bindings)) return undefined\n let wildcard: string | undefined\n for (const binding of bindings) {\n if (!isRecord(binding) || typeof binding.agentId !== 'string' || !isRecord(binding.match)) continue\n const match = binding.match\n if (match.channel !== channel) continue\n if (match.peer !== undefined && match.peer !== null) continue // peer-specific bindings route single conversations, not the account\n const matchAccount = typeof match.accountId === 'string' ? match.accountId.trim() : ''\n if (matchAccount === accountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '' && accountId === defaultAccountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '*' && wildcard === undefined) wildcard = binding.agentId.trim().toLowerCase()\n }\n return wildcard\n}\n\n/**\n * The workspace OpenClaw loads for `agentId` — the file `AGENTS.md` is read\n * from on every turn. Per-agent `workspace` first, then\n * `agents.defaults.workspace`, then the environment default.\n */\nexport function resolveOpenClawWorkspaceDir(cfg: OpenClawConfigLike, agentId?: string): string {\n const id = (agentId ?? resolveOpenClawDefaultAgentId(cfg) ?? DEFAULT_AGENT_ID).trim().toLowerCase()\n const entry = listOpenClawAgentEntries(cfg).find((candidate) => candidate.id === id)\n if (entry?.workspace) return expandUserPath(entry.workspace)\n const defaults = isRecord(cfg) && isRecord(cfg.agents) && isRecord(cfg.agents.defaults) ? cfg.agents.defaults : undefined\n const configured = defaults?.workspace\n if (typeof configured === 'string' && configured.trim().length > 0) return expandUserPath(configured)\n return resolveOpenClawDefaultWorkspaceDir()\n}\n"]}
1
+ {"version":3,"sources":["../src/openclaw-layout.ts"],"names":[],"mappings":"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","file":"openclaw-layout.js","sourcesContent":["/**\n * Where OpenClaw keeps things — resolved the way OpenClaw resolves them.\n *\n * Pure: environment + config + `os.homedir()` in, paths and ids out. No\n * filesystem reads, no network. Every env read goes through\n * `credentials/read-env.ts`. One resolver, shared by the identity-line\n * placement (`binding/agents-anchor.ts`), the key placement\n * (`integration/placement.ts`), the gateway and the doctor, so the four never\n * disagree about which workspace or state dir an agent uses.\n *\n * Mirrors OpenClaw 2026.10.9 (`src/agents/workspace-default-path.ts`,\n * `src/agents/agent-roster.ts`, `src/config/paths.ts` in its dist):\n *\n * state dir = $OPENCLAW_STATE_DIR\n * | ~/.openclaw-<profile> when OPENCLAW_PROFILE is not \"default\"\n * | ~/.openclaw\n * workspace = agents.entries.<id>.workspace (or agents.list[].workspace)\n * | agents.defaults.workspace\n * | $OPENCLAW_WORKSPACE_DIR\n * | <state dir>/workspace\n * default agent = the one entry marked `default: true` (unless agents.ownership\n * is \"explicit\") | the sole entry | \"main\" when no roster exists\n */\n\nimport * as os from 'node:os'\nimport * as path from 'node:path'\n\nimport {\n readOpenClawProfileFromEnv,\n readOpenClawStateDirFromEnv,\n readOpenClawWorkspaceDirFromEnv,\n} from './credentials/read-env.js'\n\n/** OpenClaw's implicit agent id when no roster is configured. */\nexport const DEFAULT_AGENT_ID = 'main'\n\n/** The loosest config shape these readers need; the real `OpenClawConfig` satisfies it. */\nexport type OpenClawConfigLike = object | undefined\n\nexport interface OpenClawAgentEntry {\n readonly id: string\n readonly default?: boolean\n readonly workspace?: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** `~` and `~/…` → the home directory; anything else resolved as given. */\nexport function expandUserPath(value: string): string {\n const trimmed = value.trim()\n if (trimmed === '~') return os.homedir()\n if (trimmed.startsWith('~/') || trimmed.startsWith('~\\\\')) return path.join(os.homedir(), trimmed.slice(2))\n return path.resolve(trimmed)\n}\n\n/** OpenClaw's state dir: `$OPENCLAW_STATE_DIR`, else the profile dir, else `~/.openclaw`. */\nexport function resolveOpenClawStateDir(): string {\n const override = readOpenClawStateDirFromEnv()\n if (override) return expandUserPath(override)\n const profile = readOpenClawProfileFromEnv()\n return path.join(os.homedir(), profile ? `.openclaw-${profile}` : '.openclaw')\n}\n\n/** OpenClaw's default agent workspace: `$OPENCLAW_WORKSPACE_DIR`, else `<state dir>/workspace`. */\nexport function resolveOpenClawDefaultWorkspaceDir(): string {\n const override = readOpenClawWorkspaceDirFromEnv()\n if (override) return path.resolve(override)\n return path.join(resolveOpenClawStateDir(), 'workspace')\n}\n\n/** The agent roster from either representation OpenClaw accepts: `agents.entries` (record) or `agents.list` (array). */\nexport function listOpenClawAgentEntries(cfg: OpenClawConfigLike): OpenClawAgentEntry[] {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return []\n if (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) {\n if (!isRecord(agents.entries)) return []\n return Object.entries(agents.entries)\n .filter(([, entry]) => isRecord(entry))\n .map(([id, entry]) => toEntry(id, entry as Record<string, unknown>))\n }\n if (Object.hasOwn(agents, 'list') && agents.list !== undefined) {\n if (!Array.isArray(agents.list)) return []\n return agents.list\n .filter((entry): entry is Record<string, unknown> => isRecord(entry) && typeof entry.id === 'string')\n .map((entry) => toEntry(entry.id as string, entry))\n }\n return []\n}\n\nfunction toEntry(id: string, raw: Record<string, unknown>): OpenClawAgentEntry {\n return {\n id: id.trim().toLowerCase(),\n ...(raw.default === true ? { default: true } : {}),\n ...(typeof raw.workspace === 'string' && raw.workspace.trim() ? { workspace: raw.workspace } : {}),\n }\n}\n\nfunction hasAgentRoster(cfg: OpenClawConfigLike): boolean {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n if (!agents) return false\n return (Object.hasOwn(agents, 'entries') && agents.entries !== undefined) || (Object.hasOwn(agents, 'list') && agents.list !== undefined)\n}\n\n/**\n * The agent OpenClaw treats as the ambient default — the one `llm.complete`\n * uses when a plugin passes no `agentId`. Mirrors OpenClaw's\n * `tryResolveDefaultAgentId`: one entry marked `default: true` (unless the\n * roster declares `ownership: \"explicit\"`), else the sole entry, else `main`\n * when no roster exists. `undefined` when several agents exist and none is\n * marked — OpenClaw then has no single default either.\n */\nexport function resolveOpenClawDefaultAgentId(cfg: OpenClawConfigLike): string | undefined {\n const agents = isRecord(cfg) && isRecord(cfg.agents) ? cfg.agents : undefined\n const entries = listOpenClawAgentEntries(cfg)\n if (agents?.ownership !== 'explicit') {\n const marked = entries.filter((entry) => entry.default === true)\n if (marked.length === 1) return marked[0]!.id\n }\n if (entries.length === 0) return hasAgentRoster(cfg) ? undefined : DEFAULT_AGENT_ID\n return entries.length === 1 ? entries[0]!.id : undefined\n}\n\n/**\n * The agent an explicit `bindings[]` entry routes this channel account to,\n * if any. OpenClaw's `AgentBindingMatch`: `accountId` omitted/empty matches\n * only the channel default account, `\"*\"` matches every account, any other\n * string that account id.\n */\nexport function resolveBoundAgentId(cfg: OpenClawConfigLike, channel: string, accountId: string, defaultAccountId = 'default'): string | undefined {\n const bindings = isRecord(cfg) ? cfg.bindings : undefined\n if (!Array.isArray(bindings)) return undefined\n let wildcard: string | undefined\n for (const binding of bindings) {\n if (!isRecord(binding) || typeof binding.agentId !== 'string' || !isRecord(binding.match)) continue\n const match = binding.match\n if (match.channel !== channel) continue\n if (match.peer !== undefined && match.peer !== null) continue // peer-specific bindings route single conversations, not the account\n const matchAccount = typeof match.accountId === 'string' ? match.accountId.trim() : ''\n if (matchAccount === accountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '' && accountId === defaultAccountId) return binding.agentId.trim().toLowerCase()\n if (matchAccount === '*' && wildcard === undefined) wildcard = binding.agentId.trim().toLowerCase()\n }\n return wildcard\n}\n\n/**\n * The workspace OpenClaw loads for `agentId` — the file `AGENTS.md` is read\n * from on every turn. Per-agent `workspace` first, then\n * `agents.defaults.workspace`, then the environment default.\n */\nexport function resolveOpenClawWorkspaceDir(cfg: OpenClawConfigLike, agentId?: string): string {\n const id = (agentId ?? resolveOpenClawDefaultAgentId(cfg) ?? DEFAULT_AGENT_ID).trim().toLowerCase()\n const entry = listOpenClawAgentEntries(cfg).find((candidate) => candidate.id === id)\n if (entry?.workspace) return expandUserPath(entry.workspace)\n const defaults = isRecord(cfg) && isRecord(cfg.agents) && isRecord(cfg.agents.defaults) ? cfg.agents.defaults : undefined\n const configured = defaults?.workspace\n if (typeof configured === 'string' && configured.trim().length > 0) return expandUserPath(configured)\n return resolveOpenClawDefaultWorkspaceDir()\n}\n"]}