@tangle-network/braid 0.1.0

package/dist/domain/run-usage.js

@@ -0,0 +1,118 @@
+function usageBase(run) {
+    const { inputTokens: _inputTokens, outputTokens: _outputTokens, tokensKnown: _tokensKnown, reasoningTokens: _reasoningTokens, costUsd: _costUsd, usdKnown: _usdKnown, estimatedCostUsd: _estimatedCostUsd, promptCache: _promptCache, model: _model, ...base } = run;
+    return base;
+}
+function mergeCache(left, right) {
+    if (left === undefined)
+        return right;
+    if (right === undefined)
+        return left;
+    const output = { ...left };
+    for (const [key, value] of Object.entries(right))
+        output[key] = (output[key] ?? 0) + value;
+    return Object.freeze(output);
+}
+function maxOptional(left, right) {
+    if (left === undefined)
+        return right;
+    if (right === undefined)
+        return left;
+    return Math.max(left, right);
+}
+function maxCache(left, right) {
+    if (left === undefined)
+        return right;
+    if (right === undefined)
+        return left;
+    const output = { ...left };
+    for (const [key, value] of Object.entries(right))
+        output[key] = Math.max(output[key] ?? 0, value);
+    return Object.freeze(output);
+}
+/** Add one Runtime llm_call event to the live run total. */
+export function addRunUsage(run, usage) {
+    const { tokensKnown: _tokensKnown, usdKnown: _usdKnown, ...base } = run;
+    const priorCalls = run.llmCalls ?? 0;
+    const observedCalls = usage.calls ?? 1;
+    const firstCall = priorCalls === 0;
+    const tokensKnown = usage.tokensKnown !== false && (firstCall || run.tokensKnown !== false);
+    const usdKnown = usage.usdKnown !== false && (firstCall || run.usdKnown !== false);
+    const costUsd = (run.costUsd ?? 0) + (usage.costUsd ?? 0);
+    const estimatedCostUsd = (run.estimatedCostUsd ?? 0) + (usage.estimatedCostUsd ?? 0);
+    const promptCache = mergeCache(run.promptCache, usage.promptCache);
+    return {
+        ...base,
+        inputTokens: run.inputTokens + usage.input,
+        outputTokens: run.outputTokens + usage.output,
+        ...(tokensKnown ? {} : { tokensKnown: false }),
+        ...(usage.reasoning === undefined
+            ? {}
+            : { reasoningTokens: (run.reasoningTokens ?? 0) + usage.reasoning }),
+        ...(run.costUsd === undefined && usage.costUsd === undefined ? {} : { costUsd }),
+        ...(usdKnown ? {} : { usdKnown: false }),
+        ...(run.estimatedCostUsd === undefined && usage.estimatedCostUsd === undefined
+            ? {}
+            : { estimatedCostUsd }),
+        ...(promptCache === undefined ? {} : { promptCache }),
+        llmCalls: priorCalls + observedCalls,
+        ...(usage.latencyMs === undefined
+            ? {}
+            : { llmLatencyMs: (run.llmLatencyMs ?? 0) + usage.latencyMs }),
+        ...(usage.model === undefined ? {} : { model: usage.model }),
+    };
+}
+/** Replace live estimates with Runtime's terminal cumulative usage. */
+export function finalizeRunUsage(run, usage) {
+    const base = usageBase(run);
+    const tokensKnown = usage.tokensKnown !== false;
+    const usdKnown = usage.usdKnown !== false;
+    const inputTokens = tokensKnown ? usage.input : Math.max(run.inputTokens, usage.input);
+    const outputTokens = tokensKnown ? usage.output : Math.max(run.outputTokens, usage.output);
+    const reasoningTokens = tokensKnown
+        ? usage.reasoning
+        : maxOptional(run.reasoningTokens, usage.reasoning);
+    const observedCost = usdKnown ? usage.costUsd : maxOptional(run.costUsd, usage.costUsd);
+    const estimatedCostUsd = maxOptional(run.estimatedCostUsd, usage.estimatedCostUsd);
+    const promptCache = tokensKnown
+        ? (usage.promptCache ?? run.promptCache)
+        : maxCache(run.promptCache, usage.promptCache);
+    return {
+        ...base,
+        inputTokens,
+        outputTokens,
+        ...(tokensKnown ? {} : { tokensKnown: false }),
+        ...(reasoningTokens === undefined ? {} : { reasoningTokens }),
+        ...(observedCost === undefined ? {} : { costUsd: observedCost }),
+        ...(usdKnown ? {} : { usdKnown: false }),
+        ...(estimatedCostUsd === undefined ? {} : { estimatedCostUsd }),
+        ...(promptCache === undefined ? {} : { promptCache }),
+        ...(usage.calls === undefined ? {} : { llmCalls: usage.calls }),
+        ...(usage.model === undefined
+            ? run.model === undefined
+                ? {}
+                : { model: run.model }
+            : { model: usage.model }),
+    };
+}
+export function usageSnapshotForRun(run) {
+    return {
+        input: run.inputTokens,
+        output: run.outputTokens,
+        ...(run.llmCalls === undefined ? {} : { calls: run.llmCalls }),
+        ...(run.tokensKnown === false ? { tokensKnown: false } : {}),
+        ...(run.reasoningTokens === undefined ? {} : { reasoning: run.reasoningTokens }),
+        ...(run.costUsd === undefined ? {} : { costUsd: run.costUsd }),
+        ...(run.usdKnown === false ? { usdKnown: false } : {}),
+        ...(run.estimatedCostUsd === undefined ? {} : { estimatedCostUsd: run.estimatedCostUsd }),
+        ...(run.promptCache === undefined ? {} : { promptCache: run.promptCache }),
+        ...(run.llmLatencyMs === undefined ? {} : { latencyMs: run.llmLatencyMs }),
+        ...(run.model === undefined ? {} : { model: run.model }),
+    };
+}
+export const UNKNOWN_TURN_USAGE = Object.freeze({
+    input: 0,
+    output: 0,
+    tokensKnown: false,
+    usdKnown: false,
+});
+//# sourceMappingURL=run-usage.js.map

package/dist/domain/run-usage.js.map

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

package/dist/domain/runtime-diagnostics.d.ts

@@ -0,0 +1,4 @@
+export declare const BRAID_SANDBOX_INTERACTION_UNSUPPORTED: 'BRAID_SANDBOX_INTERACTION_UNSUPPORTED';
+export declare const BRAID_SANDBOX_CLEANUP_UNCONFIRMED: 'BRAID_SANDBOX_CLEANUP_UNCONFIRMED';
+export declare function publicRuntimeDiagnostic(value: unknown): string | undefined;
+//# sourceMappingURL=runtime-diagnostics.d.ts.map

package/dist/domain/runtime-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-diagnostics.d.ts","sourceRoot":"","sources":["../../src/domain/runtime-diagnostics.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qCAAqC,EAChD,uCAAgD,CAAA;AAClD,eAAO,MAAM,iCAAiC,EAAG,mCAA4C,CAAA;AAS7F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK1E"}

package/dist/domain/runtime-diagnostics.js

@@ -0,0 +1,13 @@
+export const BRAID_SANDBOX_INTERACTION_UNSUPPORTED = 'BRAID_SANDBOX_INTERACTION_UNSUPPORTED';
+export const BRAID_SANDBOX_CLEANUP_UNCONFIRMED = 'BRAID_SANDBOX_CLEANUP_UNCONFIRMED';
+const PUBLIC_RUNTIME_DIAGNOSTICS = Object.freeze({
+    [BRAID_SANDBOX_INTERACTION_UNSUPPORTED]: 'Sandbox requested user interaction, but this ephemeral route cannot retain and resume the environment',
+    [BRAID_SANDBOX_CLEANUP_UNCONFIRMED]: 'Sandbox deletion was not acknowledged; resource state is unknown',
+});
+export function publicRuntimeDiagnostic(value) {
+    if (typeof value !== 'string' || !Object.hasOwn(PUBLIC_RUNTIME_DIAGNOSTICS, value)) {
+        return undefined;
+    }
+    return PUBLIC_RUNTIME_DIAGNOSTICS[value];
+}
+//# sourceMappingURL=runtime-diagnostics.js.map

package/dist/domain/runtime-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-diagnostics.js","sourceRoot":"","sources":["../../src/domain/runtime-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qCAAqC,GAChD,uCAAgD,CAAA;AAClD,MAAM,CAAC,MAAM,iCAAiC,GAAG,mCAA4C,CAAA;AAE7F,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,CAAC,qCAAqC,CAAC,EACrC,uGAAuG;IACzG,CAAC,iCAAiC,CAAC,EACjC,kEAAkE;CACrE,CAAC,CAAA;AAEF,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC;QACnF,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,0BAA0B,CAAC,KAAgD,CAAC,CAAA;AACrF,CAAC"}

package/dist/domain/runtime-events.d.ts

@@ -0,0 +1,39 @@
+import type { AgentExactRunControlRef, InteractionRequest, StreamEvent } from '@tangle-network/agent-interface';
+import type { RuntimeStreamEvent } from '@tangle-network/agent-runtime';
+import type { ExecutionEnvironmentObservation } from './execution-observation.js';
+export type BraidRuntimeEvent = RuntimeStreamEvent | StreamEvent | {
+    readonly type: 'braid.execution.observed';
+    readonly observation: ExecutionEnvironmentObservation;
+    readonly controlRef?: AgentExactRunControlRef;
+    readonly timestamp: string;
+} | {
+    readonly type: 'unknown';
+    readonly originalType: string;
+    readonly payload: unknown;
+};
+export interface RuntimeEventEnvelope {
+    readonly runId: string;
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly cursor?: string;
+    readonly occurredAt?: string;
+    readonly receivedAt: string;
+    readonly event: BraidRuntimeEvent;
+}
+export interface RuntimeEventSummary {
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly type: string;
+    readonly cursor?: string;
+    readonly occurredAt?: string;
+}
+export declare function isRuntimeEventEnvelope(value: BraidRuntimeEvent | RuntimeEventEnvelope): value is RuntimeEventEnvelope;
+export declare function isInteractionEvent(event: BraidRuntimeEvent): event is Extract<StreamEvent, {
+    readonly type: 'interaction';
+}>;
+export declare function isFinalRuntimeEvent(event: BraidRuntimeEvent): event is Extract<RuntimeStreamEvent, {
+    readonly type: 'final';
+}>;
+export declare function runtimeEventType(event: BraidRuntimeEvent): string;
+export declare function interactionFromEvent(event: BraidRuntimeEvent): InteractionRequest | undefined;
+//# sourceMappingURL=runtime-events.d.ts.map

package/dist/domain/runtime-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.d.ts","sourceRoot":"","sources":["../../src/domain/runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACZ,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAA;AAEjF,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,WAAW,GACX;IACE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;IACzC,QAAQ,CAAC,WAAW,EAAE,+BAA+B,CAAA;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAEL,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,GAAG,oBAAoB,GAC9C,KAAK,IAAI,oBAAoB,CAS/B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAEjE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,GACvB,KAAK,IAAI,OAAO,CAAC,kBAAkB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAElE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,CAE7F"}

package/dist/domain/runtime-events.js

@@ -0,0 +1,21 @@
+export function isRuntimeEventEnvelope(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'runId' in value &&
+        'eventId' in value &&
+        'sequence' in value &&
+        'event' in value);
+}
+export function isInteractionEvent(event) {
+    return event.type === 'interaction' && 'request' in event;
+}
+export function isFinalRuntimeEvent(event) {
+    return event.type === 'final';
+}
+export function runtimeEventType(event) {
+    return event.type;
+}
+export function interactionFromEvent(event) {
+    return isInteractionEvent(event) ? event.request : undefined;
+}
+//# sourceMappingURL=runtime-events.js.map

package/dist/domain/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../../src/domain/runtime-events.ts"],"names":[],"mappings":"AAyCA,MAAM,UAAU,sBAAsB,CACpC,KAA+C;IAE/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,SAAS,IAAI,KAAK;QAClB,UAAU,IAAI,KAAK;QACnB,OAAO,IAAI,KAAK,CACjB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAwB;IAExB,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,SAAS,IAAI,KAAK,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAwB;IAExB,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,OAAO,KAAK,CAAC,IAAI,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAwB;IAC3D,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9D,CAAC"}

package/dist/domain/runtime-projection.d.ts

@@ -0,0 +1,85 @@
+import type { AgentExactRunControlRef, InteractionBinding, InteractionRequest } from '@tangle-network/agent-interface';
+import type { AutomationRuleRecord } from './entities-runtime.js';
+import type { Digest, OperationId } from './ids.js';
+import type { RunAdmissionReceipt, RunCapabilities } from './run-contracts.js';
+import type { RuntimeEventSummary } from './runtime-events.js';
+export interface MessagePartSource {
+    readonly eventId?: string;
+    readonly sequence?: number;
+    readonly cursor?: string;
+    readonly occurredAt?: string;
+}
+export type RuntimeMessagePartKind = 'text' | 'reasoning' | 'tool-call' | 'tool-result' | 'artifact' | 'proposal' | 'warning' | 'error' | 'interaction' | 'system' | 'unknown';
+export interface RuntimeMessagePart {
+    readonly id: string;
+    readonly kind: RuntimeMessagePartKind;
+    readonly text?: string;
+    readonly status?: string;
+    readonly toolName?: string;
+    readonly callId?: string;
+    readonly input?: unknown;
+    readonly result?: unknown;
+    readonly error?: string;
+    readonly artifactId?: string;
+    readonly uri?: string;
+    readonly mimeType?: string;
+    readonly title?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly source?: MessagePartSource;
+}
+export interface RuntimeMessageFields {
+    readonly parts: readonly RuntimeMessagePart[];
+    readonly partsTruncated?: boolean;
+}
+export interface BraidInteraction {
+    readonly request: InteractionRequest;
+    readonly responseBinding: InteractionBinding;
+    readonly runId: string;
+    readonly source: MessagePartSource;
+    readonly status: 'pending' | 'responding' | 'declined' | 'cancelled' | 'resolved' | 'unknown';
+    readonly responseOperation?: {
+        readonly operationId: OperationId;
+        readonly outcome: 'accepted' | 'declined' | 'cancelled';
+        readonly dataDigest?: Digest;
+        readonly containsSecret: boolean;
+        readonly automationRule?: AutomationRuleRecord;
+    };
+}
+export interface BraidActivity {
+    readonly id: string;
+    readonly runId: string;
+    readonly type: string;
+    readonly label: string;
+    readonly detail?: string;
+    readonly source?: MessagePartSource;
+}
+export interface QueuedInput {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly text: string;
+    readonly position: number;
+}
+export interface RuntimeRunFields {
+    readonly receipt: RunAdmissionReceipt;
+    readonly capabilities: RunCapabilities;
+    readonly controlRef?: AgentExactRunControlRef;
+    readonly reasoningTokens?: number;
+    readonly terminalReason?: string;
+    readonly lastCursor?: string;
+    readonly lastProviderSequence: number;
+    readonly eventCount: number;
+    readonly contentBytes?: number;
+    readonly contentTruncated?: boolean;
+    readonly missingSequence?: {
+        readonly from: number;
+        readonly to: number;
+    };
+    readonly interactions: readonly BraidInteraction[];
+    readonly activity: readonly BraidActivity[];
+    readonly eventDetails: readonly RuntimeEventSummary[];
+    readonly activityTruncated?: boolean;
+    readonly eventDetailsTruncated?: boolean;
+    readonly interactionsTruncated?: boolean;
+}
+export declare const LEGACY_RUN_CAPABILITIES: RunCapabilities;
+//# sourceMappingURL=runtime-projection.d.ts.map

package/dist/domain/runtime-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-projection.d.ts","sourceRoot":"","sources":["../../src/domain/runtime-projection.ts"],"names":[],"mappings":"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"}

package/dist/domain/runtime-projection.js

@@ -0,0 +1,8 @@
+export const LEGACY_RUN_CAPABILITIES = Object.freeze({
+    streaming: { live: true, replay: false, detach: false, turnIdempotency: true },
+    sessions: { continue: false, messages: false },
+    controls: { cancel: true, steer: false, queue: true, status: false, recreate: false },
+    events: { stableIdentity: false, sequence: true, cursor: false },
+    usage: true,
+});
+//# sourceMappingURL=runtime-projection.js.map

package/dist/domain/runtime-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-projection.js","sourceRoot":"","sources":["../../src/domain/runtime-projection.ts"],"names":[],"mappings":"AAwGA,MAAM,CAAC,MAAM,uBAAuB,GAAoB,MAAM,CAAC,MAAM,CAAC;IACpE,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE;IAC9E,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC9C,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACrF,MAAM,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAChE,KAAK,EAAE,IAAI;CACZ,CAAC,CAAA"}

package/dist/domain/secret-sanitizer.d.ts

@@ -0,0 +1,12 @@
+export declare const MAX_SANITIZED_TEXT_BYTES: number;
+export declare const SECRET_TRUNCATION_MARKER = "\u2026 [truncated]";
+export declare class SecretTextSanitizer {
+    #private;
+    constructor(maxOutputBytes?: number);
+    push(input: string): string;
+    finish(): string;
+}
+export declare function redactSensitiveText(input: string, maxBytes?: number): string;
+export declare function sanitizeTextChunks(chunks: Iterable<string>, maxBytes?: number): string;
+export declare function redactSensitiveUrls(input: string): string;
+//# sourceMappingURL=secret-sanitizer.d.ts.map

package/dist/domain/secret-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-sanitizer.d.ts","sourceRoot":"","sources":["../../src/domain/secret-sanitizer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,QAAa,CAAA;AAClD,eAAO,MAAM,wBAAwB,uBAAkB,CAAA;AAuGvD,qBAAa,mBAAmB;;IAQ9B,YAAY,cAAc,SAA2B,EAEpD;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1B;IAED,MAAM,IAAI,MAAM,CAUf;CAoHF;AAoCD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAA2B,GAAG,MAAM,CAG9F;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,SAA2B,GAClC,MAAM,CAKR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/domain/secret-sanitizer.js

@@ -0,0 +1,290 @@
+import { TerminalControlSanitizer } from './terminal-sanitizer.js';
+export const MAX_SANITIZED_TEXT_BYTES = 512 * 1024;
+export const SECRET_TRUNCATION_MARKER = '… [truncated]';
+const MAX_PENDING_BYTES = 4096;
+const MAX_LOOKBEHIND_CHARS = 1024;
+const BIDI_CONTROLS = /\p{Bidi_Control}/gu;
+const SECRET_ASSIGNMENT = /(^|[\s,;{[(])(?:password|passwd|passphrase|token|secret|credential|authorization|auth|key|api[_-]?key|access[_-]?key|private[_-]?key|client[_-]?secret|signature|cookie|header|query|fragment)\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s,;}\])}]*)/giu;
+const BEARER_ASSIGNMENT = /\bBearer(?:\s+|\s*=\s*)[^\s,;]*/giu;
+const BARE_CREDENTIAL = /(?:sk-[A-Za-z0-9_-]{20,}|github_pat_[A-Za-z0-9_]{20,}|gh[pousr]_[A-Za-z0-9]{20,}|AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{30,}|xox[baprs]-[A-Za-z0-9-]{20,})/gu;
+const WEB_URL = /https?:\/\/[^\s\p{Cc}<>"']+/giu;
+const INCOMPLETE_BEARER = /\bBearer(?:[\s]+|[\s]*=[\s]*)$/iu;
+const INCOMPLETE_URL = /(^|[\s([{<])https?:\/\/[^\s\p{Cc}<>"']*$/iu;
+const INCOMPLETE_ASSIGNMENT = /(^|[\s,;{[(])(?:password|passwd|passphrase|token|secret|credential|authorization|auth|key|api[_-]?key|access[_-]?key|private[_-]?key|client[_-]?secret|signature|cookie|header|query|fragment)\s*[:=]\s*(?:"[^"]*|'[^']*|[^\s,;}\])}]*)$/iu;
+const INCOMPLETE_BARE_CREDENTIAL = /(?:sk-|github_pat_|gh[pousr]_|AKIA|AIza|xox[baprs]-)[A-Za-z0-9_-]*$/u;
+function isUrlDelimiter(character) {
+    if (character === undefined || /\s/u.test(character))
+        return true;
+    const code = character.codePointAt(0) ?? 0;
+    return code <= 0x20 || code === 0x7f || code === 0x1b || '<>"\''.includes(character);
+}
+function safeUrl(candidate) {
+    try {
+        const url = new URL(candidate);
+        if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
+            return false;
+        if (url.pathname.split('/').some((segment) => segment !== '' && isSensitiveName(segment)))
+            return false;
+        for (const key of url.searchParams.keys())
+            if (isSensitiveName(key))
+                return false;
+        const fragment = url.hash.slice(1);
+        if (fragment) {
+            for (const key of new URLSearchParams(fragment).keys())
+                if (isSensitiveName(key))
+                    return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isSensitiveName(value) {
+    const normalized = value.replace(/[^a-z0-9]/giu, '').toLowerCase();
+    return (normalized.includes('password') ||
+        normalized.includes('passphrase') ||
+        normalized.includes('token') ||
+        normalized.includes('secret') ||
+        normalized.includes('authorization') ||
+        normalized.includes('credential') ||
+        normalized.includes('apikey') ||
+        normalized.includes('accesskey') ||
+        normalized.includes('privatekey') ||
+        normalized.includes('cookie') ||
+        normalized.includes('header') ||
+        normalized.includes('query') ||
+        normalized.includes('fragment') ||
+        normalized === 'key' ||
+        normalized.endsWith('key'));
+}
+function redactUrls(value) {
+    return value.replace(WEB_URL, (candidate) => {
+        let url = candidate;
+        let suffix = '';
+        while (/[),.;!?\]}]$/u.test(url)) {
+            suffix = `${url.at(-1)}${suffix}`;
+            url = url.slice(0, -1);
+        }
+        return safeUrl(url) ? candidate : `[redacted link]${suffix}`;
+    });
+}
+function redactStable(value) {
+    return redactUrls(value)
+        .replace(BEARER_ASSIGNMENT, '[redacted bearer]')
+        .replace(SECRET_ASSIGNMENT, (_match, prefix) => `${prefix}[redacted secret]`)
+        .replace(BARE_CREDENTIAL, '[redacted credential]')
+        .replace(BIDI_CONTROLS, '');
+}
+function takeUtf8Prefix(value, bytes) {
+    if (Buffer.byteLength(value, 'utf8') <= bytes)
+        return value;
+    let output = '';
+    let used = 0;
+    for (const character of value) {
+        const size = Buffer.byteLength(character, 'utf8');
+        if (used + size > bytes)
+            break;
+        output += character;
+        used += size;
+    }
+    return output;
+}
+function splitTail(value, bytes) {
+    if (Buffer.byteLength(value, 'utf8') <= bytes)
+        return ['', value];
+    const prefix = takeUtf8Prefix(value, Buffer.byteLength(value, 'utf8') - bytes);
+    return [prefix, value.slice(prefix.length)];
+}
+export class SecretTextSanitizer {
+    #terminal = new TerminalControlSanitizer();
+    #maxOutputBytes;
+    #pending = '';
+    #pendingSecret;
+    #outputBytes = 0;
+    #truncated = false;
+    constructor(maxOutputBytes = MAX_SANITIZED_TEXT_BYTES) {
+        this.#maxOutputBytes = maxOutputBytes;
+    }
+    push(input) {
+        this.#pending += this.#terminal.push(input);
+        return this.#drain(false);
+    }
+    finish() {
+        this.#pending += this.#terminal.finish();
+        const result = this.#drain(true);
+        if (this.#truncated && this.#outputBytes < this.#maxOutputBytes) {
+            const marker = SECRET_TRUNCATION_MARKER;
+            const boundedMarker = takeUtf8Prefix(marker, this.#maxOutputBytes - this.#outputBytes);
+            this.#outputBytes += Buffer.byteLength(boundedMarker, 'utf8');
+            return result + boundedMarker;
+        }
+        return result;
+    }
+    #drain(final) {
+        if (this.#pendingSecret !== undefined) {
+            this.#consumePendingSecret(final);
+            if (this.#pendingSecret !== undefined)
+                return '';
+        }
+        if (this.#pending.length === 0)
+            return '';
+        const pendingBytes = Buffer.byteLength(this.#pending, 'utf8');
+        if (!final && pendingBytes <= MAX_PENDING_BYTES)
+            return '';
+        const [stable, tail] = final
+            ? [this.#pending, '']
+            : splitTail(this.#pending, MAX_LOOKBEHIND_CHARS);
+        this.#pending = tail;
+        if (!stable)
+            return '';
+        const incomplete = final ? undefined : incompleteSecret(stable, tail);
+        if (incomplete !== undefined) {
+            const prefix = stable.slice(0, incomplete.start);
+            const boundary = incomplete.boundary;
+            this.#pendingSecret = incomplete.kind;
+            this.#pending = tail;
+            const before = redactStable(prefix + boundary);
+            const marker = incomplete.kind === 'bearer' ? '[redacted bearer]' : '[redacted secret]';
+            const emitted = this.#append(before + marker);
+            this.#consumePendingSecret(final);
+            return emitted;
+        }
+        const incompleteCredential = final ? undefined : incompleteBareCredential(stable, tail);
+        if (incompleteCredential !== undefined) {
+            const prefix = stable.slice(0, incompleteCredential.start);
+            const emitted = this.#append(`${redactStable(prefix)}[redacted credential]`);
+            this.#pendingSecret = 'bare';
+            this.#pending = tail;
+            this.#consumePendingSecret(final);
+            return emitted;
+        }
+        const incompleteUrl = final ? undefined : incompleteUrlAtBoundary(stable, tail);
+        if (incompleteUrl !== undefined) {
+            const prefix = stable.slice(0, incompleteUrl.start);
+            const emitted = this.#append(`${redactStable(prefix + incompleteUrl.boundary)}[redacted link]`);
+            this.#pendingSecret = 'url';
+            this.#pending = tail;
+            this.#consumePendingSecret(final);
+            return emitted;
+        }
+        const redacted = redactStable(stable);
+        return this.#append(redacted);
+    }
+    #append(value) {
+        const remaining = this.#maxOutputBytes - this.#outputBytes;
+        if (remaining <= 0) {
+            if (value.length > 0)
+                this.#truncated = true;
+            return '';
+        }
+        const bounded = takeUtf8Prefix(value, remaining);
+        this.#outputBytes += Buffer.byteLength(bounded, 'utf8');
+        if (bounded.length !== value.length)
+            this.#truncated = true;
+        return bounded;
+    }
+    #consumePendingSecret(final) {
+        if (this.#pendingSecret === undefined)
+            return;
+        const value = this.#pending;
+        if (this.#pendingSecret === 'url') {
+            const delimiter = [...value].findIndex(isUrlDelimiter);
+            if (delimiter < 0) {
+                this.#pending = final ? '' : value.slice(-MAX_LOOKBEHIND_CHARS);
+                if (final)
+                    this.#pendingSecret = undefined;
+                return;
+            }
+            this.#pending = value.slice(delimiter);
+            this.#pendingSecret = undefined;
+            return;
+        }
+        if (this.#pendingSecret === 'bare') {
+            const delimiter = value.search(/[^A-Za-z0-9_-]/u);
+            if (delimiter < 0) {
+                this.#pending = final ? '' : value.slice(-MAX_LOOKBEHIND_CHARS);
+                if (final)
+                    this.#pendingSecret = undefined;
+                return;
+            }
+            this.#pending = value.slice(delimiter);
+            this.#pendingSecret = undefined;
+            return;
+        }
+        let index = 0;
+        while (index < value.length && /\s/u.test(value[index] ?? ''))
+            index += 1;
+        if (index === value.length) {
+            this.#pending = final ? '' : value.slice(-MAX_LOOKBEHIND_CHARS);
+            if (final)
+                this.#pendingSecret = undefined;
+            return;
+        }
+        const quoted = value[index] === '"' || value[index] === "'";
+        if (quoted) {
+            const quote = value[index] ?? '';
+            const closing = value.indexOf(quote, index + 1);
+            if (closing < 0) {
+                this.#pending = final ? '' : value.slice(-MAX_LOOKBEHIND_CHARS);
+                if (final)
+                    this.#pendingSecret = undefined;
+                return;
+            }
+            this.#pending = value.slice(closing + 1);
+        }
+        else {
+            const delimiter = value.slice(index).search(/[\s,;}\])}]/u);
+            if (delimiter < 0) {
+                this.#pending = final ? '' : value.slice(-MAX_LOOKBEHIND_CHARS);
+                if (final)
+                    this.#pendingSecret = undefined;
+                return;
+            }
+            this.#pending = value.slice(index + delimiter);
+        }
+        this.#pendingSecret = undefined;
+    }
+}
+function incompleteSecret(stable, tail) {
+    const bearer = INCOMPLETE_BEARER.exec(stable);
+    if (bearer !== null)
+        return { kind: 'bearer', start: bearer.index, boundary: '' };
+    const assignment = INCOMPLETE_ASSIGNMENT.exec(stable);
+    if (assignment === null || /^[\s,;}\])}]/u.test(tail[0] ?? ''))
+        return undefined;
+    return {
+        kind: 'assignment',
+        start: assignment.index,
+        boundary: assignment[1] ?? '',
+    };
+}
+function incompleteUrlAtBoundary(stable, tail) {
+    if (isUrlDelimiter(tail[0]))
+        return undefined;
+    const match = INCOMPLETE_URL.exec(stable);
+    if (match === null)
+        return undefined;
+    return { start: match.index, boundary: match[1] ?? '' };
+}
+function incompleteBareCredential(stable, tail) {
+    if (!/^[A-Za-z0-9_-]/u.test(tail))
+        return undefined;
+    const match = INCOMPLETE_BARE_CREDENTIAL.exec(stable);
+    return match === null ? undefined : { start: match.index };
+}
+export function redactSensitiveText(input, maxBytes = MAX_SANITIZED_TEXT_BYTES) {
+    const sanitizer = new SecretTextSanitizer(maxBytes);
+    return `${sanitizer.push(input)}${sanitizer.finish()}`;
+}
+export function sanitizeTextChunks(chunks, maxBytes = MAX_SANITIZED_TEXT_BYTES) {
+    const sanitizer = new SecretTextSanitizer(maxBytes);
+    let output = '';
+    for (const chunk of chunks)
+        output += sanitizer.push(chunk);
+    return output + sanitizer.finish();
+}
+export function redactSensitiveUrls(input) {
+    return redactUrls(input);
+}
+//# sourceMappingURL=secret-sanitizer.js.map