open-multi-agent-kit 0.80.6 → 0.80.8

package/dist/core/mcp-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-presets.js","sourceRoot":"","sources":["../../src/core/mcp-presets.ts"],"names":[],"mappings":"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","sourcesContent":["export type BuiltinMcpPresetName = \"aside-ubuntu-compat\" | \"chrome-devtools\" | \"context7\" | \"korean-law\" | \"playwright\";\nexport type BuiltinMcpEnvMode = \"shell\" | \"empty\";\nexport type BuiltinMcpPresetLicense = \"Apache-2.0\" | \"MIT\";\nexport type McpKnownCapability = \"tools\" | \"resources\" | \"prompts\" | \"sampling\";\nexport type McpAuthMode = \"none\" | \"env\" | \"oauth\" | \"external\";\nexport type McpSamplingMode = \"disabled\" | \"client-gated\";\n\nexport interface McpCapabilityDecision {\n\ttrustedCapabilities: McpKnownCapability[];\n\tunknownCapabilities: string[];\n\tmalformed: boolean;\n\trule: string;\n\treason: string;\n}\n\nexport interface McpSamplingDecision {\n\tallowed: boolean;\n\tmode: McpSamplingMode;\n\thumanApprovalRequired: boolean;\n\trule: string;\n\treason: string;\n}\n\nexport interface McpAuthDecision {\n\tmode: McpAuthMode;\n\tenvKeys: string[];\n\trule: string;\n\treason: string;\n}\n\nexport interface McpSamplingPolicyInput {\n\tmode: McpSamplingMode;\n\thumanApprovalRequired: boolean;\n}\n\nexport interface McpAuthPolicyInput {\n\tmode: McpAuthMode;\n\tenvKeys?: readonly string[];\n}\n\nexport interface BuiltinMcpServerConfig {\n\tcommand: string;\n\targs: string[];\n\tenv?: Record<string, string>;\n\tstartup_timeout_sec?: number;\n\tautoApprove?: string[];\n}\n\nexport interface BuiltinMcpPreset {\n\tname: BuiltinMcpPresetName;\n\tlabel: string;\n\tdescription: string;\n\thomepage: string;\n\trepository: string;\n\tlicense: BuiltinMcpPresetLicense;\n\tnpmPackage: string;\n\tnpmVersion: string;\n\texactPackageSpec: string;\n\tgitTag: string;\n\tgitCommit: string;\n\tcommand: string;\n\targs: readonly string[];\n\tenvKeys: readonly string[];\n\trequiredEnvKeys: readonly string[];\n\toptionalEnvKeys: readonly string[];\n\tcapabilities: readonly McpKnownCapability[];\n\tsamplingPolicy: McpSamplingPolicyInput;\n\tauthPolicy: McpAuthPolicyInput;\n\tstartupTimeoutSec: number;\n\tautoApprove: readonly string[];\n\tinstallHint: string;\n\tnotes: readonly string[];\n}\n\nexport interface BuiltinMcpPresetSummary {\n\tname: BuiltinMcpPresetName;\n\tlabel: string;\n\tdescription: string;\n\thomepage: string;\n\trepository: string;\n\tlicense: string;\n\texactPackageSpec: string;\n\tgitTag: string;\n\tgitCommit: string;\n\tcommandSummary: string;\n\tenvKeys: string[];\n\trequiredEnvKeys: string[];\n\toptionalEnvKeys: string[];\n\tcapabilityDecision: McpCapabilityDecision;\n\tsamplingDecision: McpSamplingDecision;\n\tauthDecision: McpAuthDecision;\n\tstartupTimeoutSec: number;\n\tautoApproveCount: number;\n\tinstallHint: string;\n\tnotes: string[];\n}\n\nconst LAW_OC_ENV_PLACEHOLDER = \"$\" + \"{LAW_OC}\";\nconst KNOWN_MCP_CAPABILITIES: readonly McpKnownCapability[] = [\"tools\", \"resources\", \"prompts\", \"sampling\"];\n\nfunction uniqueSortedStrings(values: readonly string[]): string[] {\n\treturn [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort();\n}\n\nfunction orderedKnownCapabilities(values: readonly string[]): McpKnownCapability[] {\n\tconst declared = new Set(values);\n\treturn KNOWN_MCP_CAPABILITIES.filter((capability) => declared.has(capability));\n}\n\nfunction isKnownCapability(value: string): value is McpKnownCapability {\n\treturn KNOWN_MCP_CAPABILITIES.includes(value as McpKnownCapability);\n}\n\nfunction isMcpAuthMode(value: unknown): value is McpAuthMode {\n\treturn value === \"none\" || value === \"env\" || value === \"oauth\" || value === \"external\";\n}\n\nfunction isMcpSamplingMode(value: unknown): value is McpSamplingMode {\n\treturn value === \"disabled\" || value === \"client-gated\";\n}\n\nexport function decideMcpCapabilities(rawCapabilities: unknown): McpCapabilityDecision {\n\tif (!rawCapabilities) {\n\t\treturn {\n\t\t\ttrustedCapabilities: [],\n\t\t\tunknownCapabilities: [],\n\t\t\tmalformed: false,\n\t\t\trule: \"mcp.capabilities.unspecified\",\n\t\t\treason: \"MCP capabilities were not declared.\",\n\t\t};\n\t}\n\n\tlet declared: string[] = [];\n\tlet malformed = false;\n\n\tif (Array.isArray(rawCapabilities)) {\n\t\tfor (const capability of rawCapabilities) {\n\t\t\tif (typeof capability === \"string\") {\n\t\t\t\tdeclared.push(capability.trim());\n\t\t\t} else {\n\t\t\t\tmalformed = true;\n\t\t\t}\n\t\t}\n\t} else if (typeof rawCapabilities === \"object\") {\n\t\tfor (const [capability, enabled] of Object.entries(rawCapabilities as Record<string, unknown>)) {\n\t\t\tif (typeof enabled !== \"boolean\") {\n\t\t\t\tmalformed = true;\n\t\t\t}\n\t\t\tif (enabled === true) {\n\t\t\t\tdeclared.push(capability.trim());\n\t\t\t}\n\t\t}\n\t} else {\n\t\tmalformed = true;\n\t}\n\n\tdeclared = uniqueSortedStrings(declared);\n\tconst trustedCapabilities = orderedKnownCapabilities(declared.filter(isKnownCapability));\n\tconst unknownCapabilities = declared.filter((capability) => !isKnownCapability(capability));\n\tconst hasUntrustedInput = malformed || unknownCapabilities.length > 0;\n\treturn {\n\t\ttrustedCapabilities,\n\t\tunknownCapabilities,\n\t\tmalformed,\n\t\trule: hasUntrustedInput ? \"mcp.capabilities.untrusted_input\" : \"mcp.capabilities.declared\",\n\t\treason: hasUntrustedInput\n\t\t\t? \"Only known MCP capabilities are trusted; unknown or malformed entries are reported but ignored.\"\n\t\t\t: \"MCP capabilities were declared with known capability names.\",\n\t};\n}\n\nexport function decideMcpSampling(capabilityDecision: McpCapabilityDecision, rawPolicy: unknown): McpSamplingDecision {\n\tif (!capabilityDecision.trustedCapabilities.includes(\"sampling\")) {\n\t\treturn {\n\t\t\tallowed: false,\n\t\t\tmode: \"disabled\",\n\t\t\thumanApprovalRequired: false,\n\t\t\trule: \"mcp.sampling.capability_missing\",\n\t\t\treason: \"MCP sampling is denied because the trusted sampling capability is not declared.\",\n\t\t};\n\t}\n\n\tif (!rawPolicy || typeof rawPolicy !== \"object\" || Array.isArray(rawPolicy)) {\n\t\treturn {\n\t\t\tallowed: false,\n\t\t\tmode: \"disabled\",\n\t\t\thumanApprovalRequired: false,\n\t\t\trule: \"mcp.sampling.policy_missing\",\n\t\t\treason: \"MCP sampling is denied until an explicit client-gated policy with human approval is present.\",\n\t\t};\n\t}\n\n\tconst policy = rawPolicy as Record<string, unknown>;\n\tconst mode = policy.mode;\n\tconst humanApprovalRequired = policy.humanApprovalRequired;\n\tif (isMcpSamplingMode(mode) && mode === \"client-gated\" && humanApprovalRequired === true) {\n\t\treturn {\n\t\t\tallowed: true,\n\t\t\tmode,\n\t\t\thumanApprovalRequired: true,\n\t\t\trule: \"mcp.sampling.client_gated_human_approval\",\n\t\t\treason: \"MCP sampling is client-gated and requires human approval.\",\n\t\t};\n\t}\n\n\treturn {\n\t\tallowed: false,\n\t\tmode: isMcpSamplingMode(mode) ? mode : \"disabled\",\n\t\thumanApprovalRequired: humanApprovalRequired === true,\n\t\trule: \"mcp.sampling.policy_invalid\",\n\t\treason: \"MCP sampling is denied because policy is not client-gated with humanApprovalRequired true.\",\n\t};\n}\n\nexport function decideMcpAuth(rawAuth: unknown, declaredEnvKeys: readonly string[]): McpAuthDecision {\n\tconst fallbackEnvKeys = uniqueSortedStrings(declaredEnvKeys);\n\tif (!rawAuth) {\n\t\tif (fallbackEnvKeys.length > 0) {\n\t\t\treturn {\n\t\t\t\tmode: \"env\",\n\t\t\t\tenvKeys: fallbackEnvKeys,\n\t\t\t\trule: \"mcp.auth.env_inferred\",\n\t\t\t\treason: \"MCP auth uses declared environment variable names; values are not exposed.\",\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tmode: \"none\",\n\t\t\tenvKeys: [],\n\t\t\trule: \"mcp.auth.none\",\n\t\t\treason: \"MCP auth is not declared and no environment keys are configured.\",\n\t\t};\n\t}\n\n\tconst authMode = typeof rawAuth === \"string\" ? rawAuth : (rawAuth as Record<string, unknown>).mode;\n\tif (!isMcpAuthMode(authMode)) {\n\t\treturn {\n\t\t\tmode: \"external\",\n\t\t\tenvKeys: [],\n\t\t\trule: \"mcp.auth.invalid\",\n\t\t\treason: \"MCP auth policy is invalid; treat credentials as externally managed.\",\n\t\t};\n\t}\n\n\tif (authMode === \"env\") {\n\t\tconst rawEnvKeys =\n\t\t\ttypeof rawAuth === \"object\" && !Array.isArray(rawAuth) ? (rawAuth as Record<string, unknown>).envKeys : [];\n\t\tconst envKeys = Array.isArray(rawEnvKeys)\n\t\t\t? uniqueSortedStrings(rawEnvKeys.filter((entry): entry is string => typeof entry === \"string\"))\n\t\t\t: [];\n\t\tconst sanitizedEnvKeys = envKeys.length > 0 ? envKeys : fallbackEnvKeys;\n\t\treturn {\n\t\t\tmode: \"env\",\n\t\t\tenvKeys: sanitizedEnvKeys,\n\t\t\trule: \"mcp.auth.env\",\n\t\t\treason: \"MCP auth uses environment variable names; values are not exposed.\",\n\t\t};\n\t}\n\n\treturn {\n\t\tmode: authMode,\n\t\tenvKeys: [],\n\t\trule: `mcp.auth.${authMode}`,\n\t\treason:\n\t\t\tauthMode === \"none\"\n\t\t\t\t? \"MCP auth is explicitly disabled.\"\n\t\t\t\t: `MCP auth is handled by ${authMode}; secret values are not exposed.`,\n\t};\n}\n\nconst ASIDE_UBUNTU_COMPAT_PRESET: BuiltinMcpPreset = {\n\tname: \"aside-ubuntu-compat\",\n\tlabel: \"Aside Ubuntu Compat MCP\",\n\tdescription:\n\t\t\"Ubuntu/zsh browser automation compatibility facade for workflows that expect an Aside-like MCP entrypoint. It uses Playwright MCP and does not provide native macOS Aside APIs on Linux.\",\n\thomepage: \"https://playwright.dev\",\n\trepository: \"https://github.com/microsoft/playwright-mcp.git\",\n\tlicense: \"Apache-2.0\",\n\tnpmPackage: \"@playwright/mcp\",\n\tnpmVersion: \"0.0.76\",\n\texactPackageSpec: \"@playwright/mcp@0.0.76\",\n\tgitTag: \"v0.0.76\",\n\tgitCommit: \"b301c372ec741289eff1cf6aab9d3bec553f31e2\",\n\tcommand: \"zsh\",\n\targs: [\"-lc\", \"exec npx -y @playwright/mcp@0.0.76\"],\n\tenvKeys: [\"DISPLAY\", \"WAYLAND_DISPLAY\", \"XDG_RUNTIME_DIR\"],\n\trequiredEnvKeys: [],\n\toptionalEnvKeys: [\"DISPLAY\", \"WAYLAND_DISPLAY\", \"XDG_RUNTIME_DIR\"],\n\tcapabilities: [\"tools\"],\n\tsamplingPolicy: { mode: \"disabled\", humanApprovalRequired: false },\n\tauthPolicy: { mode: \"none\" },\n\tstartupTimeoutSec: 45,\n\tautoApprove: [],\n\tinstallHint:\n\t\t'Add an MCP server named aside-ubuntu-compat using command zsh and args -lc \"exec npx -y @playwright/mcp@0.0.76\".',\n\tnotes: [\n\t\t\"Exact npm pin; never uses @latest.\",\n\t\t\"Apache-2.0 licensed upstream at tag v0.0.76, commit b301c372ec741289eff1cf6aab9d3bec553f31e2.\",\n\t\t\"Compatibility facade only: it does not expose native macOS Aside APIs or a native Aside browser profile on Linux.\",\n\t\t\"Requires zsh, node/npm/npx, and a browser-capable Ubuntu environment.\",\n\t],\n};\n\nconst CHROME_DEVTOOLS_PRESET: BuiltinMcpPreset = {\n\tname: \"chrome-devtools\",\n\tlabel: \"Chrome DevTools MCP\",\n\tdescription:\n\t\t\"Chrome DevTools 기반 브라우저 자동화 MCP 서버. UI reconnaissance, computed style extraction, performance traces, screenshots에 사용합니다.\",\n\thomepage: \"https://github.com/ChromeDevTools/chrome-devtools-mcp#readme\",\n\trepository: \"https://github.com/ChromeDevTools/chrome-devtools-mcp.git\",\n\tlicense: \"Apache-2.0\",\n\tnpmPackage: \"chrome-devtools-mcp\",\n\tnpmVersion: \"1.4.0\",\n\texactPackageSpec: \"chrome-devtools-mcp@1.4.0\",\n\tgitTag: \"chrome-devtools-mcp-v1.4.0\",\n\tgitCommit: \"0aaa8e3cc0e9ae55b1ef5b456d6d25526015b886\",\n\tcommand: \"npx\",\n\targs: [\"-y\", \"chrome-devtools-mcp@1.4.0\"],\n\tenvKeys: [],\n\trequiredEnvKeys: [],\n\toptionalEnvKeys: [],\n\tcapabilities: [\"tools\"],\n\tsamplingPolicy: { mode: \"disabled\", humanApprovalRequired: false },\n\tauthPolicy: { mode: \"none\" },\n\tstartupTimeoutSec: 45,\n\tautoApprove: [],\n\tinstallHint: \"Add an MCP server named chrome-devtools using command npx and args -y chrome-devtools-mcp@1.4.0.\",\n\tnotes: [\n\t\t\"Exact npm pin; never uses @latest.\",\n\t\t\"Apache-2.0 licensed upstream at tag chrome-devtools-mcp-v1.4.0, commit 0aaa8e3cc0e9ae55b1ef5b456d6d25526015b886.\",\n\t\t\"Use for browser reconnaissance, screenshots, performance traces, and computed-style capture.\",\n\t],\n};\n\nconst CONTEXT7_PRESET: BuiltinMcpPreset = {\n\tname: \"context7\",\n\tlabel: \"Context7 MCP\",\n\tdescription:\n\t\t\"Library/framework documentation MCP server. Use it to fetch current docs for React, Next.js, Tailwind, shadcn/ui, Playwright, and @rhwp/core APIs.\",\n\thomepage: \"https://github.com/upstash/context7#readme\",\n\trepository: \"https://github.com/upstash/context7.git\",\n\tlicense: \"MIT\",\n\tnpmPackage: \"@upstash/context7-mcp\",\n\tnpmVersion: \"3.2.2\",\n\texactPackageSpec: \"@upstash/context7-mcp@3.2.2\",\n\tgitTag: \"@upstash/context7-mcp@3.2.2\",\n\tgitCommit: \"18e6d4727bbcfb4001a8a17337b0f0f717f1b4fd\",\n\tcommand: \"npx\",\n\targs: [\"-y\", \"@upstash/context7-mcp@3.2.2\"],\n\tenvKeys: [],\n\trequiredEnvKeys: [],\n\toptionalEnvKeys: [],\n\tcapabilities: [\"tools\"],\n\tsamplingPolicy: { mode: \"disabled\", humanApprovalRequired: false },\n\tauthPolicy: { mode: \"none\" },\n\tstartupTimeoutSec: 30,\n\tautoApprove: [],\n\tinstallHint: \"Add an MCP server named context7 using command npx and args -y @upstash/context7-mcp@3.2.2.\",\n\tnotes: [\n\t\t\"Exact npm pin; never uses @latest.\",\n\t\t\"MIT licensed upstream at tag @upstash/context7-mcp@3.2.2, commit 18e6d4727bbcfb4001a8a17337b0f0f717f1b4fd.\",\n\t\t\"Use for current framework and package documentation before coding against external APIs.\",\n\t],\n};\n\nconst KOREAN_LAW_PRESET: BuiltinMcpPreset = {\n\tname: \"korean-law\",\n\tlabel: \"Korean Law MCP\",\n\tdescription:\n\t\t\"법제처 Open API 기반 한국 법령·판례·조례·조약 MCP 서버. Requires a LAW_OC or KOREAN_LAW_API_KEY value at runtime.\",\n\thomepage: \"https://github.com/chrisryugj/korean-law-mcp\",\n\trepository: \"https://github.com/chrisryugj/korean-law-mcp.git\",\n\tlicense: \"MIT\",\n\tnpmPackage: \"korean-law-mcp\",\n\tnpmVersion: \"4.4.0\",\n\texactPackageSpec: \"korean-law-mcp@4.4.0\",\n\tgitTag: \"v4.4.0\",\n\tgitCommit: \"2ef8f1827d349381fc2bde15120c803fd2e7bfed\",\n\tcommand: \"npx\",\n\targs: [\"-y\", \"korean-law-mcp@4.4.0\"],\n\tenvKeys: [\"LAW_OC\", \"KOREAN_LAW_API_KEY\"],\n\trequiredEnvKeys: [\"LAW_OC\"],\n\toptionalEnvKeys: [\"KOREAN_LAW_API_KEY\"],\n\tcapabilities: [\"tools\"],\n\tsamplingPolicy: { mode: \"disabled\", humanApprovalRequired: false },\n\tauthPolicy: { mode: \"env\", envKeys: [\"LAW_OC\", \"KOREAN_LAW_API_KEY\"] },\n\tstartupTimeoutSec: 30,\n\tautoApprove: [],\n\tinstallHint:\n\t\t\"Add an MCP server named korean-law using command npx and args -y korean-law-mcp@4.4.0; set LAW_OC from your shell or secret manager.\",\n\tnotes: [\n\t\t\"Exact npm pin; never uses @latest.\",\n\t\t\"MIT licensed upstream at tag v4.4.0, commit 2ef8f1827d349381fc2bde15120c803fd2e7bfed.\",\n\t\t\"Env values are intentionally not embedded in the preset.\",\n\t],\n};\n\nconst PLAYWRIGHT_PRESET: BuiltinMcpPreset = {\n\tname: \"playwright\",\n\tlabel: \"Playwright MCP\",\n\tdescription:\n\t\t\"Playwright 기반 browser automation MCP 서버. Visual QA, responsive screenshots, interaction sweeps, visual diff evidence에 사용합니다.\",\n\thomepage: \"https://playwright.dev\",\n\trepository: \"https://github.com/microsoft/playwright-mcp.git\",\n\tlicense: \"Apache-2.0\",\n\tnpmPackage: \"@playwright/mcp\",\n\tnpmVersion: \"0.0.76\",\n\texactPackageSpec: \"@playwright/mcp@0.0.76\",\n\tgitTag: \"v0.0.76\",\n\tgitCommit: \"b301c372ec741289eff1cf6aab9d3bec553f31e2\",\n\tcommand: \"npx\",\n\targs: [\"-y\", \"@playwright/mcp@0.0.76\"],\n\tenvKeys: [],\n\trequiredEnvKeys: [],\n\toptionalEnvKeys: [],\n\tcapabilities: [\"tools\"],\n\tsamplingPolicy: { mode: \"disabled\", humanApprovalRequired: false },\n\tauthPolicy: { mode: \"none\" },\n\tstartupTimeoutSec: 45,\n\tautoApprove: [],\n\tinstallHint: \"Add an MCP server named playwright using command npx and args -y @playwright/mcp@0.0.76.\",\n\tnotes: [\n\t\t\"Exact npm pin; never uses @latest.\",\n\t\t\"Apache-2.0 licensed upstream at tag v0.0.76, commit b301c372ec741289eff1cf6aab9d3bec553f31e2.\",\n\t\t\"Use for deterministic screenshots, viewport sweeps, interactions, and visual QA artifacts.\",\n\t],\n};\n\nconst BUILTIN_MCP_PRESETS: ReadonlyArray<BuiltinMcpPreset> = [\n\tASIDE_UBUNTU_COMPAT_PRESET,\n\tCHROME_DEVTOOLS_PRESET,\n\tCONTEXT7_PRESET,\n\tKOREAN_LAW_PRESET,\n\tPLAYWRIGHT_PRESET,\n];\n\nfunction buildShellEnvForPreset(preset: BuiltinMcpPreset): Record<string, string> {\n\tif (preset.name === \"korean-law\") return { LAW_OC: LAW_OC_ENV_PLACEHOLDER };\n\treturn {};\n}\n\nfunction clonePreset(preset: BuiltinMcpPreset): BuiltinMcpPreset {\n\treturn {\n\t\t...preset,\n\t\targs: [...preset.args],\n\t\tenvKeys: [...preset.envKeys],\n\t\trequiredEnvKeys: [...preset.requiredEnvKeys],\n\t\toptionalEnvKeys: [...preset.optionalEnvKeys],\n\t\tcapabilities: [...preset.capabilities],\n\t\tsamplingPolicy: { ...preset.samplingPolicy },\n\t\tauthPolicy: {\n\t\t\t...preset.authPolicy,\n\t\t\t...(preset.authPolicy.envKeys ? { envKeys: [...preset.authPolicy.envKeys] } : {}),\n\t\t},\n\t\tautoApprove: [...preset.autoApprove],\n\t\tnotes: [...preset.notes],\n\t};\n}\n\nexport function listBuiltinMcpPresets(): BuiltinMcpPreset[] {\n\treturn BUILTIN_MCP_PRESETS.map(clonePreset);\n}\n\nexport function getBuiltinMcpPreset(name: string): BuiltinMcpPreset | undefined {\n\tconst preset = BUILTIN_MCP_PRESETS.find((entry) => entry.name === name);\n\treturn preset ? clonePreset(preset) : undefined;\n}\n\nexport function buildBuiltinMcpServerConfig(\n\tname: string,\n\toptions: { envMode?: BuiltinMcpEnvMode } = {},\n): BuiltinMcpServerConfig | undefined {\n\tconst preset = getBuiltinMcpPreset(name);\n\tif (!preset) return undefined;\n\tconst envMode = options.envMode ?? \"shell\";\n\tconst shellEnv = envMode === \"shell\" ? buildShellEnvForPreset(preset) : {};\n\treturn {\n\t\tcommand: preset.command,\n\t\targs: [...preset.args],\n\t\t...(Object.keys(shellEnv).length > 0 ? { env: shellEnv } : {}),\n\t\tstartup_timeout_sec: preset.startupTimeoutSec,\n\t\t...(preset.autoApprove.length > 0 ? { autoApprove: [...preset.autoApprove] } : {}),\n\t};\n}\n\nexport function summarizeBuiltinMcpPreset(preset: BuiltinMcpPreset): BuiltinMcpPresetSummary {\n\tconst capabilityDecision = decideMcpCapabilities(preset.capabilities);\n\treturn {\n\t\tname: preset.name,\n\t\tlabel: preset.label,\n\t\tdescription: preset.description,\n\t\thomepage: preset.homepage,\n\t\trepository: preset.repository,\n\t\tlicense: preset.license,\n\t\texactPackageSpec: preset.exactPackageSpec,\n\t\tgitTag: preset.gitTag,\n\t\tgitCommit: preset.gitCommit,\n\t\tcommandSummary: `${preset.command} ${preset.args.join(\" \")}`,\n\t\tenvKeys: [...preset.envKeys],\n\t\trequiredEnvKeys: [...preset.requiredEnvKeys],\n\t\toptionalEnvKeys: [...preset.optionalEnvKeys],\n\t\tcapabilityDecision,\n\t\tsamplingDecision: decideMcpSampling(capabilityDecision, preset.samplingPolicy),\n\t\tauthDecision: decideMcpAuth(preset.authPolicy, preset.envKeys),\n\t\tstartupTimeoutSec: preset.startupTimeoutSec,\n\t\tautoApproveCount: preset.autoApprove.length,\n\t\tinstallHint: preset.installHint,\n\t\tnotes: [...preset.notes],\n\t};\n}\n"]}

package/dist/core/messages.d.ts

@@ -4,8 +4,8 @@
  * Extends the base AgentMessage type with coding-agent specific message types,
  * and provides a transformer to convert them to LLM-compatible messages.
  */
-import type { AgentMessage } from "@earendil-works/omk-agent-core";
-import type { ImageContent, Message, TextContent } from "@earendil-works/omk-ai";
+import type { AgentMessage } from "omk-agent-core";
+import type { ImageContent, Message, TextContent } from "omk-ai";
 export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
 export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
 export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
@@ -49,7 +49,7 @@ export interface CompactionSummaryMessage {
     tokensBefore: number;
     timestamp: number;
 }
-declare module "@earendil-works/omk-agent-core" {
+declare module "omk-agent-core" {
     interface CustomAgentMessages {
         bashExecution: BashExecutionMessage;
         custom: CustomMessage;

package/dist/core/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEjF,eAAO,MAAM,yBAAyB,wGAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iBAC3B,CAAC;AAEZ,eAAO,MAAM,qBAAqB,iGAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAGD,OAAO,QAAQ,gCAAgC,CAAC,CAAC;IAChD,UAAU,mBAAmB;QAC5B,aAAa,EAAE,oBAAoB,CAAC;QACpC,MAAM,EAAE,aAAa,CAAC;QACtB,aAAa,EAAE,oBAAoB,CAAC;QACpC,iBAAiB,EAAE,wBAAwB,CAAC;KAC5C;CACD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAgBrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAOnH;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,wBAAwB,CAO1B;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GACf,aAAa,CASf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CA+ChE","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@earendil-works/omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@earendil-works/omk-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@earendil-works/omk-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEjE,eAAO,MAAM,yBAAyB,wGAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iBAC3B,CAAC;AAEZ,eAAO,MAAM,qBAAqB,iGAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAGD,OAAO,QAAQ,gBAAgB,CAAC,CAAC;IAChC,UAAU,mBAAmB;QAC5B,aAAa,EAAE,oBAAoB,CAAC;QACpC,MAAM,EAAE,aAAa,CAAC;QACtB,aAAa,EAAE,oBAAoB,CAAC;QACpC,iBAAiB,EAAE,wBAAwB,CAAC;KAC5C;CACD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAgBrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAOnH;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,wBAAwB,CAO1B;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GACf,aAAa,CASf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CA+ChE","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"omk-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"omk-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@earendil-works/omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@earendil-works/omk-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@earendil-works/omk-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"omk-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"omk-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/metrics-sampler.d.ts

@@ -5,6 +5,10 @@ type MetricsSamplerOptions = {
         rss: number;
     };
     cpuCount?: number;
+    emaAlpha?: number;
+    historySize?: number;
+    rollingWindowSize?: number;
+    spikeThreshold?: number;
 };
 /**
  * Samples process CPU and memory usage on a fixed interval.
@@ -28,6 +32,12 @@ export declare class MetricsSampler {
     private cpuCount;
     private cpuPeak;
     private readonly smoothedHistory;
+    private readonly emaAlpha;
+    private readonly historySize;
+    private readonly rollingWindowSize;
+    private readonly spikeThreshold;
+    private cpuSpikeCount;
+    private wasCpuSpike;
     /**
      * Create a sampler. All dependencies can be injected for deterministic
      * testing; omitted options default to real process/OS sources.
@@ -46,6 +56,7 @@ export declare class MetricsSampler {
     getMemoryRssBytes(): number | null;
     /** The highest smoothed CPU percent observed since start, or `null` before the first sample. */
     getCpuPeak(): number | null;
+    getCpuSpikeCount(): number;
     /**
      * The mean of the last `window` smoothed CPU percent samples, or `null` if
      * fewer than `window` samples have been collected.

package/dist/core/metrics-sampler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics-sampler.d.ts","sourceRoot":"","sources":["../../src/core/metrics-sampler.ts"],"names":[],"mappings":"AASA,KAAK,qBAAqB,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IAEnD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAEhD;;;OAGG;IACH,YAAY,OAAO,CAAC,EAAE,qBAAqB,EAK1C;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,SAAO,GAAG,IAAI,CAW7B;IAED,2DAA2D;IAC3D,IAAI,IAAI,IAAI,CAWX;IAED,sGAAsG;IACtG,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,6FAA6F;IAC7F,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,gGAAgG;IAChG,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;OAGG;IACH,gBAAgB,CAAC,MAAM,SAAI,GAAG,MAAM,GAAG,IAAI,CAU1C;IAED,OAAO,CAAC,MAAM;CA4Cd","sourcesContent":["import * as os from \"node:os\";\n\nconst DEFAULT_EMA_ALPHA = 0.3;\n\n// Cap the smoothed-sample history so a long-running process cannot grow it\n// without bound. The rolling average only ever reads the tail, so retaining a\n// fixed recent window is sufficient (120 samples = 4 minutes at a 2s interval).\nconst MAX_CPU_HISTORY = 120;\n\ntype MetricsSamplerOptions = {\n\tnow?: () => number;\n\treadCpu?: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\treadMemory?: () => { rss: number };\n\tcpuCount?: number;\n};\n\n/**\n * Samples process CPU and memory usage on a fixed interval.\n *\n * CPU% is computed from `process.cpuUsage(prev)` deltas normalized by elapsed\n * wall-clock time and the number of logical CPUs. The raw delta percent is\n * then smoothed with an exponential moving average (EMA). Memory is read from\n * `process.memoryUsage().rss`.\n *\n * The interval timer is `unref()`-ed so it never keeps the process alive.\n */\nexport class MetricsSampler {\n\tprivate readonly now: () => number;\n\tprivate readonly readCpu: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\tprivate readonly readMemory: () => { rss: number };\n\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate prevCpu: NodeJS.CpuUsage | null = null;\n\tprivate prevTime: number | null = null;\n\tprivate cpuPercent: number | null = null;\n\tprivate memoryRssBytes: number | null = null;\n\tprivate cpuCount: number;\n\tprivate cpuPeak: number | null = null;\n\tprivate readonly smoothedHistory: number[] = [];\n\n\t/**\n\t * Create a sampler. All dependencies can be injected for deterministic\n\t * testing; omitted options default to real process/OS sources.\n\t */\n\tconstructor(options?: MetricsSamplerOptions) {\n\t\tthis.now = options?.now ?? (() => Date.now());\n\t\tthis.readCpu = options?.readCpu ?? ((prev?: NodeJS.CpuUsage) => process.cpuUsage(prev));\n\t\tthis.readMemory = options?.readMemory ?? (() => process.memoryUsage());\n\t\tthis.cpuCount = Math.max(1, options?.cpuCount ?? os.cpus().length);\n\t}\n\n\t/**\n\t * Start sampling. If already running, the existing timer is stopped and\n\t * restarted with the new interval.\n\t */\n\tstart(intervalMs = 2000): void {\n\t\tthis.stop();\n\t\tthis.prevCpu = this.readCpu();\n\t\tthis.prevTime = this.now();\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.smoothedHistory.length = 0;\n\n\t\tthis.timer = setInterval(() => this.sample(), intervalMs);\n\t\tthis.timer.unref();\n\t}\n\n\t/** Stop sampling and reset all cached values to `null`. */\n\tstop(): void {\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tthis.prevCpu = null;\n\t\tthis.prevTime = null;\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.smoothedHistory.length = 0;\n\t}\n\n\t/** The most recently sampled, EMA-smoothed CPU percent (0-100), or `null` before the first sample. */\n\tgetCpuPercent(): number | null {\n\t\treturn this.cpuPercent;\n\t}\n\n\t/** The most recently sampled RSS memory size in bytes, or `null` before the first sample. */\n\tgetMemoryRssBytes(): number | null {\n\t\treturn this.memoryRssBytes;\n\t}\n\n\t/** The highest smoothed CPU percent observed since start, or `null` before the first sample. */\n\tgetCpuPeak(): number | null {\n\t\treturn this.cpuPeak;\n\t}\n\n\t/**\n\t * The mean of the last `window` smoothed CPU percent samples, or `null` if\n\t * fewer than `window` samples have been collected.\n\t */\n\tgetCpuRollingAvg(window = 5): number | null {\n\t\tif (window <= 0 || this.smoothedHistory.length < window) {\n\t\t\treturn null;\n\t\t}\n\t\tconst start = this.smoothedHistory.length - window;\n\t\tlet sum = 0;\n\t\tfor (let i = start; i < this.smoothedHistory.length; i++) {\n\t\t\tsum += this.smoothedHistory[i];\n\t\t}\n\t\treturn sum / window;\n\t}\n\n\tprivate sample(): void {\n\t\tif (!this.prevCpu || this.prevTime === null) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = this.now();\n\t\tconst elapsedMs = now - this.prevTime;\n\t\tif (elapsedMs <= 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst delta = this.readCpu(this.prevCpu);\n\t\tconst deltaMicroseconds = delta.user + delta.system;\n\n\t\t// Convert microseconds of CPU time into a percentage of total CPU capacity.\n\t\t// One core-second per elapsed wall second is 100% of one core; dividing by\n\t\t// cpuCount gives the percentage of total system CPU capacity.\n\t\tconst coreFraction = deltaMicroseconds / (elapsedMs * 1000);\n\t\tconst rawPercent = (coreFraction / this.cpuCount) * 100;\n\t\tconst clampedRaw = clamp(rawPercent, 0, 100);\n\n\t\t// First sample seeds the EMA; subsequent samples blend with prior value.\n\t\tconst smoothed =\n\t\t\tthis.cpuPercent === null\n\t\t\t\t? clampedRaw\n\t\t\t\t: DEFAULT_EMA_ALPHA * clampedRaw + (1 - DEFAULT_EMA_ALPHA) * this.cpuPercent;\n\n\t\tthis.cpuPercent = smoothed;\n\t\tthis.memoryRssBytes = this.readMemory().rss;\n\t\tthis.smoothedHistory.push(smoothed);\n\t\tif (this.smoothedHistory.length > MAX_CPU_HISTORY) {\n\t\t\tthis.smoothedHistory.shift();\n\t\t}\n\t\tif (this.cpuPeak === null || smoothed > this.cpuPeak) {\n\t\t\tthis.cpuPeak = smoothed;\n\t\t}\n\n\t\t// Accumulate the delta so the next sample computes from the same baseline.\n\t\tthis.prevCpu = {\n\t\t\tuser: this.prevCpu.user + delta.user,\n\t\t\tsystem: this.prevCpu.system + delta.system,\n\t\t};\n\t\tthis.prevTime = now;\n\t}\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n\treturn Math.max(min, Math.min(max, value));\n}\n"]}
+{"version":3,"file":"metrics-sampler.d.ts","sourceRoot":"","sources":["../../src/core/metrics-sampler.ts"],"names":[],"mappings":"AAWA,KAAK,qBAAqB,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IAEnD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACH,YAAY,OAAO,CAAC,EAAE,qBAAqB,EAwB1C;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,SAAO,GAAG,IAAI,CAa7B;IAED,2DAA2D;IAC3D,IAAI,IAAI,IAAI,CAaX;IAED,sGAAsG;IACtG,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,6FAA6F;IAC7F,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,gGAAgG;IAChG,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,gBAAgB,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,gBAAgB,CAAC,MAAM,SAAyB,GAAG,MAAM,GAAG,IAAI,CAc/D;IAED,OAAO,CAAC,MAAM;CA+Cd","sourcesContent":["import * as os from \"node:os\";\n\nconst DEFAULT_EMA_ALPHA = 0.3;\nconst DEFAULT_CPU_HISTORY_SIZE = 120;\nconst DEFAULT_ROLLING_WINDOW_SIZE = 5;\nconst DEFAULT_SPIKE_THRESHOLD = 80;\nconst MIN_CPU_HISTORY_SIZE = 1;\nconst MAX_CPU_HISTORY_SIZE = 120;\nconst MIN_SPIKE_THRESHOLD = 0;\nconst MAX_SPIKE_THRESHOLD = 100;\n\ntype MetricsSamplerOptions = {\n\tnow?: () => number;\n\treadCpu?: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\treadMemory?: () => { rss: number };\n\tcpuCount?: number;\n\temaAlpha?: number;\n\thistorySize?: number;\n\trollingWindowSize?: number;\n\tspikeThreshold?: number;\n};\n\n/**\n * Samples process CPU and memory usage on a fixed interval.\n *\n * CPU% is computed from `process.cpuUsage(prev)` deltas normalized by elapsed\n * wall-clock time and the number of logical CPUs. The raw delta percent is\n * then smoothed with an exponential moving average (EMA). Memory is read from\n * `process.memoryUsage().rss`.\n *\n * The interval timer is `unref()`-ed so it never keeps the process alive.\n */\nexport class MetricsSampler {\n\tprivate readonly now: () => number;\n\tprivate readonly readCpu: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\tprivate readonly readMemory: () => { rss: number };\n\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate prevCpu: NodeJS.CpuUsage | null = null;\n\tprivate prevTime: number | null = null;\n\tprivate cpuPercent: number | null = null;\n\tprivate memoryRssBytes: number | null = null;\n\tprivate cpuCount: number;\n\tprivate cpuPeak: number | null = null;\n\tprivate readonly smoothedHistory: number[] = [];\n\tprivate readonly emaAlpha: number;\n\tprivate readonly historySize: number;\n\tprivate readonly rollingWindowSize: number;\n\tprivate readonly spikeThreshold: number;\n\tprivate cpuSpikeCount = 0;\n\tprivate wasCpuSpike = false;\n\n\t/**\n\t * Create a sampler. All dependencies can be injected for deterministic\n\t * testing; omitted options default to real process/OS sources.\n\t */\n\tconstructor(options?: MetricsSamplerOptions) {\n\t\tthis.now = options?.now ?? (() => Date.now());\n\t\tthis.readCpu = options?.readCpu ?? ((prev?: NodeJS.CpuUsage) => process.cpuUsage(prev));\n\t\tthis.readMemory = options?.readMemory ?? (() => process.memoryUsage());\n\t\tthis.cpuCount = sanitizeInteger(options?.cpuCount, os.cpus().length, 1, Number.MAX_SAFE_INTEGER);\n\t\tthis.emaAlpha = sanitizeNumber(options?.emaAlpha, DEFAULT_EMA_ALPHA, 0, 1);\n\t\tthis.historySize = sanitizeInteger(\n\t\t\toptions?.historySize,\n\t\t\tDEFAULT_CPU_HISTORY_SIZE,\n\t\t\tMIN_CPU_HISTORY_SIZE,\n\t\t\tMAX_CPU_HISTORY_SIZE,\n\t\t);\n\t\tthis.rollingWindowSize = sanitizeInteger(\n\t\t\toptions?.rollingWindowSize,\n\t\t\tMath.min(DEFAULT_ROLLING_WINDOW_SIZE, this.historySize),\n\t\t\tMIN_CPU_HISTORY_SIZE,\n\t\t\tthis.historySize,\n\t\t);\n\t\tthis.spikeThreshold = sanitizeNumber(\n\t\t\toptions?.spikeThreshold,\n\t\t\tDEFAULT_SPIKE_THRESHOLD,\n\t\t\tMIN_SPIKE_THRESHOLD,\n\t\t\tMAX_SPIKE_THRESHOLD,\n\t\t);\n\t}\n\n\t/**\n\t * Start sampling. If already running, the existing timer is stopped and\n\t * restarted with the new interval.\n\t */\n\tstart(intervalMs = 2000): void {\n\t\tthis.stop();\n\t\tthis.prevCpu = this.readCpu();\n\t\tthis.prevTime = this.now();\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.cpuSpikeCount = 0;\n\t\tthis.wasCpuSpike = false;\n\t\tthis.smoothedHistory.length = 0;\n\n\t\tthis.timer = setInterval(() => this.sample(), intervalMs);\n\t\tthis.timer.unref();\n\t}\n\n\t/** Stop sampling and reset all cached values to `null`. */\n\tstop(): void {\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tthis.prevCpu = null;\n\t\tthis.prevTime = null;\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.cpuSpikeCount = 0;\n\t\tthis.wasCpuSpike = false;\n\t\tthis.smoothedHistory.length = 0;\n\t}\n\n\t/** The most recently sampled, EMA-smoothed CPU percent (0-100), or `null` before the first sample. */\n\tgetCpuPercent(): number | null {\n\t\treturn this.cpuPercent;\n\t}\n\n\t/** The most recently sampled RSS memory size in bytes, or `null` before the first sample. */\n\tgetMemoryRssBytes(): number | null {\n\t\treturn this.memoryRssBytes;\n\t}\n\n\t/** The highest smoothed CPU percent observed since start, or `null` before the first sample. */\n\tgetCpuPeak(): number | null {\n\t\treturn this.cpuPeak;\n\t}\n\n\tgetCpuSpikeCount(): number {\n\t\treturn this.cpuSpikeCount;\n\t}\n\n\t/**\n\t * The mean of the last `window` smoothed CPU percent samples, or `null` if\n\t * fewer than `window` samples have been collected.\n\t */\n\tgetCpuRollingAvg(window = this.rollingWindowSize): number | null {\n\t\tif (!Number.isFinite(window) || window <= 0) {\n\t\t\treturn null;\n\t\t}\n\t\tconst sampleWindow = Math.floor(window);\n\t\tif (this.smoothedHistory.length < sampleWindow) {\n\t\t\treturn null;\n\t\t}\n\t\tconst start = this.smoothedHistory.length - sampleWindow;\n\t\tlet sum = 0;\n\t\tfor (let i = start; i < this.smoothedHistory.length; i++) {\n\t\t\tsum += this.smoothedHistory[i];\n\t\t}\n\t\treturn sum / sampleWindow;\n\t}\n\n\tprivate sample(): void {\n\t\tif (!this.prevCpu || this.prevTime === null) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = this.now();\n\t\tconst elapsedMs = now - this.prevTime;\n\t\tif (elapsedMs <= 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst delta = this.readCpu(this.prevCpu);\n\t\tconst deltaMicroseconds = delta.user + delta.system;\n\n\t\t// Convert microseconds of CPU time into a percentage of total CPU capacity.\n\t\t// One core-second per elapsed wall second is 100% of one core; dividing by\n\t\t// cpuCount gives the percentage of total system CPU capacity.\n\t\tconst coreFraction = deltaMicroseconds / (elapsedMs * 1000);\n\t\tconst rawPercent = (coreFraction / this.cpuCount) * 100;\n\t\tconst clampedRaw = clamp(rawPercent, 0, 100);\n\n\t\t// First sample seeds the EMA; subsequent samples blend with prior value.\n\t\tconst smoothed =\n\t\t\tthis.cpuPercent === null ? clampedRaw : this.emaAlpha * clampedRaw + (1 - this.emaAlpha) * this.cpuPercent;\n\n\t\tthis.cpuPercent = smoothed;\n\t\tthis.memoryRssBytes = this.readMemory().rss;\n\t\tthis.smoothedHistory.push(smoothed);\n\t\tif (this.smoothedHistory.length > this.historySize) {\n\t\t\tthis.smoothedHistory.shift();\n\t\t}\n\t\tif (this.cpuPeak === null || smoothed > this.cpuPeak) {\n\t\t\tthis.cpuPeak = smoothed;\n\t\t}\n\t\tconst isCpuSpike = smoothed > this.spikeThreshold;\n\t\tif (isCpuSpike && !this.wasCpuSpike) {\n\t\t\tthis.cpuSpikeCount++;\n\t\t}\n\t\tthis.wasCpuSpike = isCpuSpike;\n\n\t\t// Accumulate the delta so the next sample computes from the same baseline.\n\t\tthis.prevCpu = {\n\t\t\tuser: this.prevCpu.user + delta.user,\n\t\t\tsystem: this.prevCpu.system + delta.system,\n\t\t};\n\t\tthis.prevTime = now;\n\t}\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n\treturn Math.max(min, Math.min(max, value));\n}\n\nfunction sanitizeNumber(value: unknown, fallback: number, min: number, max: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn fallback;\n\t}\n\treturn clamp(value, min, max);\n}\n\nfunction sanitizeInteger(value: unknown, fallback: number, min: number, max: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn fallback;\n\t}\n\treturn Math.floor(clamp(value, min, max));\n}\n"]}

package/dist/core/metrics-sampler.js

@@ -1,9 +1,12 @@
 import * as os from "node:os";
 const DEFAULT_EMA_ALPHA = 0.3;
-// Cap the smoothed-sample history so a long-running process cannot grow it
-// without bound. The rolling average only ever reads the tail, so retaining a
-// fixed recent window is sufficient (120 samples = 4 minutes at a 2s interval).
-const MAX_CPU_HISTORY = 120;
+const DEFAULT_CPU_HISTORY_SIZE = 120;
+const DEFAULT_ROLLING_WINDOW_SIZE = 5;
+const DEFAULT_SPIKE_THRESHOLD = 80;
+const MIN_CPU_HISTORY_SIZE = 1;
+const MAX_CPU_HISTORY_SIZE = 120;
+const MIN_SPIKE_THRESHOLD = 0;
+const MAX_SPIKE_THRESHOLD = 100;
 /**
  * Samples process CPU and memory usage on a fixed interval.
  *
@@ -26,6 +29,12 @@ export class MetricsSampler {
     cpuCount;
     cpuPeak = null;
     smoothedHistory = [];
+    emaAlpha;
+    historySize;
+    rollingWindowSize;
+    spikeThreshold;
+    cpuSpikeCount = 0;
+    wasCpuSpike = false;
     /**
      * Create a sampler. All dependencies can be injected for deterministic
      * testing; omitted options default to real process/OS sources.
@@ -34,7 +43,11 @@ export class MetricsSampler {
         this.now = options?.now ?? (() => Date.now());
         this.readCpu = options?.readCpu ?? ((prev) => process.cpuUsage(prev));
         this.readMemory = options?.readMemory ?? (() => process.memoryUsage());
-        this.cpuCount = Math.max(1, options?.cpuCount ?? os.cpus().length);
+        this.cpuCount = sanitizeInteger(options?.cpuCount, os.cpus().length, 1, Number.MAX_SAFE_INTEGER);
+        this.emaAlpha = sanitizeNumber(options?.emaAlpha, DEFAULT_EMA_ALPHA, 0, 1);
+        this.historySize = sanitizeInteger(options?.historySize, DEFAULT_CPU_HISTORY_SIZE, MIN_CPU_HISTORY_SIZE, MAX_CPU_HISTORY_SIZE);
+        this.rollingWindowSize = sanitizeInteger(options?.rollingWindowSize, Math.min(DEFAULT_ROLLING_WINDOW_SIZE, this.historySize), MIN_CPU_HISTORY_SIZE, this.historySize);
+        this.spikeThreshold = sanitizeNumber(options?.spikeThreshold, DEFAULT_SPIKE_THRESHOLD, MIN_SPIKE_THRESHOLD, MAX_SPIKE_THRESHOLD);
     }
     /**
      * Start sampling. If already running, the existing timer is stopped and
@@ -47,6 +60,8 @@ export class MetricsSampler {
         this.cpuPercent = null;
         this.memoryRssBytes = null;
         this.cpuPeak = null;
+        this.cpuSpikeCount = 0;
+        this.wasCpuSpike = false;
         this.smoothedHistory.length = 0;
         this.timer = setInterval(() => this.sample(), intervalMs);
         this.timer.unref();
@@ -62,6 +77,8 @@ export class MetricsSampler {
         this.cpuPercent = null;
         this.memoryRssBytes = null;
         this.cpuPeak = null;
+        this.cpuSpikeCount = 0;
+        this.wasCpuSpike = false;
         this.smoothedHistory.length = 0;
     }
     /** The most recently sampled, EMA-smoothed CPU percent (0-100), or `null` before the first sample. */
@@ -76,20 +93,27 @@ export class MetricsSampler {
     getCpuPeak() {
         return this.cpuPeak;
     }
+    getCpuSpikeCount() {
+        return this.cpuSpikeCount;
+    }
     /**
      * The mean of the last `window` smoothed CPU percent samples, or `null` if
      * fewer than `window` samples have been collected.
      */
-    getCpuRollingAvg(window = 5) {
-        if (window <= 0 || this.smoothedHistory.length < window) {
+    getCpuRollingAvg(window = this.rollingWindowSize) {
+        if (!Number.isFinite(window) || window <= 0) {
+            return null;
+        }
+        const sampleWindow = Math.floor(window);
+        if (this.smoothedHistory.length < sampleWindow) {
             return null;
         }
-        const start = this.smoothedHistory.length - window;
+        const start = this.smoothedHistory.length - sampleWindow;
         let sum = 0;
         for (let i = start; i < this.smoothedHistory.length; i++) {
             sum += this.smoothedHistory[i];
         }
-        return sum / window;
+        return sum / sampleWindow;
     }
     sample() {
         if (!this.prevCpu || this.prevTime === null) {
@@ -109,18 +133,21 @@ export class MetricsSampler {
         const rawPercent = (coreFraction / this.cpuCount) * 100;
         const clampedRaw = clamp(rawPercent, 0, 100);
         // First sample seeds the EMA; subsequent samples blend with prior value.
-        const smoothed = this.cpuPercent === null
-            ? clampedRaw
-            : DEFAULT_EMA_ALPHA * clampedRaw + (1 - DEFAULT_EMA_ALPHA) * this.cpuPercent;
+        const smoothed = this.cpuPercent === null ? clampedRaw : this.emaAlpha * clampedRaw + (1 - this.emaAlpha) * this.cpuPercent;
         this.cpuPercent = smoothed;
         this.memoryRssBytes = this.readMemory().rss;
         this.smoothedHistory.push(smoothed);
-        if (this.smoothedHistory.length > MAX_CPU_HISTORY) {
+        if (this.smoothedHistory.length > this.historySize) {
             this.smoothedHistory.shift();
         }
         if (this.cpuPeak === null || smoothed > this.cpuPeak) {
             this.cpuPeak = smoothed;
         }
+        const isCpuSpike = smoothed > this.spikeThreshold;
+        if (isCpuSpike && !this.wasCpuSpike) {
+            this.cpuSpikeCount++;
+        }
+        this.wasCpuSpike = isCpuSpike;
         // Accumulate the delta so the next sample computes from the same baseline.
         this.prevCpu = {
             user: this.prevCpu.user + delta.user,
@@ -132,4 +159,16 @@ export class MetricsSampler {
 function clamp(value, min, max) {
     return Math.max(min, Math.min(max, value));
 }
+function sanitizeNumber(value, fallback, min, max) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return clamp(value, min, max);
+}
+function sanitizeInteger(value, fallback, min, max) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return Math.floor(clamp(value, min, max));
+}
 //# sourceMappingURL=metrics-sampler.js.map

package/dist/core/metrics-sampler.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics-sampler.js","sourceRoot":"","sources":["../../src/core/metrics-sampler.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from \"node:os\";\n\nconst DEFAULT_EMA_ALPHA = 0.3;\n\n// Cap the smoothed-sample history so a long-running process cannot grow it\n// without bound. The rolling average only ever reads the tail, so retaining a\n// fixed recent window is sufficient (120 samples = 4 minutes at a 2s interval).\nconst MAX_CPU_HISTORY = 120;\n\ntype MetricsSamplerOptions = {\n\tnow?: () => number;\n\treadCpu?: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\treadMemory?: () => { rss: number };\n\tcpuCount?: number;\n};\n\n/**\n * Samples process CPU and memory usage on a fixed interval.\n *\n * CPU% is computed from `process.cpuUsage(prev)` deltas normalized by elapsed\n * wall-clock time and the number of logical CPUs. The raw delta percent is\n * then smoothed with an exponential moving average (EMA). Memory is read from\n * `process.memoryUsage().rss`.\n *\n * The interval timer is `unref()`-ed so it never keeps the process alive.\n */\nexport class MetricsSampler {\n\tprivate readonly now: () => number;\n\tprivate readonly readCpu: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\tprivate readonly readMemory: () => { rss: number };\n\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate prevCpu: NodeJS.CpuUsage | null = null;\n\tprivate prevTime: number | null = null;\n\tprivate cpuPercent: number | null = null;\n\tprivate memoryRssBytes: number | null = null;\n\tprivate cpuCount: number;\n\tprivate cpuPeak: number | null = null;\n\tprivate readonly smoothedHistory: number[] = [];\n\n\t/**\n\t * Create a sampler. All dependencies can be injected for deterministic\n\t * testing; omitted options default to real process/OS sources.\n\t */\n\tconstructor(options?: MetricsSamplerOptions) {\n\t\tthis.now = options?.now ?? (() => Date.now());\n\t\tthis.readCpu = options?.readCpu ?? ((prev?: NodeJS.CpuUsage) => process.cpuUsage(prev));\n\t\tthis.readMemory = options?.readMemory ?? (() => process.memoryUsage());\n\t\tthis.cpuCount = Math.max(1, options?.cpuCount ?? os.cpus().length);\n\t}\n\n\t/**\n\t * Start sampling. If already running, the existing timer is stopped and\n\t * restarted with the new interval.\n\t */\n\tstart(intervalMs = 2000): void {\n\t\tthis.stop();\n\t\tthis.prevCpu = this.readCpu();\n\t\tthis.prevTime = this.now();\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.smoothedHistory.length = 0;\n\n\t\tthis.timer = setInterval(() => this.sample(), intervalMs);\n\t\tthis.timer.unref();\n\t}\n\n\t/** Stop sampling and reset all cached values to `null`. */\n\tstop(): void {\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tthis.prevCpu = null;\n\t\tthis.prevTime = null;\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.smoothedHistory.length = 0;\n\t}\n\n\t/** The most recently sampled, EMA-smoothed CPU percent (0-100), or `null` before the first sample. */\n\tgetCpuPercent(): number | null {\n\t\treturn this.cpuPercent;\n\t}\n\n\t/** The most recently sampled RSS memory size in bytes, or `null` before the first sample. */\n\tgetMemoryRssBytes(): number | null {\n\t\treturn this.memoryRssBytes;\n\t}\n\n\t/** The highest smoothed CPU percent observed since start, or `null` before the first sample. */\n\tgetCpuPeak(): number | null {\n\t\treturn this.cpuPeak;\n\t}\n\n\t/**\n\t * The mean of the last `window` smoothed CPU percent samples, or `null` if\n\t * fewer than `window` samples have been collected.\n\t */\n\tgetCpuRollingAvg(window = 5): number | null {\n\t\tif (window <= 0 || this.smoothedHistory.length < window) {\n\t\t\treturn null;\n\t\t}\n\t\tconst start = this.smoothedHistory.length - window;\n\t\tlet sum = 0;\n\t\tfor (let i = start; i < this.smoothedHistory.length; i++) {\n\t\t\tsum += this.smoothedHistory[i];\n\t\t}\n\t\treturn sum / window;\n\t}\n\n\tprivate sample(): void {\n\t\tif (!this.prevCpu || this.prevTime === null) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = this.now();\n\t\tconst elapsedMs = now - this.prevTime;\n\t\tif (elapsedMs <= 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst delta = this.readCpu(this.prevCpu);\n\t\tconst deltaMicroseconds = delta.user + delta.system;\n\n\t\t// Convert microseconds of CPU time into a percentage of total CPU capacity.\n\t\t// One core-second per elapsed wall second is 100% of one core; dividing by\n\t\t// cpuCount gives the percentage of total system CPU capacity.\n\t\tconst coreFraction = deltaMicroseconds / (elapsedMs * 1000);\n\t\tconst rawPercent = (coreFraction / this.cpuCount) * 100;\n\t\tconst clampedRaw = clamp(rawPercent, 0, 100);\n\n\t\t// First sample seeds the EMA; subsequent samples blend with prior value.\n\t\tconst smoothed =\n\t\t\tthis.cpuPercent === null\n\t\t\t\t? clampedRaw\n\t\t\t\t: DEFAULT_EMA_ALPHA * clampedRaw + (1 - DEFAULT_EMA_ALPHA) * this.cpuPercent;\n\n\t\tthis.cpuPercent = smoothed;\n\t\tthis.memoryRssBytes = this.readMemory().rss;\n\t\tthis.smoothedHistory.push(smoothed);\n\t\tif (this.smoothedHistory.length > MAX_CPU_HISTORY) {\n\t\t\tthis.smoothedHistory.shift();\n\t\t}\n\t\tif (this.cpuPeak === null || smoothed > this.cpuPeak) {\n\t\t\tthis.cpuPeak = smoothed;\n\t\t}\n\n\t\t// Accumulate the delta so the next sample computes from the same baseline.\n\t\tthis.prevCpu = {\n\t\t\tuser: this.prevCpu.user + delta.user,\n\t\t\tsystem: this.prevCpu.system + delta.system,\n\t\t};\n\t\tthis.prevTime = now;\n\t}\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n\treturn Math.max(min, Math.min(max, value));\n}\n"]}
+{"version":3,"file":"metrics-sampler.js","sourceRoot":"","sources":["../../src/core/metrics-sampler.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from \"node:os\";\n\nconst DEFAULT_EMA_ALPHA = 0.3;\nconst DEFAULT_CPU_HISTORY_SIZE = 120;\nconst DEFAULT_ROLLING_WINDOW_SIZE = 5;\nconst DEFAULT_SPIKE_THRESHOLD = 80;\nconst MIN_CPU_HISTORY_SIZE = 1;\nconst MAX_CPU_HISTORY_SIZE = 120;\nconst MIN_SPIKE_THRESHOLD = 0;\nconst MAX_SPIKE_THRESHOLD = 100;\n\ntype MetricsSamplerOptions = {\n\tnow?: () => number;\n\treadCpu?: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\treadMemory?: () => { rss: number };\n\tcpuCount?: number;\n\temaAlpha?: number;\n\thistorySize?: number;\n\trollingWindowSize?: number;\n\tspikeThreshold?: number;\n};\n\n/**\n * Samples process CPU and memory usage on a fixed interval.\n *\n * CPU% is computed from `process.cpuUsage(prev)` deltas normalized by elapsed\n * wall-clock time and the number of logical CPUs. The raw delta percent is\n * then smoothed with an exponential moving average (EMA). Memory is read from\n * `process.memoryUsage().rss`.\n *\n * The interval timer is `unref()`-ed so it never keeps the process alive.\n */\nexport class MetricsSampler {\n\tprivate readonly now: () => number;\n\tprivate readonly readCpu: (prev?: NodeJS.CpuUsage) => NodeJS.CpuUsage;\n\tprivate readonly readMemory: () => { rss: number };\n\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate prevCpu: NodeJS.CpuUsage | null = null;\n\tprivate prevTime: number | null = null;\n\tprivate cpuPercent: number | null = null;\n\tprivate memoryRssBytes: number | null = null;\n\tprivate cpuCount: number;\n\tprivate cpuPeak: number | null = null;\n\tprivate readonly smoothedHistory: number[] = [];\n\tprivate readonly emaAlpha: number;\n\tprivate readonly historySize: number;\n\tprivate readonly rollingWindowSize: number;\n\tprivate readonly spikeThreshold: number;\n\tprivate cpuSpikeCount = 0;\n\tprivate wasCpuSpike = false;\n\n\t/**\n\t * Create a sampler. All dependencies can be injected for deterministic\n\t * testing; omitted options default to real process/OS sources.\n\t */\n\tconstructor(options?: MetricsSamplerOptions) {\n\t\tthis.now = options?.now ?? (() => Date.now());\n\t\tthis.readCpu = options?.readCpu ?? ((prev?: NodeJS.CpuUsage) => process.cpuUsage(prev));\n\t\tthis.readMemory = options?.readMemory ?? (() => process.memoryUsage());\n\t\tthis.cpuCount = sanitizeInteger(options?.cpuCount, os.cpus().length, 1, Number.MAX_SAFE_INTEGER);\n\t\tthis.emaAlpha = sanitizeNumber(options?.emaAlpha, DEFAULT_EMA_ALPHA, 0, 1);\n\t\tthis.historySize = sanitizeInteger(\n\t\t\toptions?.historySize,\n\t\t\tDEFAULT_CPU_HISTORY_SIZE,\n\t\t\tMIN_CPU_HISTORY_SIZE,\n\t\t\tMAX_CPU_HISTORY_SIZE,\n\t\t);\n\t\tthis.rollingWindowSize = sanitizeInteger(\n\t\t\toptions?.rollingWindowSize,\n\t\t\tMath.min(DEFAULT_ROLLING_WINDOW_SIZE, this.historySize),\n\t\t\tMIN_CPU_HISTORY_SIZE,\n\t\t\tthis.historySize,\n\t\t);\n\t\tthis.spikeThreshold = sanitizeNumber(\n\t\t\toptions?.spikeThreshold,\n\t\t\tDEFAULT_SPIKE_THRESHOLD,\n\t\t\tMIN_SPIKE_THRESHOLD,\n\t\t\tMAX_SPIKE_THRESHOLD,\n\t\t);\n\t}\n\n\t/**\n\t * Start sampling. If already running, the existing timer is stopped and\n\t * restarted with the new interval.\n\t */\n\tstart(intervalMs = 2000): void {\n\t\tthis.stop();\n\t\tthis.prevCpu = this.readCpu();\n\t\tthis.prevTime = this.now();\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.cpuSpikeCount = 0;\n\t\tthis.wasCpuSpike = false;\n\t\tthis.smoothedHistory.length = 0;\n\n\t\tthis.timer = setInterval(() => this.sample(), intervalMs);\n\t\tthis.timer.unref();\n\t}\n\n\t/** Stop sampling and reset all cached values to `null`. */\n\tstop(): void {\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tthis.prevCpu = null;\n\t\tthis.prevTime = null;\n\t\tthis.cpuPercent = null;\n\t\tthis.memoryRssBytes = null;\n\t\tthis.cpuPeak = null;\n\t\tthis.cpuSpikeCount = 0;\n\t\tthis.wasCpuSpike = false;\n\t\tthis.smoothedHistory.length = 0;\n\t}\n\n\t/** The most recently sampled, EMA-smoothed CPU percent (0-100), or `null` before the first sample. */\n\tgetCpuPercent(): number | null {\n\t\treturn this.cpuPercent;\n\t}\n\n\t/** The most recently sampled RSS memory size in bytes, or `null` before the first sample. */\n\tgetMemoryRssBytes(): number | null {\n\t\treturn this.memoryRssBytes;\n\t}\n\n\t/** The highest smoothed CPU percent observed since start, or `null` before the first sample. */\n\tgetCpuPeak(): number | null {\n\t\treturn this.cpuPeak;\n\t}\n\n\tgetCpuSpikeCount(): number {\n\t\treturn this.cpuSpikeCount;\n\t}\n\n\t/**\n\t * The mean of the last `window` smoothed CPU percent samples, or `null` if\n\t * fewer than `window` samples have been collected.\n\t */\n\tgetCpuRollingAvg(window = this.rollingWindowSize): number | null {\n\t\tif (!Number.isFinite(window) || window <= 0) {\n\t\t\treturn null;\n\t\t}\n\t\tconst sampleWindow = Math.floor(window);\n\t\tif (this.smoothedHistory.length < sampleWindow) {\n\t\t\treturn null;\n\t\t}\n\t\tconst start = this.smoothedHistory.length - sampleWindow;\n\t\tlet sum = 0;\n\t\tfor (let i = start; i < this.smoothedHistory.length; i++) {\n\t\t\tsum += this.smoothedHistory[i];\n\t\t}\n\t\treturn sum / sampleWindow;\n\t}\n\n\tprivate sample(): void {\n\t\tif (!this.prevCpu || this.prevTime === null) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = this.now();\n\t\tconst elapsedMs = now - this.prevTime;\n\t\tif (elapsedMs <= 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst delta = this.readCpu(this.prevCpu);\n\t\tconst deltaMicroseconds = delta.user + delta.system;\n\n\t\t// Convert microseconds of CPU time into a percentage of total CPU capacity.\n\t\t// One core-second per elapsed wall second is 100% of one core; dividing by\n\t\t// cpuCount gives the percentage of total system CPU capacity.\n\t\tconst coreFraction = deltaMicroseconds / (elapsedMs * 1000);\n\t\tconst rawPercent = (coreFraction / this.cpuCount) * 100;\n\t\tconst clampedRaw = clamp(rawPercent, 0, 100);\n\n\t\t// First sample seeds the EMA; subsequent samples blend with prior value.\n\t\tconst smoothed =\n\t\t\tthis.cpuPercent === null ? clampedRaw : this.emaAlpha * clampedRaw + (1 - this.emaAlpha) * this.cpuPercent;\n\n\t\tthis.cpuPercent = smoothed;\n\t\tthis.memoryRssBytes = this.readMemory().rss;\n\t\tthis.smoothedHistory.push(smoothed);\n\t\tif (this.smoothedHistory.length > this.historySize) {\n\t\t\tthis.smoothedHistory.shift();\n\t\t}\n\t\tif (this.cpuPeak === null || smoothed > this.cpuPeak) {\n\t\t\tthis.cpuPeak = smoothed;\n\t\t}\n\t\tconst isCpuSpike = smoothed > this.spikeThreshold;\n\t\tif (isCpuSpike && !this.wasCpuSpike) {\n\t\t\tthis.cpuSpikeCount++;\n\t\t}\n\t\tthis.wasCpuSpike = isCpuSpike;\n\n\t\t// Accumulate the delta so the next sample computes from the same baseline.\n\t\tthis.prevCpu = {\n\t\t\tuser: this.prevCpu.user + delta.user,\n\t\t\tsystem: this.prevCpu.system + delta.system,\n\t\t};\n\t\tthis.prevTime = now;\n\t}\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n\treturn Math.max(min, Math.min(max, value));\n}\n\nfunction sanitizeNumber(value: unknown, fallback: number, min: number, max: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn fallback;\n\t}\n\treturn clamp(value, min, max);\n}\n\nfunction sanitizeInteger(value: unknown, fallback: number, min: number, max: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn fallback;\n\t}\n\treturn Math.floor(clamp(value, min, max));\n}\n"]}

package/dist/core/model-registry.d.ts

@@ -1,7 +1,7 @@
 /**
  * Model registry - manages built-in and custom models, provides API key resolution.
  */
-import { type Api, type AssistantMessageEventStream, type Context, type Model, type OAuthProviderInterface, type SimpleStreamOptions } from "@earendil-works/omk-ai";
+import { type Api, type AssistantMessageEventStream, type Context, type Model, type OAuthProviderInterface, type SimpleStreamOptions } from "omk-ai";
 import type { AuthStatus, AuthStorage } from "./auth-storage.ts";
 import { clearConfigValueCache } from "./resolve-config-value.ts";
 export type ResolvedRequestAuth = {