@rudderhq/agent-runtime-utils 0.1.0-canary.0

package/LICENSE

@@ -0,0 +1,14 @@
+This package is part of the Rudder project.
+
+Rudder began as a fork of an early version of Paperclip.
+
+Licensing for this package follows the repository-level transition:
+- new Rudder contributions are made under the Apache License, Version 2.0
+- upstream-derived Paperclip portions preserve the original MIT notice where applicable
+
+Canonical project-level license and attribution texts live in the source repository:
+- `LICENSE`
+- `NOTICE`
+- `LICENSES/MIT-PAPERCLIP`
+
+Source repository: https://github.com/Undertone0809/rudder

package/dist/billing.d.ts

@@ -0,0 +1,2 @@
+export declare function inferOpenAiCompatibleBiller(env: NodeJS.ProcessEnv, fallback?: string | null): string | null;
+//# sourceMappingURL=billing.d.ts.map

package/dist/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"AAKA,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,QAAQ,GAAE,MAAM,GAAG,IAAe,GACjC,MAAM,GAAG,IAAI,CAWf"}

package/dist/billing.js

@@ -0,0 +1,16 @@
+function readEnv(env, key) {
+    const value = env[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+export function inferOpenAiCompatibleBiller(env, fallback = "openai") {
+    const explicitOpenRouterKey = readEnv(env, "OPENROUTER_API_KEY");
+    if (explicitOpenRouterKey)
+        return "openrouter";
+    const baseUrl = readEnv(env, "OPENAI_BASE_URL") ??
+        readEnv(env, "OPENAI_API_BASE") ??
+        readEnv(env, "OPENAI_API_BASE_URL");
+    if (baseUrl && /openrouter\.ai/i.test(baseUrl))
+        return "openrouter";
+    return fallback;
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"AAAA,SAAS,OAAO,CAAC,GAAsB,EAAE,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,GAAsB,EACtB,WAA0B,QAAQ;IAElC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACjE,IAAI,qBAAqB;QAAE,OAAO,YAAY,CAAC;IAE/C,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAC/B,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAC/B,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAC;IAEpE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/billing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=billing.test.d.ts.map

package/dist/billing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.test.d.ts","sourceRoot":"","sources":["../src/billing.test.ts"],"names":[],"mappings":""}

package/dist/billing.test.js

@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+import { inferOpenAiCompatibleBiller } from "./billing.js";
+describe("inferOpenAiCompatibleBiller", () => {
+    it("returns openrouter when OPENROUTER_API_KEY is present", () => {
+        expect(inferOpenAiCompatibleBiller({ OPENROUTER_API_KEY: "sk-or-123" }, "openai")).toBe("openrouter");
+    });
+    it("returns openrouter when OPENAI_BASE_URL points at OpenRouter", () => {
+        expect(inferOpenAiCompatibleBiller({ OPENAI_BASE_URL: "https://openrouter.ai/api/v1" }, "openai")).toBe("openrouter");
+    });
+    it("returns fallback when no OpenRouter markers are present", () => {
+        expect(inferOpenAiCompatibleBiller({ OPENAI_BASE_URL: "https://api.openai.com/v1" }, "openai")).toBe("openai");
+    });
+});
+//# sourceMappingURL=billing.test.js.map

package/dist/billing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.test.js","sourceRoot":"","sources":["../src/billing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CACJ,2BAA2B,CAAC,EAAE,kBAAkB,EAAE,WAAW,EAAuB,EAAE,QAAQ,CAAC,CAChG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CACJ,2BAA2B,CACzB,EAAE,eAAe,EAAE,8BAA8B,EAAuB,EACxE,QAAQ,CACT,CACF,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,2BAA2B,CACzB,EAAE,eAAe,EAAE,2BAA2B,EAAuB,EACrE,QAAQ,CACT,CACF,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { AgentRuntimeAgent, AgentRuntimeState, UsageSummary, AgentRuntimeBillingType, AgentRuntimeServiceReport, AgentRuntimeExecutionResult, AgentRuntimeLoadedSkillMeta, AgentRuntimeInvocationMeta, AgentRuntimeExecutionContext, AgentRuntimeEnvironmentCheckLevel, AgentRuntimeEnvironmentCheck, AgentRuntimeEnvironmentTestStatus, AgentRuntimeEnvironmentTestResult, AgentRuntimeEnvironmentTestContext, AgentRuntimeSkillSyncMode, AgentRuntimeSkillState, AgentRuntimeSkillOrigin, AgentRuntimeSkillEntry, AgentRuntimeSkillSnapshot, AgentRuntimeSkillContext, AgentRuntimeSessionCodec, AgentRuntimeModel, HireApprovedPayload, HireApprovedHookResult, ServerAgentRuntimeModule, QuotaWindow, ProviderQuotaResult, TranscriptEntry, StdoutLineParser, CLIAgentRuntimeModule, CreateConfigValues, } from "./types.js";
+export type { SessionCompactionPolicy, NativeContextManagement, AgentRuntimeSessionManagement, ResolvedSessionCompactionPolicy, } from "./session-compaction.js";
+export { AGENT_RUNTIME_SESSION_MANAGEMENT, LEGACY_SESSIONED_AGENT_RUNTIME_TYPES, getAgentRuntimeSessionManagement, readSessionCompactionOverride, resolveSessionCompactionPolicy, hasSessionCompactionThresholds, } from "./session-compaction.js";
+export { REDACTED_HOME_PATH_USER, redactHomePathUserSegments, redactHomePathUserSegmentsInValue, redactTranscriptEntryPaths, } from "./log-redaction.js";
+export { inferOpenAiCompatibleBiller } from "./billing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,iCAAiC,EACjC,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,EACjC,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AGENT_RUNTIME_SESSION_MANAGEMENT, LEGACY_SESSIONED_AGENT_RUNTIME_TYPES, getAgentRuntimeSessionManagement, readSessionCompactionOverride, resolveSessionCompactionPolicy, hasSessionCompactionThresholds, } from "./session-compaction.js";
+export { REDACTED_HOME_PATH_USER, redactHomePathUserSegments, redactHomePathUserSegmentsInValue, redactTranscriptEntryPaths, } from "./log-redaction.js";
+export { inferOpenAiCompatibleBiller } from "./billing.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuCA,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/dist/log-redaction.d.ts

@@ -0,0 +1,9 @@
+import type { TranscriptEntry } from "./types.js";
+export declare const REDACTED_HOME_PATH_USER = "*";
+export interface HomePathRedactionOptions {
+    enabled?: boolean;
+}
+export declare function redactHomePathUserSegments(text: string, opts?: HomePathRedactionOptions): string;
+export declare function redactHomePathUserSegmentsInValue<T>(value: T, opts?: HomePathRedactionOptions): T;
+export declare function redactTranscriptEntryPaths(entry: TranscriptEntry, opts?: HomePathRedactionOptions): TranscriptEntry;
+//# sourceMappingURL=log-redaction.d.ts.map

package/dist/log-redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-redaction.d.ts","sourceRoot":"","sources":["../src/log-redaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6BD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAOhG;AAED,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAgBjG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,eAAe,CAiCnH"}

package/dist/log-redaction.js

@@ -0,0 +1,87 @@
+export const REDACTED_HOME_PATH_USER = "*";
+function maskHomePathUserSegment(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return REDACTED_HOME_PATH_USER;
+    return `${trimmed[0]}${"*".repeat(Math.max(1, Array.from(trimmed).length - 1))}`;
+}
+const HOME_PATH_PATTERNS = [
+    {
+        regex: /\/Users\/([^/\\\s]+)/g,
+        replace: (_match, user) => `/Users/${maskHomePathUserSegment(user)}`,
+    },
+    {
+        regex: /\/home\/([^/\\\s]+)/g,
+        replace: (_match, user) => `/home/${maskHomePathUserSegment(user)}`,
+    },
+    {
+        regex: /([A-Za-z]:\\Users\\)([^\\/\s]+)/g,
+        replace: (_match, prefix, user) => `${prefix}${maskHomePathUserSegment(user)}`,
+    },
+];
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+export function redactHomePathUserSegments(text, opts) {
+    if (opts?.enabled === false)
+        return text;
+    let result = text;
+    for (const pattern of HOME_PATH_PATTERNS) {
+        result = result.replace(pattern.regex, pattern.replace);
+    }
+    return result;
+}
+export function redactHomePathUserSegmentsInValue(value, opts) {
+    if (typeof value === "string") {
+        return redactHomePathUserSegments(value, opts);
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactHomePathUserSegmentsInValue(entry, opts));
+    }
+    if (!isPlainObject(value)) {
+        return value;
+    }
+    const redacted = {};
+    for (const [key, entry] of Object.entries(value)) {
+        redacted[key] = redactHomePathUserSegmentsInValue(entry, opts);
+    }
+    return redacted;
+}
+export function redactTranscriptEntryPaths(entry, opts) {
+    switch (entry.kind) {
+        case "assistant":
+        case "thinking":
+        case "user":
+        case "stderr":
+        case "system":
+        case "stdout":
+            return { ...entry, text: redactHomePathUserSegments(entry.text, opts) };
+        case "tool_call":
+            return {
+                ...entry,
+                name: redactHomePathUserSegments(entry.name, opts),
+                input: redactHomePathUserSegmentsInValue(entry.input, opts),
+            };
+        case "tool_result":
+            return { ...entry, content: redactHomePathUserSegments(entry.content, opts) };
+        case "init":
+            return {
+                ...entry,
+                model: redactHomePathUserSegments(entry.model, opts),
+                sessionId: redactHomePathUserSegments(entry.sessionId, opts),
+            };
+        case "result":
+            return {
+                ...entry,
+                text: redactHomePathUserSegments(entry.text, opts),
+                subtype: redactHomePathUserSegments(entry.subtype, opts),
+                errors: entry.errors.map((error) => redactHomePathUserSegments(error, opts)),
+            };
+        default:
+            return entry;
+    }
+}
+//# sourceMappingURL=log-redaction.js.map

package/dist/log-redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-redaction.js","sourceRoot":"","sources":["../src/log-redaction.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAM3C,SAAS,uBAAuB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,uBAAuB,CAAC;IAC7C,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,kBAAkB,GAAG;IACzB;QACE,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,UAAU,uBAAuB,CAAC,IAAI,CAAC,EAAE;KACrF;IACD;QACE,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,uBAAuB,CAAC,IAAI,CAAC,EAAE;KACpF;IACD;QACE,KAAK,EAAE,kCAAkC;QACzC,OAAO,EAAE,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,EAAE;KACvG;CACO,CAAC;AAEX,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,IAA+B;IACtF,IAAI,IAAI,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAI,KAAQ,EAAE,IAA+B;IAC5F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAM,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAM,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,GAAG,iCAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,QAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAsB,EAAE,IAA+B;IAChG,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC1E,KAAK,WAAW;YACd,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;gBAClD,KAAK,EAAE,iCAAiC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;aAC5D,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAChF,KAAK,MAAM;YACT,OAAO;gBACL,GAAG,KAAK;gBACR,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;gBACpD,SAAS,EAAE,0BAA0B,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC;aAC7D,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;gBAClD,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;gBACxD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aAC7E,CAAC;QACJ;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/server-utils.d.ts

@@ -0,0 +1,146 @@
+import { type ChildProcess } from "node:child_process";
+import type { AgentRuntimeSkillSnapshot } from "./types.js";
+export interface RunProcessResult {
+    exitCode: number | null;
+    signal: string | null;
+    timedOut: boolean;
+    stdout: string;
+    stderr: string;
+    pid: number | null;
+    startedAt: string | null;
+}
+interface RunningProcess {
+    child: ChildProcess;
+    graceSec: number;
+}
+export declare const runningProcesses: Map<string, RunningProcess>;
+export declare const MAX_CAPTURE_BYTES: number;
+export declare const MAX_EXCERPT_BYTES: number;
+export interface RudderSkillEntry {
+    key: string;
+    runtimeName: string;
+    source: string;
+    name: string | null;
+    description: string | null;
+}
+export interface InstalledSkillTarget {
+    targetPath: string | null;
+    kind: "symlink" | "directory" | "file";
+}
+interface PersistentSkillSnapshotOptions {
+    agentRuntimeType: string;
+    availableEntries: RudderSkillEntry[];
+    desiredSkills: string[];
+    installed: Map<string, InstalledSkillTarget>;
+    skillsHome: string;
+    locationLabel?: string | null;
+    installedDetail?: string | null;
+    missingDetail: string;
+    externalConflictDetail: string;
+    externalDetail: string;
+    warnings?: string[];
+}
+export declare function readSkillMetadataFromPath(candidatePath: string | null | undefined): Promise<{
+    name: string | null;
+    description: string | null;
+}>;
+export declare function parseObject(value: unknown): Record<string, unknown>;
+export declare function asString(value: unknown, fallback: string): string;
+export declare function asNumber(value: unknown, fallback: number): number;
+export declare function asBoolean(value: unknown, fallback: boolean): boolean;
+export declare function asStringArray(value: unknown): string[];
+export declare function parseJson(value: string): Record<string, unknown> | null;
+export declare function appendWithCap(prev: string, chunk: string, cap?: number): string;
+export declare function resolvePathValue(obj: Record<string, unknown>, dottedPath: string): string;
+export declare function renderTemplate(template: string, data: Record<string, unknown>): string;
+export declare const DEFAULT_AGENT_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). Continue your Rudder work.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}";
+export declare const ISSUE_ASSIGN_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). You have been assigned to work on an issue.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Task Context\n\n**Issue:** {{issue.title}}\n**ID:** {{issue.id}}\n**Status:** {{issue.status}}\n**Priority:** {{issue.priority}}\n\n**Description:**\n{{issue.description}}\n\nYour task is to review this issue and begin working on it. Use the available tools to explore the codebase, understand the requirements, and implement a solution.";
+export declare const COMMENT_MENTION_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). You were mentioned in a comment and your attention is needed.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Context\n\n**Issue:** {{issue.title}}\n**ID:** {{issue.id}}\n\n**Issue Description:**\n{{issue.description}}\n\n**Comment:**\n{{comment.body}}\n\nPlease review the comment above and respond or take action as appropriate.";
+export declare const ISSUE_COMMENTED_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). There is a new comment on an issue you own.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Context\n\n**Issue:** {{issue.title}}\n**ID:** {{issue.id}}\n**Status:** {{issue.status}}\n\n**Issue Description:**\n{{issue.description}}\n\n**Latest Comment:**\n{{comment.body}}\n\nReview the new comment and continue the issue from the current state. Respond or take action as needed.";
+export declare const ISSUE_RECOVERY_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). This is a recovery run, not a fresh task.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Recovery Context\n\n**Original Run ID:** {{context.recovery.originalRunId}}\n**Failure Kind:** {{context.recovery.failureKind}}\n**Failure Summary:** {{context.recovery.failureSummary}}\n**Recovery Trigger:** {{context.recovery.recoveryTrigger}}\n**Recovery Mode:** {{context.recovery.recoveryMode}}\n\n## Current Issue Context\n\n**Issue:** {{issue.title}}\n**ID:** {{issue.id}}\n**Status:** {{issue.status}}\n**Priority:** {{issue.priority}}\n\n**Description:**\n{{issue.description}}\n\nBefore doing anything else, inspect what the previous run already completed and any side effects it may have caused. Continue the remaining work from the current state. Avoid blindly re-running the whole task.";
+export declare const RECOVERY_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). This is a recovery run, not a fresh task.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Recovery Context\n\n**Original Run ID:** {{context.recovery.originalRunId}}\n**Failure Kind:** {{context.recovery.failureKind}}\n**Failure Summary:** {{context.recovery.failureSummary}}\n**Recovery Trigger:** {{context.recovery.recoveryTrigger}}\n**Recovery Mode:** {{context.recovery.recoveryMode}}\n\nBefore doing anything else, inspect what the previous run already completed and any side effects it may have caused. Continue the remaining work from the current state. Avoid blindly re-running the whole task.";
+export declare const ISSUE_PASSIVE_FOLLOWUP_PROMPT_TEMPLATE = "You are agent {{agent.id}} ({{agent.name}}). This is a passive issue follow-up, not a fresh assignment and not a failure recovery.\n\n{{context.rudderWorkspace.orgResourcesPrompt}}\n\n## Why You Were Woken\n\nThe previous run ended without sufficient issue close-out.\n\n**Origin Run ID:** {{context.passiveFollowup.originRunId}}\n**Previous Run ID:** {{context.passiveFollowup.previousRunId}}\n**Attempt:** {{context.passiveFollowup.attempt}} / {{context.passiveFollowup.maxAttempts}}\n**Reason:** {{context.passiveFollowup.reason}}\n\n## Current Issue Context\n\n**Issue:** {{issue.title}}\n**ID:** {{issue.id}}\n**Status:** {{issue.status}}\n**Priority:** {{issue.priority}}\n\n**Description:**\n{{issue.description}}\n\nBefore changing the issue, inspect the current issue state and any side effects from the previous run. Then do exactly one close-out action: add a progress comment, mark the issue done, block it with a reason, or hand it off explicitly with explanation.";
+/**
+ * Selects the base heartbeat prompt template used by runtimes before final prompt assembly.
+ *
+ * Prompt shape by wake trigger:
+ * - assignment:
+ *   "You are agent ... You have been assigned ..."
+ *   Includes issue title/id/status/priority/description so the agent can start immediately.
+ * - comment.mention:
+ *   "You were mentioned in a comment ..."
+ *   Includes issue summary plus mention comment body so the agent can respond without extra fetches.
+ * - issue_commented:
+ *   "There is a new comment on an issue you own ..."
+ *   Includes issue summary plus the newest comment body so the assignee can continue immediately.
+ * - recovery:
+ *   "This is a recovery run, not a fresh task ..."
+ *   Includes original run id, failure metadata, and a continue-preferred instruction to
+ *   inspect prior progress/side effects before resuming.
+ * - passive issue follow-up:
+ *   "This is a passive issue follow-up, not a fresh assignment ..."
+ *   Includes close-out lineage and tells the agent to comment, finish, block, or hand off.
+ * - fallback:
+ *   Generic "Continue your Rudder work."
+ *
+ * Concrete rendered example (comment mention):
+ * "You are agent agent-456 (Backend Worker). You were mentioned in a comment and your attention is needed.
+ *  Issue: Stabilize queue worker
+ *  Comment: @agent please check timeout handling in retry path."
+ *
+ * Reasoning:
+ * - Keep backward compatibility: custom configured templates always win.
+ * - Keep first-turn latency low: include the minimum task context directly in prompt text.
+ * - Keep behavior deterministic across runtimes: template selection is centralized here.
+ *
+ * See also:
+ * - doc/plans/2026-04-07-agent-prompt-context-injection.md
+ * - doc/DEVELOPING.md
+ */
+export declare function selectPromptTemplate(configuredTemplate: string | undefined, context: Record<string, unknown>): string;
+export declare function joinPromptSections(sections: Array<string | null | undefined>, separator?: string): string;
+export declare function redactEnvForLogs(env: Record<string, string>): Record<string, string>;
+export declare function buildRudderEnv(agent: {
+    id: string;
+    orgId: string;
+}): Record<string, string>;
+export declare function defaultPathForPlatform(): "C:\\Windows\\System32;C:\\Windows;C:\\Windows\\System32\\Wbem" | "/usr/local/bin:/opt/homebrew/bin:/usr/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin";
+export declare function ensurePathInEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function ensureRudderCliInPath(moduleDir: string, env: NodeJS.ProcessEnv): Promise<NodeJS.ProcessEnv>;
+export declare function ensureAbsoluteDirectory(cwd: string, opts?: {
+    createIfMissing?: boolean;
+}): Promise<void>;
+export declare function resolveRudderSkillsDir(moduleDir: string, additionalCandidates?: string[]): Promise<string | null>;
+export declare function listRudderSkillEntries(moduleDir: string, additionalCandidates?: string[]): Promise<RudderSkillEntry[]>;
+export declare function readInstalledSkillTargets(skillsHome: string): Promise<Map<string, InstalledSkillTarget>>;
+export declare function buildPersistentSkillSnapshot(options: PersistentSkillSnapshotOptions): AgentRuntimeSkillSnapshot;
+export declare function readRudderRuntimeSkillEntries(config: Record<string, unknown>, moduleDir: string, additionalCandidates?: string[]): Promise<RudderSkillEntry[]>;
+export declare function readRudderSkillMarkdown(moduleDir: string, skillKey: string): Promise<string | null>;
+export declare function readRudderSkillSyncPreference(config: Record<string, unknown>): {
+    explicit: boolean;
+    desiredSkills: string[];
+};
+export declare function resolveRudderDesiredSkillNames(config: Record<string, unknown>, availableEntries: Array<{
+    key: string;
+    runtimeName?: string | null;
+}>): string[];
+export declare function writeRudderSkillSyncPreference(config: Record<string, unknown>, desiredSkills: string[]): Record<string, unknown>;
+export declare function ensureRudderSkillSymlink(source: string, target: string, linkSkill?: (source: string, target: string) => Promise<void>): Promise<"created" | "repaired" | "skipped">;
+export declare function removeMaintainerOnlySkillSymlinks(skillsHome: string, allowedSkillNames: Iterable<string>): Promise<string[]>;
+export declare function ensureCommandResolvable(command: string, cwd: string, env: NodeJS.ProcessEnv): Promise<void>;
+export declare function runChildProcess(runId: string, command: string, args: string[], opts: {
+    cwd: string;
+    env: Record<string, string>;
+    timeoutSec: number;
+    graceSec: number;
+    onLog: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    onLogError?: (err: unknown, runId: string, message: string) => void;
+    onSpawn?: (meta: {
+        pid: number;
+        startedAt: string;
+    }) => Promise<void>;
+    stdin?: string;
+    abortSignal?: AbortSignal;
+}): Promise<RunProcessResult>;
+export {};
+//# sourceMappingURL=server-utils.d.ts.map

package/dist/server-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.d.ts","sourceRoot":"","sources":["../src/server-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI9D,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD,eAAO,MAAM,gBAAgB,6BAAoC,CAAC;AAclE,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAQ3C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;CACxC;AAED,UAAU,8BAA8B;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA6ED,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACjG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CASD;AAqBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKnE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEpE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAEtD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAoB,UAGjF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,UAoBhF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAE7E;AAGD,eAAO,MAAM,6BAA6B,8HAGK,CAAC;AAEhD,eAAO,MAAM,4BAA4B,ueAc0H,CAAC;AAEpK,eAAO,MAAM,+BAA+B,oYAe+B,CAAC;AAE5E,eAAO,MAAM,+BAA+B,obAgB4D,CAAC;AAEzG,eAAO,MAAM,8BAA8B,+0BAsBuK,CAAC;AAEnN,eAAO,MAAM,wBAAwB,opBAY6K,CAAC;AAEnN,eAAO,MAAM,sCAAsC,s9BAuB2M,CAAC;AAE/P;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAClC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAmCR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAC1C,SAAS,SAAS,UAMnB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMpF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB3F;AAED,wBAAgB,sBAAsB,uJAKrC;AA0ED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAIzE;AAyFD,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAc5B;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,iBAiCzC;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,oBAAoB,GAAE,MAAM,EAAO,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,oBAAoB,GAAE,MAAM,EAAO,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA0B7B;AAED,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAS9G;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,8BAA8B,GACtC,yBAAyB,CAkG3B;AA4BD,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,oBAAoB,GAAE,MAAM,EAAO,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAM7B;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAiBA;AAyBD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,gBAAgB,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GACpE,MAAM,EAAE,CAMV;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CACvB,GACnC,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,CA2B7C;AAED,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,iBAQjG;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GACA,OAAO,CAAC,gBAAgB,CAAC,CA8J3B"}