@principles/core 1.76.0 → 1.78.0

package/dist/runtime-v2/feedback/feedback-types.js

@@ -0,0 +1,243 @@
+// feedback-types.ts
+// Core type definitions and runtime validators for the feedback report contract.
+// ERR-001/005/013: no `as` casts on untrusted input. All validation uses typeof + Object.hasOwn + isRecord.
+// ERR-002: failure paths include reason + nextAction.
+import { isString } from './internal-guards.js';
+// ── Type guards ──────────────────────────────────────────────────────────────
+const FEEDBACK_TYPES = [
+    'bug',
+    'confusing',
+    'privacy_concern',
+    'feature_request',
+    'other',
+];
+const USER_SEVERITIES = ['low', 'medium', 'high'];
+const FEEDBACK_SOURCES = ['console', 'cli', 'agent'];
+export function isFeedbackType(value) {
+    return typeof value === 'string' && FEEDBACK_TYPES.includes(value);
+}
+export function isUserSeverity(value) {
+    return typeof value === 'string' && USER_SEVERITIES.includes(value);
+}
+export function isFeedbackSource(value) {
+    return typeof value === 'string' && FEEDBACK_SOURCES.includes(value);
+}
+export function isRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (Array.isArray(value))
+        return false;
+    return true;
+}
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+// Re-export the shared isString guard so callers can import everything from one place.
+export { isString } from './internal-guards.js';
+// ── Validators (return ValidationError[]; do not throw) ──────────────────────
+function validateOptionalString(value, field, errors) {
+    if (value === undefined)
+        return undefined;
+    if (!isString(value)) {
+        errors.push({
+            field,
+            reason: `${field} must be a string when provided (ERR-010)`,
+            nextAction: `provide a string value for ${field} or omit it`,
+        });
+        return undefined;
+    }
+    return value;
+}
+function validateFeedbackContext(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'context',
+            reason: 'context must be a non-null object when provided',
+            nextAction: 'provide a valid context object or omit it',
+        });
+        return errors;
+    }
+    if (!Object.hasOwn(value, 'source')) {
+        errors.push({
+            field: 'context.source',
+            reason: 'context.source is required when context is provided (ERR-009)',
+            nextAction: 'add context.source with a value of console, cli, or agent',
+        });
+    }
+    else if (!isFeedbackSource(value.source)) {
+        errors.push({
+            field: 'context.source',
+            reason: 'context.source must be one of: console, cli, agent (ERR-010)',
+            nextAction: 'set context.source to a valid FeedbackSource value',
+        });
+    }
+    validateOptionalString(value.page, 'context.page', errors);
+    validateOptionalString(value.painId, 'context.painId', errors);
+    validateOptionalString(value.principleId, 'context.principleId', errors);
+    validateOptionalString(value.approvalId, 'context.approvalId', errors);
+    validateOptionalString(value.activationId, 'context.activationId', errors);
+    validateOptionalString(value.updateAttemptId, 'context.updateAttemptId', errors);
+    return errors;
+}
+function validateAgentDraft(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'agentDraft',
+            reason: 'agentDraft must be a non-null object when provided',
+            nextAction: 'provide a valid agentDraft object or omit it',
+        });
+        return errors;
+    }
+    if (!Object.hasOwn(value, 'summary')) {
+        errors.push({
+            field: 'agentDraft.summary',
+            reason: 'agentDraft.summary is required when agentDraft is provided (ERR-009)',
+            nextAction: 'add a summary field to agentDraft',
+        });
+    }
+    else if (!isString(value.summary)) {
+        errors.push({
+            field: 'agentDraft.summary',
+            reason: 'agentDraft.summary must be a string (ERR-010)',
+            nextAction: 'provide a string value for agentDraft.summary',
+        });
+    }
+    validateOptionalString(value.observedFailure, 'agentDraft.observedFailure', errors);
+    validateOptionalString(value.commandSummary, 'agentDraft.commandSummary', errors);
+    return errors;
+}
+/**
+ * Validate and normalize a `FeedbackDraftInput` value.
+ * Returns a discriminated union. Never throws.
+ */
+export function normalizeFeedbackDraftInput(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'root',
+            reason: 'feedback input must be a non-null object',
+            nextAction: 'provide a valid feedback draft input object',
+        });
+        return { ok: false, errors };
+    }
+    // Required: type
+    if (!Object.hasOwn(value, 'type')) {
+        errors.push({
+            field: 'type',
+            reason: 'type is required (ERR-009)',
+            nextAction: 'add a type field with a valid FeedbackType value',
+        });
+    }
+    else if (!isFeedbackType(value.type)) {
+        errors.push({
+            field: 'type',
+            reason: 'type must be one of: bug, confusing, privacy_concern, feature_request, other (ERR-010)',
+            nextAction: 'provide a valid FeedbackType string',
+        });
+    }
+    // Required: title
+    if (!Object.hasOwn(value, 'title')) {
+        errors.push({
+            field: 'title',
+            reason: 'title is required (ERR-009)',
+            nextAction: 'add a title field with a string value',
+        });
+    }
+    else if (!isString(value.title)) {
+        errors.push({
+            field: 'title',
+            reason: 'title must be a string (ERR-010)',
+            nextAction: 'provide a string value for title',
+        });
+    }
+    // Required: description
+    if (!Object.hasOwn(value, 'description')) {
+        errors.push({
+            field: 'description',
+            reason: 'description is required (ERR-009)',
+            nextAction: 'add a description field with a string value',
+        });
+    }
+    else if (!isString(value.description)) {
+        errors.push({
+            field: 'description',
+            reason: 'description must be a string (ERR-010)',
+            nextAction: 'provide a string value for description',
+        });
+    }
+    // Optional: stepsToReproduce, expectedBehavior, actualBehavior
+    validateOptionalString(value.stepsToReproduce, 'stepsToReproduce', errors);
+    validateOptionalString(value.expectedBehavior, 'expectedBehavior', errors);
+    validateOptionalString(value.actualBehavior, 'actualBehavior', errors);
+    // Optional: userSeverity
+    if (value.userSeverity !== undefined && !isUserSeverity(value.userSeverity)) {
+        errors.push({
+            field: 'userSeverity',
+            reason: 'userSeverity must be one of: low, medium, high (ERR-010)',
+            nextAction: 'provide a valid UserSeverity value or omit it',
+        });
+    }
+    // Optional: context (object, validated recursively)
+    let context = undefined;
+    if (value.context !== undefined) {
+        const ctxErrors = validateFeedbackContext(value.context);
+        for (const e of ctxErrors)
+            errors.push(e);
+        if (isRecord(value.context) && isFeedbackSource(value.context.source)) {
+            const c = value.context;
+            const built = { source: c.source };
+            if (isString(c.page))
+                built.page = c.page;
+            if (isString(c.painId))
+                built.painId = c.painId;
+            if (isString(c.principleId))
+                built.principleId = c.principleId;
+            if (isString(c.approvalId))
+                built.approvalId = c.approvalId;
+            if (isString(c.activationId))
+                built.activationId = c.activationId;
+            if (isString(c.updateAttemptId))
+                built.updateAttemptId = c.updateAttemptId;
+            context = built;
+        }
+    }
+    // Optional: agentDraft
+    let agentDraft = undefined;
+    if (value.agentDraft !== undefined) {
+        const adErrors = validateAgentDraft(value.agentDraft);
+        for (const e of adErrors)
+            errors.push(e);
+        if (isRecord(value.agentDraft) && isString(value.agentDraft.summary)) {
+            const a = value.agentDraft;
+            const built = { summary: a.summary };
+            if (isString(a.observedFailure))
+                built.observedFailure = a.observedFailure;
+            if (isString(a.commandSummary))
+                built.commandSummary = a.commandSummary;
+            agentDraft = built;
+        }
+    }
+    if (errors.length > 0)
+        return { ok: false, errors };
+    const type = value.type;
+    const title = value.title;
+    const description = value.description;
+    const userText = { description };
+    if (isString(value.stepsToReproduce))
+        userText.stepsToReproduce = value.stepsToReproduce;
+    if (isString(value.expectedBehavior))
+        userText.expectedBehavior = value.expectedBehavior;
+    if (isString(value.actualBehavior))
+        userText.actualBehavior = value.actualBehavior;
+    if (isUserSeverity(value.userSeverity))
+        userText.userSeverity = value.userSeverity;
+    const normalized = { type, title, userText };
+    if (context)
+        normalized.context = context;
+    if (agentDraft)
+        normalized.agentDraft = agentDraft;
+    return { ok: true, value: normalized };
+}
+//# sourceMappingURL=feedback-types.js.map

package/dist/runtime-v2/feedback/feedback-types.js.map

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

package/dist/runtime-v2/feedback/index.d.ts

@@ -0,0 +1,9 @@
+export type { FeedbackType, UserSeverity, FeedbackSource, FeedbackContext, AgentDraft, FeedbackUserText, FeedbackDraftInput, NormalizedDraft, RecentEvent, CanaryStatus, DiagnosticSummary, ContextRef, PrivacyPreview, FeedbackReport, ValidationError, NormalizeResult, } from './feedback-types.js';
+export { isFeedbackType, isUserSeverity, isFeedbackSource, isRecord, isBoolean, normalizeFeedbackDraftInput, } from './feedback-types.js';
+export { redactAbsolutePaths, redactTokenLikeValues, redactEnvLikeValues, redactStackTrace, redactSensitiveFields, REDACTED_PATH, REDACTED_VALUE, NO_STACK, type RedactResult, } from './redact-sensitive.js';
+export { renderReportMarkdown, MAX_MARKDOWN_LENGTH } from './render-markdown.js';
+export { buildGitHubIssueDraftUrl, MAX_URL_BODY_LENGTH, GITHUB_REPO, type GithubUrlResult, } from './render-github-url.js';
+export { buildPrivacyPreview, buildEmailText, DEFAULT_INCLUDED_SECTIONS, DEFAULT_EXCLUDED_CATEGORIES, } from './privacy-preview.js';
+export { createFeedbackReport, type CreateReportResult } from './create-report.js';
+export { safeStringifyPreview } from './safe-stringify.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/feedback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime-v2/feedback/index.js

@@ -0,0 +1,11 @@
+// feedback/index.ts
+// Barrel re-exports for the feedback report contract.
+// Pure logic only — no I/O, no fs, no process, no db, no network.
+export { isFeedbackType, isUserSeverity, isFeedbackSource, isRecord, isBoolean, normalizeFeedbackDraftInput, } from './feedback-types.js';
+export { redactAbsolutePaths, redactTokenLikeValues, redactEnvLikeValues, redactStackTrace, redactSensitiveFields, REDACTED_PATH, REDACTED_VALUE, NO_STACK, } from './redact-sensitive.js';
+export { renderReportMarkdown, MAX_MARKDOWN_LENGTH } from './render-markdown.js';
+export { buildGitHubIssueDraftUrl, MAX_URL_BODY_LENGTH, GITHUB_REPO, } from './render-github-url.js';
+export { buildPrivacyPreview, buildEmailText, DEFAULT_INCLUDED_SECTIONS, DEFAULT_EXCLUDED_CATEGORIES, } from './privacy-preview.js';
+export { createFeedbackReport } from './create-report.js';
+export { safeStringifyPreview } from './safe-stringify.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/feedback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,sDAAsD;AACtD,kEAAkE;AAqBlE,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,QAAQ,GAET,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,GAEZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAA2B,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime-v2/feedback/internal-guards.d.ts

@@ -0,0 +1,2 @@
+export declare function isString(value: unknown): value is string;
+//# sourceMappingURL=internal-guards.d.ts.map

package/dist/runtime-v2/feedback/internal-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-guards.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/internal-guards.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/dist/runtime-v2/feedback/internal-guards.js

@@ -0,0 +1,6 @@
+// internal-guards.ts
+// Re-exported shared primitive guards used across the feedback module.
+export function isString(value) {
+    return typeof value === 'string';
+}
+//# sourceMappingURL=internal-guards.js.map

package/dist/runtime-v2/feedback/internal-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-guards.js","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/internal-guards.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,uEAAuE;AAEvE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC"}

package/dist/runtime-v2/feedback/privacy-preview.d.ts

@@ -0,0 +1,14 @@
+import type { FeedbackReport, PrivacyPreview } from './feedback-types.js';
+export declare const DEFAULT_INCLUDED_SECTIONS: readonly string[];
+export declare const DEFAULT_EXCLUDED_CATEGORIES: readonly string[];
+/**
+ * Build a fresh PrivacyPreview object. Each call returns new arrays so callers
+ * may mutate the result without affecting the defaults.
+ */
+export declare function buildPrivacyPreview(redactionNotes: string[]): PrivacyPreview;
+/**
+ * Build an email-ready plain-text version of a FeedbackReport.
+ * Uses real '\n' newlines. BigInt/cycle-safe via safeStringifyPreview.
+ */
+export declare function buildEmailText(report: FeedbackReport): string;
+//# sourceMappingURL=privacy-preview.d.ts.map

package/dist/runtime-v2/feedback/privacy-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-preview.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/privacy-preview.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1E,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAOtD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EASxD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,cAAc,CAM5E;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA4E7D"}

package/dist/runtime-v2/feedback/privacy-preview.js

@@ -0,0 +1,128 @@
+// privacy-preview.ts
+// Privacy metadata and email-text rendering.
+// ERR-014/016/017: correct '\n' newlines, BigInt-safe, never throws on cycles.
+import { safeStringifyPreview } from './safe-stringify.js';
+import { redactAbsolutePaths, redactTokenLikeValues, redactEnvLikeValues } from './redact-sensitive.js';
+export const DEFAULT_INCLUDED_SECTIONS = [
+    'versions',
+    'platform',
+    'featureFlags',
+    'canary',
+    'userText',
+    'contextIds',
+];
+export const DEFAULT_EXCLUDED_CATEGORIES = [
+    'rawPrompt',
+    'rawChat',
+    'rawTrajectory',
+    'fileContents',
+    'fullPaths',
+    'envVars',
+    'tokens',
+    'fullStackTraces',
+];
+/**
+ * Build a fresh PrivacyPreview object. Each call returns new arrays so callers
+ * may mutate the result without affecting the defaults.
+ */
+export function buildPrivacyPreview(redactionNotes) {
+    return {
+        includedSections: [...DEFAULT_INCLUDED_SECTIONS],
+        excludedByDefault: [...DEFAULT_EXCLUDED_CATEGORIES],
+        redactionNotes: redactionNotes.slice(),
+    };
+}
+const MAX_EMAIL_FIELD = 1500;
+const MAX_EMAIL_DIAGNOSTIC_FIELD = 1200;
+function safe(s, max) {
+    if (typeof s !== 'string')
+        return '';
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max) + '…';
+}
+/**
+ * Build an email-ready plain-text version of a FeedbackReport.
+ * Uses real '\n' newlines. BigInt/cycle-safe via safeStringifyPreview.
+ */
+export function buildEmailText(report) {
+    const lines = [];
+    lines.push(`Subject: [PD feedback] [${report.type}] ${redactAbsolutePaths(report.title)}`);
+    lines.push('');
+    lines.push('— PD Feedback Report —');
+    lines.push(`ID: ${report.id}`);
+    lines.push(`Created: ${report.createdAt}`);
+    if (report.userText.userSeverity) {
+        lines.push(`User severity: ${report.userText.userSeverity}`);
+    }
+    lines.push('');
+    lines.push('— Description —');
+    lines.push(safe(report.userText.description, MAX_EMAIL_FIELD));
+    if (report.userText.stepsToReproduce) {
+        lines.push('');
+        lines.push('— Steps to reproduce —');
+        lines.push(safe(report.userText.stepsToReproduce, MAX_EMAIL_FIELD));
+    }
+    if (report.userText.expectedBehavior) {
+        lines.push('');
+        lines.push('— Expected behavior —');
+        lines.push(safe(report.userText.expectedBehavior, MAX_EMAIL_FIELD));
+    }
+    if (report.userText.actualBehavior) {
+        lines.push('');
+        lines.push('— Actual behavior —');
+        lines.push(safe(report.userText.actualBehavior, MAX_EMAIL_FIELD));
+    }
+    lines.push('');
+    lines.push('— Diagnostics (low-sensitivity) —');
+    lines.push('versions:');
+    lines.push(safeStringifyPreview(report.diagnosticSummary.versions).slice(0, MAX_EMAIL_DIAGNOSTIC_FIELD));
+    lines.push('platform:');
+    lines.push(safeStringifyPreview(report.diagnosticSummary.platform).slice(0, MAX_EMAIL_DIAGNOSTIC_FIELD));
+    lines.push('featureFlags:');
+    lines.push(safeStringifyPreview(report.diagnosticSummary.featureFlags).slice(0, MAX_EMAIL_DIAGNOSTIC_FIELD));
+    if (report.diagnosticSummary.canary.status === 'available') {
+        lines.push(`canary: available${report.diagnosticSummary.canary.summary ? ` — ${report.diagnosticSummary.canary.summary}` : ''}`);
+    }
+    else {
+        lines.push(`canary: unavailable${report.diagnosticSummary.canary.unavailableReason ? ` — ${report.diagnosticSummary.canary.unavailableReason}` : ''}`);
+    }
+    if (report.contextRefs.length > 0) {
+        lines.push('');
+        lines.push('— Context references —');
+        const maxContextRefs = 12;
+        const shownRefs = report.contextRefs.slice(0, maxContextRefs);
+        for (const r of shownRefs) {
+            const label = r.label ? ` — ${r.label}` : '';
+            lines.push(`- ${r.kind}: ${r.id}${label}`);
+        }
+        if (report.contextRefs.length > maxContextRefs) {
+            lines.push(`- … and ${report.contextRefs.length - maxContextRefs} more`);
+        }
+    }
+    lines.push('');
+    lines.push('— Privacy —');
+    lines.push('Included by default:');
+    for (const s of report.privacy.includedSections)
+        lines.push(`- ${s}`);
+    lines.push('Excluded by default:');
+    for (const s of report.privacy.excludedByDefault)
+        lines.push(`- ${s}`);
+    if (report.privacy.redactionNotes.length > 0) {
+        lines.push('Redaction notes:');
+        const maxNotes = 12;
+        const shownNotes = report.privacy.redactionNotes.slice(0, maxNotes);
+        for (const n of shownNotes)
+            lines.push(`- ${n}`);
+        if (report.privacy.redactionNotes.length > maxNotes) {
+            lines.push(`- … and ${report.privacy.redactionNotes.length - maxNotes} more`);
+        }
+    }
+    // Defense-in-depth: scrub any absolute path / token / env value that slipped through.
+    let email = lines.join('\n');
+    email = redactAbsolutePaths(email);
+    email = redactTokenLikeValues(email);
+    email = redactEnvLikeValues(email);
+    return email;
+}
+//# sourceMappingURL=privacy-preview.js.map

package/dist/runtime-v2/feedback/privacy-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-preview.js","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/privacy-preview.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/feedback/redact-sensitive.d.ts

@@ -0,0 +1,37 @@
+export declare const REDACTED_PATH = "<redacted-path>";
+export declare const REDACTED_VALUE = "[REDACTED]";
+export declare const NO_STACK = "<no-stack>";
+/**
+ * Replace absolute paths with `<redacted-path>`. Relative paths are left alone.
+ */
+export declare function redactAbsolutePaths(text: string): string;
+/**
+ * Replace token-like values with `[REDACTED]`.
+ */
+export declare function redactTokenLikeValues(text: string): string;
+export declare function redactEnvLikeValues(text: string): string;
+/**
+ * Reduce a stack trace to the error name and the first N frames (paths redacted).
+ * Empty input returns `<no-stack>`.
+ */
+export declare function redactStackTrace(text: string, maxFrames?: number): string;
+export type RedactResult = {
+    ok: true;
+    value: unknown;
+    notes: string[];
+} | {
+    ok: false;
+    error: string;
+    nextAction: string;
+};
+/**
+ * Recursively redact sensitive fields in an unknown value.
+ * Never throws. Returns a structured result with notes describing what was redacted.
+ *
+ * ERR-002: returns `{ok:false,error,nextAction}` for non-object top-level input
+ * because field redaction is a structured-data operation. Primitives carry no
+ * fields; their values should be sanitized via `redactTokenLikeValues` /
+ * `redactEnvLikeValues` / `redactAbsolutePaths` instead.
+ */
+export declare function redactSensitiveFields(value: unknown): RedactResult;
+//# sourceMappingURL=redact-sensitive.d.ts.map

package/dist/runtime-v2/feedback/redact-sensitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-sensitive.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/redact-sensitive.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAC/C,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,QAAQ,eAAe,CAAC;AAWrC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD;AAaD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAOD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiC,GAAG,MAAM,CAUnG;AAyCD,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAgIrD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CA2BlE"}