@penclipai/adapter-utils 2026.401.0-canary.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paperclip AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 { AdapterAgent, AdapterRuntime, UsageSummary, AdapterBillingType, AdapterRuntimeServiceReport, AdapterExecutionResult, AdapterInvocationMeta, AdapterExecutionContext, AdapterEnvironmentCheckLevel, AdapterEnvironmentCheck, AdapterEnvironmentTestStatus, AdapterEnvironmentTestResult, AdapterEnvironmentTestContext, AdapterSkillSyncMode, AdapterSkillState, AdapterSkillOrigin, AdapterSkillEntry, AdapterSkillSnapshot, AdapterSkillContext, AdapterSessionCodec, AdapterModel, HireApprovedPayload, HireApprovedHookResult, ServerAdapterModule, QuotaWindow, ProviderQuotaResult, TranscriptEntry, StdoutLineParser, CLIAdapterModule, CreateConfigValues, } from "./types.js";
+export type { SessionCompactionPolicy, NativeContextManagement, AdapterSessionManagement, ResolvedSessionCompactionPolicy, } from "./session-compaction.js";
+export { ADAPTER_SESSION_MANAGEMENT, LEGACY_SESSIONED_ADAPTER_TYPES, getAdapterSessionManagement, 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,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,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 { ADAPTER_SESSION_MANAGEMENT, LEGACY_SESSIONED_ADAPTER_TYPES, getAdapterSessionManagement, 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":"AAsCA,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,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":"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"}

package/dist/server-utils.d.ts

@@ -0,0 +1,103 @@
+import { type ChildProcess } from "node:child_process";
+import type { AdapterSkillSnapshot } 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 PaperclipSkillEntry {
+    key: string;
+    runtimeName: string;
+    source: string;
+    required?: boolean;
+    requiredReason?: string | null;
+}
+export interface InstalledSkillTarget {
+    targetPath: string | null;
+    kind: "symlink" | "directory" | "file";
+}
+interface PersistentSkillSnapshotOptions {
+    adapterType: string;
+    availableEntries: PaperclipSkillEntry[];
+    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 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 function joinPromptSections(sections: Array<string | null | undefined>, separator?: string): string;
+export declare function redactEnvForLogs(env: Record<string, string>): Record<string, string>;
+export declare function buildInvocationEnvForLogs(env: Record<string, string>, options?: {
+    runtimeEnv?: NodeJS.ProcessEnv | Record<string, string>;
+    includeRuntimeKeys?: string[];
+    resolvedCommand?: string | null;
+    resolvedCommandEnvKey?: string;
+}): Record<string, string>;
+export declare function buildPaperclipEnv(agent: {
+    id: string;
+    companyId: 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 resolveCommandForLogs(command: string, cwd: string, env: NodeJS.ProcessEnv): Promise<string>;
+export declare function ensurePathInEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function ensureAbsoluteDirectory(cwd: string, opts?: {
+    createIfMissing?: boolean;
+}): Promise<void>;
+export declare function resolvePaperclipSkillsDir(moduleDir: string, additionalCandidates?: string[]): Promise<string | null>;
+export declare function listPaperclipSkillEntries(moduleDir: string, additionalCandidates?: string[]): Promise<PaperclipSkillEntry[]>;
+export declare function readInstalledSkillTargets(skillsHome: string): Promise<Map<string, InstalledSkillTarget>>;
+export declare function buildPersistentSkillSnapshot(options: PersistentSkillSnapshotOptions): AdapterSkillSnapshot;
+export declare function readPaperclipRuntimeSkillEntries(config: Record<string, unknown>, moduleDir: string, additionalCandidates?: string[]): Promise<PaperclipSkillEntry[]>;
+export declare function readPaperclipSkillMarkdown(moduleDir: string, skillKey: string): Promise<string | null>;
+export declare function readPaperclipSkillSyncPreference(config: Record<string, unknown>): {
+    explicit: boolean;
+    desiredSkills: string[];
+};
+export declare function resolvePaperclipDesiredSkillNames(config: Record<string, unknown>, availableEntries: Array<{
+    key: string;
+    runtimeName?: string | null;
+    required?: boolean;
+}>): string[];
+export declare function writePaperclipSkillSyncPreference(config: Record<string, unknown>, desiredSkills: string[]): Record<string, unknown>;
+export declare function ensurePaperclipSkillSymlink(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;
+}): 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":"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"}