pi-daddy 0.28.0 → 0.32.0

package/dist/activity-timeline.d.ts

@@ -1,109 +0,0 @@
-export declare const ACTIVITY_TIMELINE_VERSION: 1;
-export declare const ENV_ACTIVITY_TIMELINE = "PI_DADDY_ACTIVITY_TIMELINE";
-export declare const ENV_ACTIVITY_CONTENT = "PI_DADDY_ACTIVITY_CONTENT";
-/** Per-child transport; these are observation identities, not capability authority. */
-export declare const ENV_ACTIVITY_PATH = "PI_DADDY_ACTIVITY_PATH";
-export declare const ENV_ACTIVITY_ROOT = "PI_DADDY_ACTIVITY_ROOT";
-export declare const ENV_ACTIVITY_TASK = "PI_DADDY_ACTIVITY_TASK";
-export declare const ENV_ACTIVITY_PARENT_TASK = "PI_DADDY_ACTIVITY_PARENT_TASK";
-export type TimelineFilter = "everything" | "agents" | "skills" | "needs-you";
-export interface ContentReference {
-    digest: string;
-    bytes: number;
-    ref?: string;
-}
-export interface ActivitySkill {
-    name: string;
-    source: string;
-    digest: string;
-}
-export interface ActivityEvent {
-    version: 1;
-    id: string;
-    kind: string;
-    at: string;
-    rootId: string;
-    taskId: string;
-    parentTaskId?: string;
-    agentId?: string;
-    agent?: string;
-    outcome?: string;
-    model?: string;
-    thinking?: string;
-    prompt?: ContentReference;
-    final?: ContentReference;
-    skill?: ActivitySkill;
-}
-export interface TimelineSkill extends ActivitySkill {
-    available: boolean;
-    read: boolean;
-    active: boolean;
-    superseded: boolean;
-}
-export interface TimelineTask {
-    id: string;
-    rootId: string;
-    parentTaskId?: string;
-    startedAt: string;
-    endedAt?: string;
-    status: "active" | "finished" | "failed" | "cancelled" | "needs-you";
-    model?: string;
-    thinking?: string;
-    prompt?: ContentReference;
-    final?: ContentReference;
-    skills: TimelineSkill[];
-    agents: Array<{
-        id: string;
-        parentTaskId?: string;
-        agent: string;
-        state: string;
-    }>;
-}
-export interface ActivityTimeline {
-    tasks: TimelineTask[];
-    refusals: string[];
-}
-export interface ActivityIdentity {
-    rootId: string;
-    path: string;
-    taskId?: string;
-    parentTaskId?: string;
-}
-/** Stable, unambiguous local selector: encoded root identity and task id, separated once by `:`. */
-export declare const activityTaskKey: (rootId: string, taskId: string) => string;
-export declare function parseActivityTimeline(text: string): ActivityTimeline;
-export declare function renderActivityTimeline(timeline: ActivityTimeline, options?: {
-    filter?: TimelineFilter;
-    details?: boolean;
-    content?: {
-        taskKey: string;
-        field: "prompt" | "final";
-        text: string;
-    };
-}): string;
-export declare const defaultActivityTimelinePath: (cwd: string) => string;
-export declare function activityIdentity(cwd: string, env?: NodeJS.ProcessEnv): ActivityIdentity;
-export declare class ActivityTimelineRecorder {
-    readonly enabled: boolean;
-    readonly contentEnabled: boolean;
-    readonly path: string;
-    readonly rootId: string;
-    private taskId?;
-    constructor(cwd: string, env?: NodeJS.ProcessEnv);
-    get task(): string | undefined;
-    attach(taskId: string): void;
-    start(prompt: string, model?: string, thinking?: string, parentTaskId?: string): Promise<string | undefined>;
-    childStarted(taskId: string, parentTaskId: string | undefined, agent: string, prompt: string, model?: string, thinking?: string): Promise<void>;
-    childFinished(taskId: string, parentTaskId: string | undefined, agent: string, final: string, outcome: "completed" | "failed" | "cancelled"): Promise<void>;
-    finish(final: string | undefined, outcome?: "completed" | "failed" | "cancelled"): Promise<void>;
-    skill(kind: "skill_available" | "skill_read" | "skill_active" | "skill_finished" | "skill_superseded", skill: ActivitySkill): Promise<void>;
-    append(kind: string, fields: Omit<Partial<ActivityEvent>, "version" | "id" | "kind" | "at" | "rootId" | "taskId">): Promise<void>;
-    private content;
-}
-export declare function readActivityContent(timelinePath: string, reference: ContentReference): Promise<string>;
-export declare function detailForTimeline(timelinePath: string, taskKey: string, field: "prompt" | "final"): Promise<{
-    taskKey: string;
-    field: "prompt" | "final";
-    text: string;
-}>;
-//# sourceMappingURL=activity-timeline.d.ts.map

package/dist/activity-timeline.d.ts.map

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

package/dist/activity-timeline.js

@@ -1,208 +0,0 @@
-/** Durable, local-only activity facts. Timeline events never infer skill compliance or provider reasoning. */
-import { createHash, randomUUID } from "node:crypto";
-import { constants } from "node:fs";
-import { appendFile, mkdir, open, readFile, realpath, rename, writeFile } from "node:fs/promises";
-import { dirname, join, resolve, sep } from "node:path";
-export const ACTIVITY_TIMELINE_VERSION = 1;
-export const ENV_ACTIVITY_TIMELINE = "PI_DADDY_ACTIVITY_TIMELINE";
-export const ENV_ACTIVITY_CONTENT = "PI_DADDY_ACTIVITY_CONTENT";
-/** Per-child transport; these are observation identities, not capability authority. */
-export const ENV_ACTIVITY_PATH = "PI_DADDY_ACTIVITY_PATH";
-export const ENV_ACTIVITY_ROOT = "PI_DADDY_ACTIVITY_ROOT";
-export const ENV_ACTIVITY_TASK = "PI_DADDY_ACTIVITY_TASK";
-export const ENV_ACTIVITY_PARENT_TASK = "PI_DADDY_ACTIVITY_PARENT_TASK";
-const MAX_EVENT_BYTES = 16 * 1024, MAX_CONTENT_BYTES = 256 * 1024;
-const DIGEST = /^[a-f0-9]{64}$/, REF = /^content\/[a-f0-9]{64}$/;
-const sha = (value) => createHash("sha256").update(value).digest("hex");
-const validId = (value) => typeof value === "string" && value.length > 0 && value.length <= 200;
-/** Stable, unambiguous local selector: encoded root identity and task id, separated once by `:`. */
-export const activityTaskKey = (rootId, taskId) => `${encodeURIComponent(rootId)}:${encodeURIComponent(taskId)}`;
-function taskFromKey(value) {
-    const parts = value.split(":");
-    if (parts.length !== 2 || value.length > 1400)
-        return null;
-    try {
-        const [rootId, taskId] = parts.map(decodeURIComponent);
-        return validId(rootId) && validId(taskId) && value === activityTaskKey(rootId, taskId) ? { rootId, taskId } : null;
-    }
-    catch {
-        return null;
-    }
-}
-function validRef(value) {
-    const ref = value;
-    return !!ref && typeof ref === "object" && DIGEST.test(String(ref.digest)) && Number.isSafeInteger(ref.bytes) && ref.bytes >= 0 &&
-        (ref.ref === undefined || (ref.bytes <= MAX_CONTENT_BYTES && REF.test(ref.ref)));
-}
-function eventOf(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return null;
-    const event = value;
-    if (event.version !== 1 || !validId(event.id) || !validId(event.kind) || !validId(event.rootId) || !validId(event.taskId) ||
-        typeof event.at !== "string" || !Number.isFinite(Date.parse(event.at)))
-        return null;
-    if ((event.parentTaskId && !validId(event.parentTaskId)) || (event.agentId && !validId(event.agentId)) ||
-        (event.agent && !validId(event.agent)) || (event.prompt && !validRef(event.prompt)) || (event.final && !validRef(event.final)))
-        return null;
-    if (event.skill && (!validId(event.skill.name) || typeof event.skill.source !== "string" || event.skill.source.length > 2048 || !DIGEST.test(event.skill.digest)))
-        return null;
-    return event;
-}
-export function parseActivityTimeline(text) {
-    const tasks = new Map(), refusals = [];
-    for (const [index, raw] of text.split("\n").entries()) {
-        if (!raw.trim())
-            continue;
-        let event = null;
-        try {
-            event = eventOf(JSON.parse(raw));
-        }
-        catch { /* reported below */ }
-        if (!event) {
-            refusals.push(`line ${index + 1}: invalid or unsafe timeline event`);
-            continue;
-        }
-        const key = `${event.rootId}\0${event.taskId}`;
-        let task = tasks.get(key);
-        if (!task) {
-            task = { id: event.taskId, rootId: event.rootId, parentTaskId: event.parentTaskId, startedAt: event.at, status: "active", skills: [], agents: [] };
-            tasks.set(key, task);
-        }
-        if (event.kind === "task_started") {
-            task.model = event.model;
-            task.thinking = event.thinking;
-            task.prompt = event.prompt;
-            task.parentTaskId = event.parentTaskId ?? task.parentTaskId;
-        }
-        if (event.kind === "task_finished") {
-            task.endedAt = event.at;
-            task.final = event.final;
-            task.status = event.outcome === "cancelled" ? "cancelled" : ["failed", "error"].includes(event.outcome ?? "") ? "failed" : "finished";
-        }
-        if (event.kind === "needs_you")
-            task.status = "needs-you";
-        if (event.skill) {
-            let skill = task.skills.find(value => value.name === event.skill.name && value.digest === event.skill.digest && value.source === event.skill.source);
-            if (!skill) {
-                skill = { ...event.skill, available: false, read: false, active: false, superseded: false };
-                task.skills.push(skill);
-            }
-            if (event.kind === "skill_available")
-                skill.available = true;
-            if (event.kind === "skill_read")
-                skill.read = true;
-            if (event.kind === "skill_active")
-                skill.active = true;
-            if (event.kind === "skill_finished")
-                skill.active = false;
-            if (event.kind === "skill_superseded") {
-                skill.superseded = true;
-                skill.active = false;
-            }
-        }
-        if (event.kind === "agent_started" && event.agentId)
-            task.agents.push({ id: event.agentId, parentTaskId: event.parentTaskId, agent: event.agent ?? "unknown", state: "active" });
-        if (event.kind === "agent_finished" && event.agentId) {
-            const agent = task.agents.find(value => value.id === event.agentId);
-            if (agent)
-                agent.state = event.outcome ?? "finished";
-        }
-    }
-    return { tasks: [...tasks.values()].sort((a, b) => a.startedAt.localeCompare(b.startedAt)), refusals };
-}
-function mark(status) { return status === "active" ? "●" : status === "needs-you" ? "!" : status === "failed" || status === "cancelled" ? "×" : "✓"; }
-export function renderActivityTimeline(timeline, options = {}) {
-    const filter = options.filter ?? "everything", lines = ["PI-DADDY ACTIVITY", ""];
-    const tasks = timeline.tasks.filter(task => filter === "everything" || filter === "needs-you" && task.status === "needs-you" || filter === "agents" && task.agents.length > 0 || filter === "skills" && task.skills.length > 0);
-    for (const task of tasks) {
-        lines.push(`${task.parentTaskId ? "  └─ " : ""}${mark(task.status)} ${task.id}  ${task.status}${task.model ? ` · ${task.model}` : ""}${task.thinking ? ` · requested thinking ${task.thinking}` : ""}`);
-        if (filter !== "agents")
-            for (const skill of task.skills)
-                lines.push(`  skill ${skill.name} · ${skill.available ? "available" : "availability unknown"}; ${skill.read ? "read" : "not observed read"}; ${skill.active ? "declared active" : "not declared active"}${skill.superseded ? "; superseded" : ""}`);
-        if (filter !== "skills")
-            for (const agent of task.agents)
-                lines.push(`  agent ${agent.agent} · ${agent.state}${agent.parentTaskId ? ` · parent ${agent.parentTaskId}` : ""}`);
-        if (options.details && (task.prompt || task.final)) {
-            const key = activityTaskKey(task.rootId, task.id);
-            lines.push(`  private details: p ${key} (submitted prompt) · f ${key} (final response)`);
-        }
-    }
-    if (options.content)
-        lines.push("", `PRIVATE ${options.content.field.toUpperCase()} · ${options.content.taskKey}`, options.content.text);
-    if (!tasks.length)
-        lines.push("No activity recorded yet.");
-    if (timeline.refusals.length)
-        lines.push(...timeline.refusals.map(refusal => `timeline refusal: ${refusal}`));
-    lines.push("", "Filters: Everything · Agents · Skills · Needs-you. Type p <root-id:task-id> or f <root-id:task-id> after d Details; shorthand task ids are refused. Read is observation; active is a declaration; neither proves compliance.");
-    return lines.join("\n");
-}
-export const defaultActivityTimelinePath = (cwd) => join(cwd, ".pi", "pi-daddy", "activity.jsonl");
-export function activityIdentity(cwd, env = process.env) {
-    const configured = env[ENV_ACTIVITY_TIMELINE]?.trim(), transported = env[ENV_ACTIVITY_PATH]?.trim();
-    const path = transported ? resolve(transported) : configured && configured !== "1" && configured !== "off" && configured !== "0" ? resolve(cwd, configured) : defaultActivityTimelinePath(cwd);
-    return { rootId: env[ENV_ACTIVITY_ROOT]?.trim() || randomUUID(), path, ...(env[ENV_ACTIVITY_TASK]?.trim() ? { taskId: env[ENV_ACTIVITY_TASK].trim() } : {}), ...(env[ENV_ACTIVITY_PARENT_TASK]?.trim() ? { parentTaskId: env[ENV_ACTIVITY_PARENT_TASK].trim() } : {}) };
-}
-export class ActivityTimelineRecorder {
-    enabled;
-    contentEnabled;
-    path;
-    rootId;
-    taskId;
-    constructor(cwd, env = process.env) { const configured = env[ENV_ACTIVITY_TIMELINE]?.trim(); this.enabled = configured !== "off" && configured !== "0"; this.contentEnabled = env[ENV_ACTIVITY_CONTENT]?.trim() !== "metadata-only" && env[ENV_ACTIVITY_CONTENT]?.trim() !== "off"; const identity = activityIdentity(cwd, env); this.path = identity.path; this.rootId = identity.rootId; this.taskId = identity.taskId; }
-    get task() { return this.taskId; }
-    attach(taskId) { this.taskId = taskId; }
-    async start(prompt, model, thinking, parentTaskId) { if (!this.enabled)
-        return undefined; this.taskId = randomUUID(); await this.append("task_started", { parentTaskId, model, thinking, prompt: await this.content(prompt) }); return this.taskId; }
-    async childStarted(taskId, parentTaskId, agent, prompt, model, thinking) { if (!this.enabled)
-        return; this.taskId = taskId; await this.append("task_started", { parentTaskId, agentId: taskId, agent, model, thinking, prompt: await this.content(prompt) }); await this.append("agent_started", { parentTaskId, agentId: taskId, agent }); }
-    async childFinished(taskId, parentTaskId, agent, final, outcome) { if (!this.enabled)
-        return; this.taskId = taskId; await this.append("agent_finished", { parentTaskId, agentId: taskId, agent, outcome }); await this.finish(final, outcome); }
-    async finish(final, outcome = "completed") { if (this.enabled && this.taskId)
-        await this.append("task_finished", { outcome, ...(final === undefined ? {} : { final: await this.content(final) }) }); }
-    async skill(kind, skill) { if (this.taskId)
-        await this.append(kind, { skill }); }
-    async append(kind, fields) { if (!this.enabled || !this.taskId)
-        return; const event = { version: 1, id: randomUUID(), kind, at: new Date().toISOString(), rootId: this.rootId, taskId: this.taskId, ...fields }; const text = JSON.stringify(event); if (Buffer.byteLength(text) > MAX_EVENT_BYTES)
-        throw Error("activity timeline event exceeds bound"); await mkdir(dirname(this.path), { recursive: true, mode: 0o700 }); await appendFile(this.path, `${text}\n`, { mode: 0o600 }); }
-    async content(value) { const digest = sha(value), bytes = Buffer.byteLength(value); if (!this.contentEnabled || bytes > MAX_CONTENT_BYTES)
-        return { digest, bytes }; const root = join(dirname(this.path), "content"), target = join(root, digest); await mkdir(root, { recursive: true, mode: 0o700 }); try {
-        await readFile(target, "utf8");
-    }
-    catch {
-        const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
-        await writeFile(temporary, value, { encoding: "utf8", mode: 0o600 });
-        await rename(temporary, target);
-    } return { digest, bytes, ref: `content/${digest}` }; }
-}
-export async function readActivityContent(timelinePath, reference) {
-    if (!validRef(reference) || !reference.ref)
-        throw Error("TIMELINE_REFERENCE_INVALID");
-    const root = resolve(dirname(timelinePath), "content"), target = resolve(dirname(timelinePath), reference.ref);
-    if (!target.startsWith(`${root}${sep}`) || await realpath(root) !== root)
-        throw Error("TIMELINE_REFERENCE_INVALID");
-    const handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
-    try {
-        const before = await handle.stat();
-        if (!before.isFile() || before.nlink !== 1 || before.size > MAX_CONTENT_BYTES)
-            throw Error("TIMELINE_REFERENCE_INVALID");
-        const value = await handle.readFile("utf8"), after = await handle.stat();
-        if (after.size !== before.size || Buffer.byteLength(value) !== reference.bytes || sha(value) !== reference.digest)
-            throw Error("TIMELINE_REFERENCE_TAMPERED");
-        return value;
-    }
-    finally {
-        await handle.close();
-    }
-}
-export async function detailForTimeline(timelinePath, taskKey, field) {
-    const identity = taskFromKey(taskKey);
-    if (!identity)
-        throw Error("TIMELINE_DETAIL_INVALID");
-    const timeline = parseActivityTimeline(await readFile(timelinePath, "utf8"));
-    const task = timeline.tasks.find(value => value.rootId === identity.rootId && value.id === identity.taskId);
-    const reference = task?.[field];
-    if (!reference)
-        throw Error("TIMELINE_DETAIL_UNAVAILABLE");
-    return { taskKey, field, text: await readActivityContent(timelinePath, reference) };
-}
-//# sourceMappingURL=activity-timeline.js.map

package/dist/activity-timeline.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity-timeline.js","sourceRoot":"","sources":["../src/activity-timeline.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAChE,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AACxE,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,EAAE,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAC;AAClE,MAAM,MAAM,GAAG,gBAAgB,EAAE,GAAG,GAAG,yBAAyB,CAAC;AAmBjE,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;AACzG,oGAAoG;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACjI,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3F,IAAI,CAAC;QAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAAC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC5M,CAAC;AACD,SAAS,QAAQ,CAAC,KAAc;IAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC;QAC7H,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,iBAAiB,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AACD,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,KAAK,GAAG,KAA+B,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QACrH,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChJ,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/K,OAAO,KAAsB,CAAC;AAChC,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,EAAE,QAAQ,GAAa,EAAE,CAAC;IACvE,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAAE,SAAS;QAC1B,IAAI,KAAK,GAAyB,IAAI,CAAC;QACvC,IAAI,CAAC;YAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC/F,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/C,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,IAAI,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAAC,CAAC;QACxL,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;QAAC,CAAC;QACzL,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAAC,CAAC;QACjO,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,KAAM,CAAC,KAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,KAAM,CAAC,KAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAM,CAAC,KAAM,CAAC,MAAM,CAAC,CAAC;YAC3J,IAAI,CAAC,KAAK,EAAE,CAAC;gBAAC,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;gBAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YACrI,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;gBAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YACnD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACvD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;gBAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;gBAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YAAC,CAAC;QAC3F,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjL,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAM,CAAC,OAAO,CAAC,CAAC;YAAC,IAAI,KAAK;gBAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,UAAU,CAAC;QAAC,CAAC;IACvL,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;AACzG,CAAC;AACD,SAAS,IAAI,CAAC,MAA8B,IAAY,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACtL,MAAM,UAAU,sBAAsB,CAAC,QAA0B,EAAE,UAAkI,EAAE;IACrM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,KAAK,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChO,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxM,IAAI,MAAM,KAAK,QAAQ;YAAE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,qBAAqB,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9S,IAAI,MAAM,KAAK,QAAQ;YAAE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9K,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,GAAG,2BAA2B,GAAG,mBAAmB,CAAC,CAAC;QAAC,CAAC;IACtM,CAAC;IACD,IAAI,OAAO,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzI,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9G,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,8NAA8N,CAAC,CAAC;IAC/O,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AACD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAC3G,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;IAChF,MAAM,UAAU,GAAG,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,WAAW,GAAG,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC;IACpG,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;IAC/L,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1Q,CAAC;AACD,MAAM,OAAO,wBAAwB;IAC1B,OAAO,CAAU;IAAU,cAAc,CAAU;IAAU,IAAI,CAAS;IAAU,MAAM,CAAS;IAAS,MAAM,CAAU;IACrI,YAAY,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG,IAAI,MAAM,UAAU,GAAG,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,KAAK,eAAe,IAAI,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACtb,IAAI,IAAI,KAAyB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,MAAc,IAAU,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,KAAc,EAAE,QAAiB,EAAE,YAAqB,IAAiC,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrT,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,YAAgC,EAAE,KAAa,EAAE,MAAc,EAAE,KAAc,EAAE,QAAiB,IAAmB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1Z,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,YAAgC,EAAE,KAAa,EAAE,KAAa,EAAE,OAA6C,IAAmB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjV,KAAK,CAAC,MAAM,CAAC,KAAyB,EAAE,UAAgD,WAAW,IAAmB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/Q,KAAK,CAAC,KAAK,CAAC,IAA+F,EAAE,KAAoB,IAAmB,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1M,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAA4F,IAAmB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,KAAK,GAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,eAAe;QAAE,MAAM,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7kB,KAAK,CAAC,OAAO,CAAC,KAAa,IAA+B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,GAAG,iBAAiB;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;CACrmB;AACD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,YAAoB,EAAE,SAA2B;IACzF,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG;QAAE,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/G,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACpH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACpG,IAAI,CAAC;QAAC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,iBAAiB;YAAE,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAAC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAChc,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB,EAAE,OAAe,EAAE,KAAyB;IACtG,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5G,MAAM,SAAS,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,SAAS;QAAE,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC5F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC;AACtF,CAAC"}

package/dist/approval-prompt.d.ts

@@ -1,119 +0,0 @@
-/**
- * The approval dialog — the only place a human enters the capability-governance path.
- *
- * Kept out of `extensions/grants.ts` deliberately: that file is wiring only, and this holds decisions
- * (what to offer, what a dismissal means, what happens with nobody watching) that must be testable
- * without pi. `ApprovalUI` is the minimal slice of pi's `ExtensionUIContext` needed here, so a test can
- * supply a plain object.
- *
- * Everything here denies on uncertainty. pi already agrees: in non-interactive modes it installs a
- * no-op UI context whose `select` resolves undefined, so even a missed `hasUI` check would deny.
- */
-import { type ApprovalPath, type ApprovalScope } from "./approval.ts";
-import type { Capability } from "./resolve.ts";
-/** The slice of pi's `ExtensionUIContext` this module needs. */
-export interface ApprovalUI {
-    select(title: string, options: string[], opts?: {
-        timeout?: number;
-        signal?: AbortSignal;
-    }): Promise<string | undefined>;
-    notify(message: string, type?: "info" | "warning" | "error"): void;
-}
-export declare const DENY_LABEL = "Deny";
-export declare const SCOPE_LABELS: Record<ApprovalScope, string>;
-export interface PromptRequest {
-    capability: Capability;
-    /** Agent type name, or `DELEGATE_SUBJECT` on the delegate path. */
-    subject: string;
-    path: ApprovalPath;
-    /** Shown to the human for context. Never itself part of a key. */
-    task?: string;
-    /** Trusted exact-scope identity; bound requests single-flight only with an identical binding. */
-    bindingKey?: string;
-    signal?: AbortSignal;
-}
-/**
- * Which of the five outcomes a request produced.
- *
- * `scope: null` alone conflates four different kinds of no — a caller that needs to know whether a
- * PERSON actually declined (as opposed to nobody being there to ask, a dismissal, or the dialog itself
- * breaking) cannot recover that from `scope` or from parsing `reason`. Only "declined" means a human said
- * no; the other three are absence-of-signal, not a signal.
- */
-export declare const PROMPT_OUTCOME_KINDS: readonly ["granted", "declined", "dismissed", "no-ui", "error"];
-export type PromptOutcomeKind = typeof PROMPT_OUTCOME_KINDS[number];
-export interface PromptOutcome {
-    /** The scope the human chose, or null for any form of no. */
-    scope: ApprovalScope | null;
-    /** Which of the five outcomes this was. Set on every return path. */
-    kind: PromptOutcomeKind;
-    /** Why, when the answer was no. */
-    reason?: string;
-    /**
-     * True when this caller RODE another caller's answer rather than being asked (R-66).
-     *
-     * The single-flight queue shares any non-`once` outcome, which is right — a human approving
-     * `tool:bash` *for this session* authorised the capability, not one child. What is not right is
-     * recording the riders as though each had faced a dialog: the ledger's whole job is answering "did a
-     * human authorise this?", and a fan-out of eight wrote eight lines claiming a prompt where there was
-     * one. The rider's honest source is `session`, and this flag is how the caller can tell.
-     */
-    joined?: boolean;
-}
-export interface ApprovalGateOptions {
-    ui: ApprovalUI;
-    /** pi's `ctx.hasUI` — false in print/json mode, and therefore in every governed child. */
-    hasUI: boolean;
-    /** pi's `ctx.mode`, quoted back in the refusal so an operator can see why. */
-    mode: string;
-    timeoutMs?: number;
-}
-export interface ApprovalGate {
-    request(request: PromptRequest): Promise<PromptOutcome>;
-}
-/**
- * Read `PI_GRANTS_APPROVAL_TIMEOUT`, in SECONDS, into the milliseconds pi expects.
- *
- * `0` or an unparseable value means no timeout: waiting forever denies nothing, so it is the safe
- * interpretation of a value we do not understand.
- */
-export declare function timeoutMsFromEnv(raw: string | undefined): number | undefined;
-/**
- * The single-flight queue: one dialog per approval key at a time.
- *
- * `delegate` sets no `executionMode`, so an orchestrator can fan out several children at once and two can
- * hit the same gate simultaneously — otherwise two stacked dialogs asking the identical question.
- *
- * **R-29 — the key does two jobs, and only one of them may be shared.** `approvalKey` is
- * `capability@subject`, and on the delegate path the subject is the constant `DELEGATE_SUBJECT`, which is
- * deliberate: the only things naming a delegated child are the task and the tool list, both model-chosen,
- * and a key the model controls is not a key (`approval.ts:24-32`). That reasoning governs *approval
- * identity* — what a human said yes to, and what may be persisted — and it is right.
- *
- * It does **not** govern de-duplication. Sharing one dialog's outcome is correct for `session` and
- * `always`, which are genuinely answers about the session or the project, and for a decline or an error,
- * which answer everyone. It is **wrong for `once`**, which means *this spawn*. Measured before the fix:
- * four concurrent delegations gating `tool:bash`, one dialog, one click of *Allow once* → four `granted`
- * outcomes, with the human having seen only the first caller's task. That is a confused deputy, and it
- * falsified ADR-0014's decided property that "`once` stops at the boundary".
- */
-export type InFlightApprovals = Map<string, Promise<PromptOutcome>>;
-/**
- * Build gates that SHARE one single-flight queue.
- *
- * This exists because of how the wiring actually calls in. The gate's options depend on the per-call
- * `ExtensionContext` (`ui`, `hasUI`, `mode`), so the extension necessarily builds a gate per invocation —
- * and a gate that owns its queue privately therefore de-duplicates nothing across invocations, which is
- * exactly the case §6.1 exists for (two concurrent `delegate` calls are two separate invocations).
- *
- * The provider separates the two lifetimes: options stay per-call and fresh, the queue is created once and
- * lives as long as the provider. Preferred over a module-level map because that would be shared by every
- * gate in the process — including across tests — for no benefit.
- */
-export declare function createApprovalGateProvider(): (options: ApprovalGateOptions) => ApprovalGate;
-/**
- * @param inFlight optional shared single-flight queue — see `createApprovalGateProvider`. Defaults to one
- * private to this gate, which only de-duplicates requests made through this same gate object.
- */
-export declare function createApprovalGate(options: ApprovalGateOptions, inFlight?: InFlightApprovals): ApprovalGate;
-//# sourceMappingURL=approval-prompt.d.ts.map

package/dist/approval-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"approval-prompt.d.ts","sourceRoot":"","sources":["../src/approval-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA8B,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;CACpE;AAED,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAItD,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,iEAAkE,CAAC;AACpG,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,qEAAqE;IACrE,IAAI,EAAE,iBAAiB,CAAC;IACxB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,UAAU,CAAC;IACf,0FAA0F;IAC1F,KAAK,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK5E;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,IAAI,CAAC,OAAO,EAAE,mBAAmB,KAAK,YAAY,CAG3F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,iBAA6B,GACtC,YAAY,CAwEd"}

package/dist/approval-prompt.js

@@ -1,133 +0,0 @@
-/**
- * The approval dialog — the only place a human enters the capability-governance path.
- *
- * Kept out of `extensions/grants.ts` deliberately: that file is wiring only, and this holds decisions
- * (what to offer, what a dismissal means, what happens with nobody watching) that must be testable
- * without pi. `ApprovalUI` is the minimal slice of pi's `ExtensionUIContext` needed here, so a test can
- * supply a plain object.
- *
- * Everything here denies on uncertainty. pi already agrees: in non-interactive modes it installs a
- * no-op UI context whose `select` resolves undefined, so even a missed `hasUI` check would deny.
- */
-import { approvalKey, offeredScopes } from "./approval.js";
-export const DENY_LABEL = "Deny";
-export const SCOPE_LABELS = {
-    once: "Allow once",
-    session: "Allow for this session",
-    always: "Always allow in this project (30 days)",
-};
-/**
- * Which of the five outcomes a request produced.
- *
- * `scope: null` alone conflates four different kinds of no — a caller that needs to know whether a
- * PERSON actually declined (as opposed to nobody being there to ask, a dismissal, or the dialog itself
- * breaking) cannot recover that from `scope` or from parsing `reason`. Only "declined" means a human said
- * no; the other three are absence-of-signal, not a signal.
- */
-export const PROMPT_OUTCOME_KINDS = ["granted", "declined", "dismissed", "no-ui", "error"];
-const DEFAULT_TIMEOUT_MS = 120_000;
-/**
- * Read `PI_GRANTS_APPROVAL_TIMEOUT`, in SECONDS, into the milliseconds pi expects.
- *
- * `0` or an unparseable value means no timeout: waiting forever denies nothing, so it is the safe
- * interpretation of a value we do not understand.
- */
-export function timeoutMsFromEnv(raw) {
-    if (raw === undefined)
-        return DEFAULT_TIMEOUT_MS;
-    const seconds = Number.parseInt(raw, 10);
-    if (!Number.isFinite(seconds) || seconds <= 0)
-        return undefined;
-    return seconds * 1000;
-}
-function labelToScope(label, scopes) {
-    return scopes.find((s) => SCOPE_LABELS[s] === label) ?? null;
-}
-/**
- * Build gates that SHARE one single-flight queue.
- *
- * This exists because of how the wiring actually calls in. The gate's options depend on the per-call
- * `ExtensionContext` (`ui`, `hasUI`, `mode`), so the extension necessarily builds a gate per invocation —
- * and a gate that owns its queue privately therefore de-duplicates nothing across invocations, which is
- * exactly the case §6.1 exists for (two concurrent `delegate` calls are two separate invocations).
- *
- * The provider separates the two lifetimes: options stay per-call and fresh, the queue is created once and
- * lives as long as the provider. Preferred over a module-level map because that would be shared by every
- * gate in the process — including across tests — for no benefit.
- */
-export function createApprovalGateProvider() {
-    const inFlight = new Map();
-    return (options) => createApprovalGate(options, inFlight);
-}
-/**
- * @param inFlight optional shared single-flight queue — see `createApprovalGateProvider`. Defaults to one
- * private to this gate, which only de-duplicates requests made through this same gate object.
- */
-export function createApprovalGate(options, inFlight = new Map()) {
-    const ask = async (request) => {
-        const scopes = offeredScopes(request.path);
-        const title = `grants: approve ${request.capability} for ${request.subject}?` +
-            (request.task ? `\n  task: ${request.task}` : "");
-        let chosen;
-        try {
-            chosen = await options.ui.select(title, [DENY_LABEL, ...scopes.map((s) => SCOPE_LABELS[s])], {
-                timeout: options.timeoutMs,
-                signal: request.signal,
-            });
-        }
-        catch (error) {
-            // A governance layer that errors must deny, not permit. This is a dialog malfunction, not a
-            // person's answer — `kind: "error"` keeps it out of "declined".
-            return { scope: null, kind: "error", reason: `approval dialog failed, denying (${String(error)})` };
-        }
-        // undefined covers dismissal, timeout, and abort. All are a no, but none is a person saying no.
-        if (chosen === undefined) {
-            return { scope: null, kind: "dismissed", reason: `approval for ${request.capability} was dismissed` };
-        }
-        if (chosen === DENY_LABEL) {
-            return { scope: null, kind: "declined", reason: `${request.capability} was denied by a human` };
-        }
-        const scope = labelToScope(chosen, scopes);
-        return scope === null
-            ? { scope: null, kind: "error", reason: `unrecognised approval choice ${JSON.stringify(chosen)}, denying` }
-            : { scope, kind: "granted" };
-    };
-    return {
-        async request(request) {
-            if (!options.hasUI) {
-                // Nobody was there to ask — distinct from a person declining, which is why this is its own kind
-                // rather than being folded into "declined" (see PromptOutcomeKind).
-                return {
-                    scope: null,
-                    kind: "no-ui",
-                    reason: `${request.capability} requires approval and this session has no interactive user ` +
-                        `(mode: ${options.mode}). Pre-approve it in an interactive session, or drop it from the request.`,
-                };
-            }
-            const key = `${approvalKey(request.capability, request.subject)}${request.bindingKey ? `#${request.bindingKey}` : ""}`;
-            // R-29. Join an in-flight dialog, but only *keep* its answer if that answer was about more than one
-            // spawn. A `once` belongs to whichever caller the human was actually looking at — the title shows
-            // that caller's task — so anyone else who joined must ask their own question rather than ride a yes
-            // given for somebody else's work. The loop (rather than a single retry) covers the case where a
-            // fellow waiter started its own dialog first: we join that one instead of opening a third.
-            for (;;) {
-                const existing = inFlight.get(key);
-                if (!existing)
-                    break;
-                const outcome = await existing;
-                // **`joined` marks the rider, and the ledger depends on it (R-66).** Sharing a non-`once` outcome
-                // is correct — the human authorised the capability for the session, not for one child — but the
-                // caller then stamped `approvalSource: "prompt"` on every one of them, so a fan-out of eight wrote
-                // eight lines each asserting a human was prompted when exactly one was. That is R-46's defect at
-                // the concurrency level, and `ledger.ts` calls over-claiming in this direction "the worst available
-                // failure". Confirmed by execution: one dialog, eight `granted/session` outcomes.
-                if (outcome.scope !== "once")
-                    return { ...outcome, joined: true };
-            }
-            const pending = ask(request).finally(() => inFlight.delete(key));
-            inFlight.set(key, pending);
-            return pending;
-        },
-    };
-}
-//# sourceMappingURL=approval-prompt.js.map

package/dist/approval-prompt.js.map

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