humanish 0.0.1 → 0.15.1

package/dist/oss-remote-telemetry.js

@@ -0,0 +1,403 @@
+export const OSS_REMOTE_TELEMETRY_SCHEMA = "humanish.oss-remote-telemetry.v1";
+const REDACTED_URL_PARAM = "[redacted-url-param]";
+const DEFAULT_COMPLETION_CHECKED_AT = "1970-01-01T00:00:00.000Z";
+const secretPatterns = [
+    {
+        name: "openai-token",
+        pattern: /\bsk-(?:proj-)?[A-Za-z0-9_-]{20,}\b/g,
+        replacement: "[redacted-openai-key]"
+    },
+    {
+        name: "github-token",
+        pattern: /\b(?:gh[pousr]_[A-Za-z0-9_]{12,}|github_pat_[A-Za-z0-9_]{12,})\b/g,
+        replacement: "[redacted-github-token]"
+    },
+    {
+        name: "e2b-token",
+        pattern: /\be2b_[A-Za-z0-9_-]{12,}\b/g,
+        replacement: "[redacted-e2b-key]"
+    },
+    {
+        name: "bearer-token",
+        pattern: /\bBearer\s+[A-Za-z0-9._~+/=-]{12,}\b/gi,
+        replacement: "Bearer [redacted-token]"
+    },
+    {
+        name: "remote-home-path",
+        pattern: /\/home\/(?:user|runner)\/[^\s"']+/gi,
+        replacement: "[redacted-remote-path]"
+    },
+    {
+        name: "remote-tmp-path",
+        pattern: /\/tmp\/[^\s"']+/gi,
+        replacement: "[redacted-remote-path]"
+    }
+];
+export function buildOssRemoteTelemetry(input) {
+    const checkedAt = input.checkedAt ?? new Date().toISOString();
+    const redactedFields = new Set();
+    const sanitizeField = (field, value) => {
+        const sanitized = redactOssRemoteTelemetryText(value);
+        if (sanitized !== value) {
+            redactedFields.add(field);
+        }
+        return sanitized;
+    };
+    const sanitizeUrlField = (field, value) => {
+        const sanitized = sanitizeOssRemoteTelemetryUrl(value);
+        if (sanitized !== value) {
+            redactedFields.add(field);
+        }
+        return sanitized;
+    };
+    const fallbackLogTail = sanitizeField("logTail", input.logTail ?? "");
+    const completion = parseOssRemoteCompletion(input.completionJson ?? null, {
+        checkedAt,
+        fallbackLogTail
+    });
+    const processText = sanitizeField("processStateText", input.processStateText ?? "");
+    const process = {
+        state: classifyOssRemoteProcessState(processText),
+        summary: summarizeProcessState(processText),
+        text: processText
+    };
+    const appStatusText = sanitizeField("appStatusText", input.appStatusText ?? "");
+    const appUrl = normalizeOptionalText(input.appUrl);
+    const sanitizedAppUrl = appUrl ? sanitizeUrlField("appUrl", appUrl) : undefined;
+    const app = {
+        status: classifyOssRemoteAppStatus({
+            statusText: appStatusText,
+            ...(sanitizedAppUrl ? { url: sanitizedAppUrl } : {})
+        }),
+        statusText: appStatusText,
+        ...(sanitizedAppUrl ? { url: sanitizedAppUrl } : {})
+    };
+    const streamUrl = normalizeOptionalText(input.streamUrl);
+    const sanitizedStreamUrl = streamUrl ? sanitizeUrlField("streamUrl", streamUrl) : undefined;
+    const stream = {
+        present: Boolean(sanitizedStreamUrl),
+        ...(sanitizedStreamUrl ? { url: sanitizedStreamUrl } : {})
+    };
+    const nestedObserverPath = normalizeOptionalText(input.nestedObserverPath);
+    const sanitizedNestedObserverPath = nestedObserverPath
+        ? sanitizeField("nestedObserverPath", nestedObserverPath)
+        : undefined;
+    const nestedObserverPresent = input.nestedObserverPresent ?? completion.nestedObserverPresent;
+    const nestedObserver = {
+        presence: nestedObserverPresent === true
+            ? "present"
+            : nestedObserverPresent === false ? "missing" : "unknown",
+        ...(sanitizedNestedObserverPath ? { path: sanitizedNestedObserverPath } : {})
+    };
+    const actorText = sanitizeField("actorStateText", input.actorStateText ?? "");
+    const actorState = classifyOssRemoteActorState(actorText, process.state, completion.status);
+    const actor = {
+        state: actorState,
+        summary: summarizeActorState(actorState, actorText),
+        text: actorText
+    };
+    const status = resolveLaneStatus(completion.status, process.state, app.status, actor.state);
+    return {
+        schema: OSS_REMOTE_TELEMETRY_SCHEMA,
+        checkedAt,
+        status,
+        completion,
+        process,
+        app,
+        stream,
+        nestedObserver,
+        actor,
+        redaction: {
+            status: "passed",
+            redacted: redactedFields.size > 0,
+            fields: [...redactedFields].sort(),
+            notes: redactedFields.size > 0
+                ? "Remote bootstrap evidence was sanitized before telemetry modeling."
+                : "Remote bootstrap evidence contained no recognized token or auth URL patterns."
+        }
+    };
+}
+export function parseOssRemoteCompletion(payload, options = {}) {
+    const checkedAt = options.checkedAt ?? DEFAULT_COMPLETION_CHECKED_AT;
+    const parsed = parseCompletionPayload(payload);
+    if (!parsed) {
+        return {
+            checkedAt,
+            present: false,
+            ...(options.fallbackLogTail ? { logTail: tailLines(options.fallbackLogTail, 80) } : {}),
+            reason: "Remote bootstrap completion marker is missing.",
+            status: "missing"
+        };
+    }
+    const status = normalizeOssRemoteCompletionStatus(parsed.status);
+    if (!status) {
+        return {
+            checkedAt,
+            present: false,
+            ...(options.fallbackLogTail ? { logTail: tailLines(options.fallbackLogTail, 80) } : {}),
+            reason: "Remote bootstrap completion marker is missing a recognized status.",
+            status: "missing"
+        };
+    }
+    const nestedVerifyPassed = normalizeNestedVerifyPassed(parsed);
+    const logTail = typeof parsed.logTail === "string"
+        ? tailLines(redactOssRemoteTelemetryText(parsed.logTail), 80)
+        : options.fallbackLogTail ? tailLines(options.fallbackLogTail, 80) : undefined;
+    return {
+        checkedAt: typeof parsed.completedAt === "string" && parsed.completedAt.trim()
+            ? redactOssRemoteTelemetryText(parsed.completedAt).trim()
+            : checkedAt,
+        present: true,
+        reason: completionReason(parsed.reason, status),
+        status,
+        ...(typeof parsed.exitCode === "number" && Number.isFinite(parsed.exitCode) ? { exitCode: parsed.exitCode } : {}),
+        ...(logTail ? { logTail } : {}),
+        ...(typeof parsed.nestedObserverPresent === "boolean" ? { nestedObserverPresent: parsed.nestedObserverPresent } : {}),
+        ...(nestedVerifyPassed === undefined ? {} : { nestedVerifyPassed })
+    };
+}
+export function normalizeOssRemoteCompletionStatus(value) {
+    return value === "running"
+        || value === "passed"
+        || value === "failed"
+        || value === "blocked"
+        || value === "timed_out"
+        ? value
+        : null;
+}
+export function classifyOssRemoteProcessState(text) {
+    const normalized = text.trim();
+    if (!normalized) {
+        return "unknown";
+    }
+    if (/\bsuspended\b|\bstopped\b|\bsigtstp\b|\bsigstop\b/i.test(normalized)
+        || /\bstate\s*[:=]\s*t\b/i.test(normalized)
+        || /\bstat(?:e)?\s*[:=]?\s*[^\n]*\bT\+?\b/.test(normalized)
+        || /(?:^|\n)\s*\d+\s+T\+?\s+\S+/.test(normalized)
+        || /\bT\+?\s+(?:\d|pts\/|tty)/.test(normalized)) {
+        return "suspended";
+    }
+    if (/\b(?:exited|exit code|terminated|defunct|zombie|not running|no process|dead)\b/i.test(normalized)) {
+        return "exited";
+    }
+    if (/\b(?:running|listening|ready|started|pid\s*[=:]?\s*\d+)\b/i.test(normalized)
+        || /\bstate\s*[:=]\s*[rs]\b/i.test(normalized)
+        || /\bstat(?:e)?\s*[:=]?\s*[^\n]*\b[RS]\+?\b/.test(normalized)) {
+        return "running";
+    }
+    return "unknown";
+}
+export function classifyOssRemoteAppStatus(input) {
+    const statusText = input.statusText?.trim() ?? "";
+    if (!statusText && !input.url) {
+        return "missing";
+    }
+    if (/\b(?:200|204|ok|healthy|ready|running|listening|started|serving|vite ready|compiled successfully)\b/i.test(statusText)) {
+        return "running";
+    }
+    if (/\b(?:connection refused|eaddrinuse|failed|stopped|not running|timeout|timed out|cannot connect|no server)\b/i.test(statusText)) {
+        return "stopped";
+    }
+    return input.url ? "unknown" : "missing";
+}
+export function classifyOssRemoteActorState(actorStateText, processState = "unknown", completionStatus = "missing") {
+    const normalized = actorStateText.trim();
+    if (/\bsuspended\b|\bstopped\b|\bsigtstp\b|\bsigstop\b/i.test(normalized) || processState === "suspended") {
+        return "suspended";
+    }
+    if (/\btimed[ _-]?out\b|\btimeout\b/i.test(normalized) || completionStatus === "timed_out") {
+        return "timed_out";
+    }
+    if (/\bblocked\b/i.test(normalized) || completionStatus === "blocked") {
+        return "blocked";
+    }
+    if (/\b(?:failed|failure|exit code [1-9]\d*)\b/i.test(normalized) || completionStatus === "failed") {
+        return "failed";
+    }
+    if (/\b(?:passed|success|complete|completed)\b/i.test(normalized) || completionStatus === "passed") {
+        return "passed";
+    }
+    if (/\b(?:running|watching|active|spawned|pid\s*[=:]?\s*\d+)\b/i.test(normalized)
+        || processState === "running"
+        || completionStatus === "running") {
+        return "running";
+    }
+    return "unknown";
+}
+export function redactOssRemoteTelemetryText(value) {
+    const withoutUrlSecrets = replaceUrls(value, sanitizeOssRemoteTelemetryUrl);
+    return applySecretPatterns(withoutUrlSecrets);
+}
+export function sanitizeOssRemoteTelemetryUrl(value) {
+    return redactAuthQueryParams(applySecretPatterns(value));
+}
+function parseCompletionPayload(payload) {
+    if (!payload) {
+        return null;
+    }
+    if (typeof payload !== "string") {
+        return payload;
+    }
+    if (!payload.trim()) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(payload);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeNestedVerifyPassed(parsed) {
+    if (typeof parsed.nestedVerifyPassed === "boolean") {
+        return parsed.nestedVerifyPassed;
+    }
+    if (parsed.nestedVerifyStatus === "passed") {
+        return true;
+    }
+    if (parsed.nestedVerifyStatus === "failed") {
+        return false;
+    }
+    return undefined;
+}
+function completionReason(reason, status) {
+    if (typeof reason === "string" && reason.trim()) {
+        return compactReason(redactOssRemoteTelemetryText(reason));
+    }
+    switch (status) {
+        case "passed":
+            return "Remote bootstrap completed successfully.";
+        case "failed":
+            return "Remote bootstrap failed.";
+        case "blocked":
+            return "Remote bootstrap is blocked.";
+        case "timed_out":
+            return "Remote bootstrap completion timed out.";
+        case "running":
+            return "Remote bootstrap is still running.";
+    }
+}
+function resolveLaneStatus(completionStatus, processState, appStatus, actorState) {
+    if (completionStatus === "passed"
+        || completionStatus === "failed"
+        || completionStatus === "blocked"
+        || completionStatus === "timed_out"
+        || completionStatus === "running") {
+        return completionStatus;
+    }
+    if (actorState === "failed" || actorState === "blocked" || actorState === "timed_out" || actorState === "passed") {
+        return actorState;
+    }
+    if (actorState === "suspended" || processState === "suspended") {
+        return "blocked";
+    }
+    if (actorState === "running" || processState === "running" || appStatus === "running") {
+        return "running";
+    }
+    return "missing";
+}
+function summarizeProcessState(text) {
+    const state = classifyOssRemoteProcessState(text);
+    switch (state) {
+        case "running":
+            return "Remote process state indicates the bootstrap or actor is still running.";
+        case "suspended":
+            return "Remote process state indicates the actor is suspended or stopped.";
+        case "exited":
+            return "Remote process state indicates the bootstrap or actor exited.";
+        case "unknown":
+            return text.trim()
+                ? "Remote process state was captured but could not be classified."
+                : "No remote process state captured.";
+    }
+}
+function summarizeActorState(state, text) {
+    switch (state) {
+        case "running":
+            return "Actor state indicates work is still running.";
+        case "suspended":
+            return "Actor state indicates the process is suspended or stopped.";
+        case "passed":
+            return "Actor state indicates successful completion.";
+        case "failed":
+            return "Actor state indicates failure.";
+        case "blocked":
+            return "Actor state indicates a blocker.";
+        case "timed_out":
+            return "Actor state indicates timeout.";
+        case "unknown":
+            return text.trim()
+                ? "Actor state was captured but could not be classified."
+                : "No actor state captured.";
+    }
+}
+function compactReason(value) {
+    return value.replace(/\s+/g, " ").trim().slice(0, 240);
+}
+function tailLines(value, limit) {
+    return value.split(/\r?\n/).slice(-limit).join("\n").trim();
+}
+function normalizeOptionalText(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}
+function applySecretPatterns(value) {
+    return secretPatterns.reduce((current, entry) => current.replace(entry.pattern, entry.replacement), value);
+}
+function replaceUrls(value, replacer) {
+    return value.replace(/\bhttps?:\/\/[^\s"'<>]+/gi, (candidate) => {
+        const trailing = candidate.match(/[),.;\]]+$/)?.[0] ?? "";
+        const body = trailing ? candidate.slice(0, -trailing.length) : candidate;
+        return `${replacer(body)}${trailing}`;
+    });
+}
+function redactAuthQueryParams(value) {
+    const queryStart = value.indexOf("?");
+    if (queryStart === -1) {
+        return value;
+    }
+    const hashStart = value.indexOf("#", queryStart);
+    const queryEnd = hashStart === -1 ? value.length : hashStart;
+    const query = value.slice(queryStart + 1, queryEnd);
+    const sanitizedQuery = query.split("&").map((part) => {
+        if (!part) {
+            return part;
+        }
+        const equalsIndex = part.indexOf("=");
+        const key = equalsIndex === -1 ? part : part.slice(0, equalsIndex);
+        if (!isAuthLikeQueryKey(key)) {
+            return part;
+        }
+        return equalsIndex === -1 ? key : `${key}=${REDACTED_URL_PARAM}`;
+    }).join("&");
+    return `${value.slice(0, queryStart + 1)}${sanitizedQuery}${value.slice(queryEnd)}`;
+}
+function isAuthLikeQueryKey(value) {
+    const normalized = safeDecodeURIComponent(value).replace(/[^a-z0-9]/gi, "").toLowerCase();
+    return normalized.includes("token")
+        || normalized.includes("secret")
+        || normalized.includes("password")
+        || normalized.includes("credential")
+        || normalized.includes("auth")
+        || normalized.includes("apikey")
+        || normalized.includes("signature")
+        || normalized.includes("bearer")
+        || normalized.includes("jwt")
+        || normalized.includes("session")
+        || normalized === "key"
+        || normalized.endsWith("key")
+        || normalized === "sig";
+}
+function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=oss-remote-telemetry.js.map

package/dist/oss-remote-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oss-remote-telemetry.js","sourceRoot":"","sources":["../src/oss-remote-telemetry.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,kCAAkC,CAAC;AAyF9E,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAClD,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAEjE,MAAM,cAAc,GAIf;IACH;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,mEAAmE;QAC5E,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,wCAAwC;QACjD,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,wBAAwB;KACtC;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,KAA8B;IACpE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;QAC7D,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACxB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;QAChE,MAAM,SAAS,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACxB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,cAAc,IAAI,IAAI,EAAE;QACxE,SAAS;QACT,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,aAAa,CAAC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG;QACd,KAAK,EAAE,6BAA6B,CAAC,WAAW,CAAC;QACjD,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC;QAC3C,IAAI,EAAE,WAAW;KAClB,CAAC;IAEF,MAAM,aAAa,GAAG,aAAa,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,0BAA0B,CAAC;YACjC,UAAU,EAAE,aAAa;YACzB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC;QACF,UAAU,EAAE,aAAa;QACzB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IAEF,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,kBAAkB,GAAG,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC;QACpC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;IAEF,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3E,MAAM,2BAA2B,GAAG,kBAAkB;QACpD,CAAC,CAAC,aAAa,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QACzD,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,IAAI,UAAU,CAAC,qBAAqB,CAAC;IAC9F,MAAM,cAAc,GAAG;QACrB,QAAQ,EAAE,qBAAqB,KAAK,IAAI;YACtC,CAAC,CAAC,SAAkB;YACpB,CAAC,CAAC,qBAAqB,KAAK,KAAK,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,SAAkB;QAC7E,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC;IAEF,MAAM,SAAS,GAAG,aAAa,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,2BAA2B,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC;QACnD,IAAI,EAAE,SAAS;KAChB,CAAC;IAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAE5F,OAAO;QACL,MAAM,EAAE,2BAA2B;QACnC,SAAS;QACT,MAAM;QACN,UAAU;QACV,OAAO;QACP,GAAG;QACH,MAAM;QACN,cAAc;QACd,KAAK;QACL,SAAS,EAAE;YACT,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,cAAc,CAAC,IAAI,GAAG,CAAC;YACjC,MAAM,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,EAAE;YAClC,KAAK,EAAE,cAAc,CAAC,IAAI,GAAG,CAAC;gBAC5B,CAAC,CAAC,oEAAoE;gBACtE,CAAC,CAAC,+EAA+E;SACpF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA4D,EAC5D,UAA4D,EAAE;IAE9D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,6BAA6B,CAAC;IACrE,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS;YACT,OAAO,EAAE,KAAK;YACd,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,EAAE,gDAAgD;YACxD,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,kCAAkC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS;YACT,OAAO,EAAE,KAAK;YACd,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,EAAE,oEAAoE;YAC5E,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAChD,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAC7D,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,OAAO;QACL,SAAS,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;YAC5E,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;YACzD,CAAC,CAAC,SAAS;QACb,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QAC/C,MAAM;QACN,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,OAAO,MAAM,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrH,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,OAAO,KAAK,KAAK,SAAS;WACrB,KAAK,KAAK,QAAQ;WAClB,KAAK,KAAK,QAAQ;WAClB,KAAK,KAAK,SAAS;WACnB,KAAK,KAAK,WAAW;QACxB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,oDAAoD,CAAC,IAAI,CAAC,UAAU,CAAC;WACpE,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC;WACxC,uCAAuC,CAAC,IAAI,CAAC,UAAU,CAAC;WACxD,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC;WAC9C,2BAA2B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAClD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,iFAAiF,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,4DAA4D,CAAC,IAAI,CAAC,UAAU,CAAC;WAC5E,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC;WAC3C,0CAA0C,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA4C;IACrF,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,sGAAsG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5H,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,8GAA8G,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACpI,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,cAAsB,EACtB,eAAsC,SAAS,EAC/C,mBAA8C,SAAS;IAEvD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,oDAAoD,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;QAC1G,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,iCAAiC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,KAAK,WAAW,EAAE,CAAC;QAC3F,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,4CAA4C,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACnG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,4CAA4C,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACnG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,4DAA4D,CAAC,IAAI,CAAC,UAAU,CAAC;WAC5E,YAAY,KAAK,SAAS;WAC1B,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC5E,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,qBAAqB,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,sBAAsB,CAAC,OAA4D;IAC1F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,MAA+B;IAClE,IAAI,OAAO,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe,EAAE,MAAqD;IAC9F,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAChD,OAAO,aAAa,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,0CAA0C,CAAC;QACpD,KAAK,QAAQ;YACX,OAAO,0BAA0B,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,8BAA8B,CAAC;QACxC,KAAK,WAAW;YACd,OAAO,wCAAwC,CAAC;QAClD,KAAK,SAAS;YACZ,OAAO,oCAAoC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,gBAA2C,EAC3C,YAAmC,EACnC,SAA6B,EAC7B,UAA+B;IAE/B,IAAI,gBAAgB,KAAK,QAAQ;WAC5B,gBAAgB,KAAK,QAAQ;WAC7B,gBAAgB,KAAK,SAAS;WAC9B,gBAAgB,KAAK,WAAW;WAChC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,UAAU,KAAK,WAAW,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,yEAAyE,CAAC;QACnF,KAAK,WAAW;YACd,OAAO,mEAAmE,CAAC;QAC7E,KAAK,QAAQ;YACX,OAAO,+DAA+D,CAAC;QACzE,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,IAAI,EAAE;gBAChB,CAAC,CAAC,gEAAgE;gBAClE,CAAC,CAAC,mCAAmC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAA0B,EAAE,IAAY;IACnE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,8CAA8C,CAAC;QACxD,KAAK,WAAW;YACd,OAAO,4DAA4D,CAAC;QACtE,KAAK,QAAQ;YACX,OAAO,8CAA8C,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,gCAAgC,CAAC;QAC1C,KAAK,SAAS;YACZ,OAAO,kCAAkC,CAAC;QAC5C,KAAK,WAAW;YACd,OAAO,gCAAgC,CAAC;QAC1C,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,IAAI,EAAE;gBAChB,CAAC,CAAC,uDAAuD;gBACzD,CAAC,CAAC,0BAA0B,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAgC;IAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,cAAc,CAAC,MAAM,CAC1B,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,EACrE,KAAK,CACN,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,QAAiC;IACnE,OAAO,KAAK,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC,SAAS,EAAE,EAAE;QAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACnE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACnE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1F,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;WAC9B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;WAC7B,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;WAC/B,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;WACjC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;WAC3B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;WAC7B,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;WAChC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;WAC7B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;WAC1B,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;WAC9B,UAAU,KAAK,KAAK;WACpB,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;WAC1B,UAAU,KAAK,KAAK,CAAC;AAC5B,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/persona.d.ts

@@ -0,0 +1,35 @@
+export type PersonaLevel = "low" | "medium" | "high";
+export interface ResolvedPersona {
+    id: string;
+    name: string;
+    summary?: string;
+    traits: {
+        patience: PersonaLevel;
+        skill: PersonaLevel;
+        accessibilityNeeds?: string;
+    };
+    constraints: string[];
+}
+export interface PersonaDirectives {
+    frictionTolerance: string;
+    skillBias: string;
+    accessibilityBehavior?: string;
+    constraints: string[];
+    traitsApplied: string[];
+}
+/**
+ * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
+ * supplies id/name when the document omits them (or is not a record at all).
+ */
+export declare function parseResolvedPersona(raw: unknown, fallback: {
+    id: string;
+    name: string;
+}): ResolvedPersona;
+export declare function personaToDirectives(persona: ResolvedPersona): PersonaDirectives;
+/**
+ * Render the persona section injected into an actor prompt. Replaces the bare
+ * `Persona: <name>.` line so the persona's friction tolerance, skill, and
+ * accessibility behavior actually shape the run. Returns a single space-joined
+ * string to match the existing prompt-builder style.
+ */
+export declare function renderPersonaPromptSection(persona: ResolvedPersona): string;

package/dist/persona.js

@@ -0,0 +1,133 @@
+// Compiles a committed persona (humanish/personas/*.yaml) into actor-neutral
+// behavioral directives so persona traits actually drive how the actor uses the
+// product, instead of being inert metadata. See docs/architecture/actor-contract.md.
+//
+// Patience is modeled as FRICTION TOLERANCE, never a turn/tool-call budget: the
+// directive tells the actor when, in character, to stop and report the friction.
+const LEVELS = ["low", "medium", "high"];
+function normalizeLevel(value, fallback = "medium") {
+    if (typeof value === "string") {
+        const lowered = value.trim().toLowerCase();
+        if (LEVELS.includes(lowered)) {
+            return lowered;
+        }
+    }
+    return fallback;
+}
+// Persona files are committed public-safe source, but they still flow into an
+// actor prompt, so replace control characters with spaces and cap length to
+// limit prompt-injection surface from a hand-authored persona.
+function stripControlChars(value) {
+    let out = "";
+    for (const ch of value) {
+        const code = ch.codePointAt(0) ?? 0;
+        out += code < 0x20 || code === 0x7f ? " " : ch;
+    }
+    return out;
+}
+function sanitizePersonaText(value, maxLength) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const cleaned = stripControlChars(value)
+        // Neutralize the actor verdict/nonce markers so persona text injected into a
+        // prompt cannot forge a verdict line an actor might echo back.
+        .replace(/HUMANISH_ACTOR_(?:VERDICT|NONCE)/gi, "HUMANISH_ACTOR_[neutralized]")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (cleaned.length === 0) {
+        return undefined;
+    }
+    return cleaned.length > maxLength ? `${cleaned.slice(0, maxLength - 1)}…` : cleaned;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
+ * supplies id/name when the document omits them (or is not a record at all).
+ */
+export function parseResolvedPersona(raw, fallback) {
+    const record = isRecord(raw) ? raw : {};
+    const traits = isRecord(record.traits) ? record.traits : {};
+    const id = sanitizePersonaText(record.id, 120) ?? fallback.id;
+    const name = sanitizePersonaText(record.name, 120) ?? fallback.name;
+    const summary = sanitizePersonaText(record.summary, 280);
+    const accessibilityNeeds = sanitizePersonaText(traits.accessibility_needs, 80);
+    const constraints = Array.isArray(record.constraints)
+        ? record.constraints
+            .map((entry) => sanitizePersonaText(entry, 160))
+            .filter((entry) => entry !== undefined)
+            .slice(0, 8)
+        : [];
+    return {
+        id,
+        name,
+        ...(summary === undefined ? {} : { summary }),
+        traits: {
+            patience: normalizeLevel(traits.patience),
+            // Persona YAML uses `technical_confidence`; the directive model calls it skill.
+            skill: normalizeLevel(traits.technical_confidence),
+            ...(accessibilityNeeds === undefined ? {} : { accessibilityNeeds })
+        },
+        constraints
+    };
+}
+const FRICTION_TOLERANCE = {
+    low: "You are impatient: if you hit repeated friction (errors, dead-ends, confusing UI) or stop making progress toward your goal, stop and report exactly what blocked you instead of pushing through.",
+    medium: "You have moderate patience: work through some friction, but if you repeatedly fail to make progress toward your goal, stop and report what blocked you.",
+    high: "You are determined: push through friction and try recovery paths, but if you reach an unrecoverable dead-end, stop and report it."
+};
+const SKILL_BIAS = {
+    low: "You are not technically confident: prefer obvious UI affordances over CLI flags or config, and narrate your confusion whenever the interface is ambiguous.",
+    medium: "You have moderate technical confidence: use straightforward paths and try one recovery step before giving up.",
+    high: "You are technically confident: use keyboard shortcuts, inspect configuration, and try the recovery paths an expert would."
+};
+function accessibilityBehavior(needs) {
+    const lowered = needs.toLowerCase();
+    if (lowered.includes("keyboard")) {
+        return "Navigate using the keyboard; treat a control that requires a mouse and offers no keyboard path as a defect and report it.";
+    }
+    if (lowered.includes("terminal") || lowered.includes("output")) {
+        return "You rely on clear terminal output; flag noisy, unreadable, or ambiguous output as a defect.";
+    }
+    return `You have the accessibility need "${needs}"; treat violations of it as defects and report them.`;
+}
+export function personaToDirectives(persona) {
+    const traitsApplied = [`patience:${persona.traits.patience}`, `skill:${persona.traits.skill}`];
+    const accessibility = persona.traits.accessibilityNeeds
+        ? accessibilityBehavior(persona.traits.accessibilityNeeds)
+        : undefined;
+    if (persona.traits.accessibilityNeeds) {
+        traitsApplied.push(`accessibility:${persona.traits.accessibilityNeeds}`);
+    }
+    if (persona.constraints.length > 0) {
+        traitsApplied.push(`constraints:${persona.constraints.length}`);
+    }
+    return {
+        frictionTolerance: FRICTION_TOLERANCE[persona.traits.patience],
+        skillBias: SKILL_BIAS[persona.traits.skill],
+        ...(accessibility === undefined ? {} : { accessibilityBehavior: accessibility }),
+        constraints: persona.constraints,
+        traitsApplied
+    };
+}
+/**
+ * Render the persona section injected into an actor prompt. Replaces the bare
+ * `Persona: <name>.` line so the persona's friction tolerance, skill, and
+ * accessibility behavior actually shape the run. Returns a single space-joined
+ * string to match the existing prompt-builder style.
+ */
+export function renderPersonaPromptSection(persona) {
+    const directives = personaToDirectives(persona);
+    const parts = [
+        `Persona: ${persona.name}.`,
+        ...(persona.summary ? [persona.summary] : []),
+        directives.frictionTolerance,
+        directives.skillBias,
+        ...(directives.accessibilityBehavior ? [directives.accessibilityBehavior] : []),
+        ...(directives.constraints.length > 0 ? [`Honor these constraints: ${directives.constraints.join("; ")}.`] : [])
+    ];
+    return parts.join(" ");
+}
+//# sourceMappingURL=persona.js.map

package/dist/persona.js.map

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