agentic-engineering-harness 0.8.10 → 0.8.12

package/dist/releases/release-1791018639698-16341-356f840f/participants/roles.d.ts

@@ -0,0 +1,355 @@
+import type { RoleProfileV1 } from "./types.js";
+export declare const DEFAULT_ROLE_PROFILES_V1: ({
+    version: 1;
+    role: "Lead/Director";
+    purpose: string;
+    validRoutes: readonly ["NO_AGENT", "DIRECT", "DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["NONE", "STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "plan", "supervise", "delegate"];
+    maxCapabilities: readonly ["read", "plan", "specify", "review", "validate", "supervise", "delegate"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read", "task-coordination"];
+        optional: readonly ["validation-read", "operation-control"];
+        forbidden: readonly ["repository-write", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "operation", "repository-map"];
+        retrieval: "authorized";
+        preservation: "verbatim";
+        budgetClass: "large";
+    };
+    delegation: {
+        allowed: true;
+        allowedRoles: readonly ["Operation Supervisor", "Explorer", "Librarian", "Planner", "Spec Manager", "Implementer", "Reviewer", "Repairer"];
+        maxChildren: number;
+        requiresSupervisorApproval: false;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: true;
+        canSelfAccept: false;
+        leaseRequired: true;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Operation Supervisor";
+    purpose: string;
+    validRoutes: readonly ["DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "supervise", "validate"];
+    maxCapabilities: readonly ["read", "supervise", "validate", "delegate", "execute"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read", "task-coordination"];
+        optional: readonly ["validation-read"];
+        forbidden: readonly ["repository-write", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["normative", "operation", "validation", "handoff"];
+        retrieval: "authorized";
+        preservation: "verbatim";
+        budgetClass: "large";
+    };
+    delegation: {
+        allowed: true;
+        allowedRoles: readonly ["Explorer", "Librarian", "Planner", "Spec Manager", "Implementer", "Reviewer", "Repairer"];
+        maxChildren: number;
+        requiresSupervisorApproval: false;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: true;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: true;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Explorer";
+    purpose: string;
+    validRoutes: readonly ["DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "research"];
+    maxCapabilities: readonly ["read", "research", "validate"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read"];
+        optional: readonly ["repository-map"];
+        forbidden: readonly ["repository-write", "command-execute", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "repository-map", "source"];
+        retrieval: "authorized";
+        preservation: "projectable";
+        budgetClass: "standard";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: false;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Librarian";
+    purpose: string;
+    validRoutes: readonly ["DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "research"];
+    maxCapabilities: readonly ["read", "research", "validate"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["context-read"];
+        optional: readonly ["approved-research"];
+        forbidden: readonly ["repository-write", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "raw-evidence"];
+        retrieval: "authorized";
+        preservation: "retrievable";
+        budgetClass: "standard";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: false;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Planner";
+    purpose: string;
+    validRoutes: readonly ["DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "plan"];
+    maxCapabilities: readonly ["read", "plan", "validate"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read", "task-coordination"];
+        optional: readonly ["repository-map"];
+        forbidden: readonly ["repository-write", "command-execute", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "repository-map", "operation"];
+        retrieval: "authorized";
+        preservation: "projectable";
+        budgetClass: "large";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: false;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Spec Manager";
+    purpose: string;
+    validRoutes: readonly ["FORMAL_SDD"];
+    validAssurance: readonly ["ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "specify", "validate"];
+    maxCapabilities: readonly ["read", "specify", "validate"];
+    specializations: readonly ["cross-cutting"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read", "spec-authoring"];
+        optional: readonly ["validation-read"];
+        forbidden: readonly ["repository-write", "command-execute", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "operation", "validation"];
+        retrieval: "authorized";
+        preservation: "verbatim";
+        budgetClass: "large";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: false;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Implementer";
+    purpose: string;
+    validRoutes: readonly ["DIRECT", "DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "write", "execute", "implement"];
+    maxCapabilities: readonly ["read", "write", "execute", "implement", "validate"];
+    specializations: readonly ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "repository-write", "command-execute", "context-read"];
+        optional: readonly ["test-runner", "database-client"];
+        forbidden: readonly ["agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "source", "diff", "validation"];
+        retrieval: "authorized";
+        preservation: "projectable";
+        budgetClass: "standard";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: true;
+        canExecute: true;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: true;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Reviewer";
+    purpose: string;
+    validRoutes: readonly ["DIRECT", "DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "review", "validate"];
+    maxCapabilities: readonly ["read", "review", "validate", "research"];
+    specializations: readonly ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "context-read"];
+        optional: readonly ["test-runner", "validation-read"];
+        forbidden: readonly ["repository-write", "command-execute", "agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "source", "diff", "validation", "evidence"];
+        retrieval: "authorized";
+        preservation: "verbatim";
+        budgetClass: "standard";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: false;
+        canExecute: false;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: false;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+} | {
+    version: 1;
+    role: "Repairer";
+    purpose: string;
+    validRoutes: readonly ["DIRECT", "DELEGATED", "FORMAL_SDD"];
+    validAssurance: readonly ["STANDARD", "ELEVATED", "CRITICAL"];
+    baseCapabilities: readonly ["read", "write", "execute", "repair"];
+    maxCapabilities: readonly ["read", "write", "execute", "repair", "validate"];
+    specializations: readonly ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"];
+    toolPack: {
+        version: 1;
+        required: readonly ["repository-read", "repository-write", "command-execute", "context-read"];
+        optional: readonly ["test-runner", "database-client"];
+        forbidden: readonly ["agent-spawn-by-name"];
+    };
+    context: {
+        requiredKinds: readonly ["instruction", "normative", "failure-packet", "diff", "validation"];
+        retrieval: "authorized";
+        preservation: "projectable";
+        budgetClass: "standard";
+    };
+    delegation: {
+        allowed: false;
+        allowedRoles: never[];
+        maxChildren: number;
+        requiresSupervisorApproval: true;
+    };
+    authority: {
+        canRead: true;
+        canWrite: true;
+        canExecute: true;
+        canApprove: false;
+        canSelfAccept: false;
+        leaseRequired: true;
+    };
+    defaultSkills: string[];
+    inputContract: string;
+    outputContract: string;
+    invocationConditions: string[];
+})[];
+export declare function defaultRoleProfiles(): readonly RoleProfileV1[];
+export declare function roleProfile(role: RoleProfileV1["role"]): RoleProfileV1;

package/dist/releases/release-1791018639698-16341-356f840f/participants/roles.js

@@ -0,0 +1,183 @@
+import { assuranceLevelValues, implementationRouteValues } from "../architecture/contracts.js";
+const readOnlyTools = ["repository-read", "context-read"];
+const implementationTools = ["repository-read", "repository-write", "command-execute", "context-read"];
+const coordinationTools = ["repository-read", "context-read", "task-coordination"];
+const allRoutes = [...implementationRouteValues];
+const changeRoutes = ["DIRECT", "DELEGATED", "FORMAL_SDD"];
+const orchestrationRoutes = ["DELEGATED", "FORMAL_SDD"];
+const allAssurance = [...assuranceLevelValues];
+const changeAssurance = ["STANDARD", "ELEVATED", "CRITICAL"];
+export const DEFAULT_ROLE_PROFILES_V1 = [
+    {
+        version: 1,
+        role: "Lead/Director",
+        purpose: "Own the bounded operation decision, preserve intent, and coordinate canonical participants.",
+        validRoutes: allRoutes,
+        validAssurance: allAssurance,
+        baseCapabilities: ["read", "plan", "supervise", "delegate"],
+        maxCapabilities: ["read", "plan", "specify", "review", "validate", "supervise", "delegate"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: coordinationTools, optional: ["validation-read", "operation-control"], forbidden: ["repository-write", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "operation", "repository-map"], retrieval: "authorized", preservation: "verbatim", budgetClass: "large" },
+        delegation: { allowed: true, allowedRoles: ["Operation Supervisor", "Explorer", "Librarian", "Planner", "Spec Manager", "Implementer", "Reviewer", "Repairer"], maxChildren: 32, requiresSupervisorApproval: false },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: true, canSelfAccept: false, leaseRequired: true },
+        defaultSkills: ["intent-analysis", "semantic-decision", "human-exception-handling", "acceptance-reasoning"],
+        inputContract: "user-intent-and-operation-state",
+        outputContract: "semantic-decision",
+        invocationConditions: ["top-level-operation", "human-exception"]
+    },
+    {
+        version: 1,
+        role: "Operation Supervisor",
+        purpose: "Supervise lifecycle, budgets, barriers, leases, and participant evidence for one operation.",
+        validRoutes: orchestrationRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "supervise", "validate"],
+        maxCapabilities: ["read", "supervise", "validate", "delegate", "execute"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: coordinationTools, optional: ["validation-read"], forbidden: ["repository-write", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["normative", "operation", "validation", "handoff"], retrieval: "authorized", preservation: "verbatim", budgetClass: "large" },
+        delegation: { allowed: true, allowedRoles: ["Explorer", "Librarian", "Planner", "Spec Manager", "Implementer", "Reviewer", "Repairer"], maxChildren: 32, requiresSupervisorApproval: false },
+        authority: { canRead: true, canWrite: false, canExecute: true, canApprove: false, canSelfAccept: false, leaseRequired: true },
+        defaultSkills: ["operation-coordination", "progress-reconciliation", "conflict-consolidation", "bounded-replanning"],
+        inputContract: "operation-state-and-participant-evidence",
+        outputContract: "operation-supervision",
+        invocationConditions: ["managed-operation"]
+    },
+    {
+        version: 1,
+        role: "Explorer",
+        purpose: "Build bounded repository and change-scope evidence without proposing implementation identity.",
+        validRoutes: orchestrationRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "research"],
+        maxCapabilities: ["read", "research", "validate"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: readOnlyTools, optional: ["repository-map"], forbidden: ["repository-write", "command-execute", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "repository-map", "source"], retrieval: "authorized", preservation: "projectable", budgetClass: "standard" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: false, canSelfAccept: false, leaseRequired: false },
+        defaultSkills: ["repository-discovery", "symbol-impact-analysis", "repository-evidence-grounding"],
+        inputContract: "repository-discovery-request",
+        outputContract: "exploration-evidence",
+        invocationConditions: ["discovery-needed"]
+    },
+    {
+        version: 1,
+        role: "Librarian",
+        purpose: "Locate and summarize trusted external or repository knowledge after a deterministic knowledge gap.",
+        validRoutes: orchestrationRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "research"],
+        maxCapabilities: ["read", "research", "validate"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: ["context-read"], optional: ["approved-research"], forbidden: ["repository-write", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "raw-evidence"], retrieval: "authorized", preservation: "retrievable", budgetClass: "standard" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: false, canSelfAccept: false, leaseRequired: false },
+        defaultSkills: ["authoritative-research", "source-quality-ranking", "version-aware-research", "public-code-research", "knowledge-pack-authoring"],
+        inputContract: "knowledge-gap-request",
+        outputContract: "knowledge-pack",
+        invocationConditions: ["knowledge-gap"]
+    },
+    {
+        version: 1,
+        role: "Planner",
+        purpose: "Decompose a frozen objective into dependency-aware bounded work units.",
+        validRoutes: orchestrationRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "plan"],
+        maxCapabilities: ["read", "plan", "validate"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: coordinationTools, optional: ["repository-map"], forbidden: ["repository-write", "command-execute", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "repository-map", "operation"], retrieval: "authorized", preservation: "projectable", budgetClass: "large" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: false, canSelfAccept: false, leaseRequired: false },
+        defaultSkills: ["work-decomposition", "dependency-analysis", "competency-identification", "resource-conflict-analysis"],
+        inputContract: "frozen-objective-and-discovery-evidence",
+        outputContract: "work-graph",
+        invocationConditions: ["non-trivial-decomposition"]
+    },
+    {
+        version: 1,
+        role: "Spec Manager",
+        purpose: "Author and validate formal requirements, design, tasks, and traceability before freeze.",
+        validRoutes: ["FORMAL_SDD"],
+        validAssurance: ["ELEVATED", "CRITICAL"],
+        baseCapabilities: ["read", "specify", "validate"],
+        maxCapabilities: ["read", "specify", "validate"],
+        specializations: ["cross-cutting"],
+        toolPack: { version: 1, required: ["repository-read", "context-read", "spec-authoring"], optional: ["validation-read"], forbidden: ["repository-write", "command-execute", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "operation", "validation"], retrieval: "authorized", preservation: "verbatim", budgetClass: "large" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: false, canSelfAccept: false, leaseRequired: false },
+        defaultSkills: ["requirement-authoring", "semantic-consistency", "acceptance-traceability", "openspec-authoring"],
+        inputContract: "change-intent-and-authoring-evidence",
+        outputContract: "compiled-formal-contract",
+        invocationConditions: ["formal-sdd-route"]
+    },
+    {
+        version: 1,
+        role: "Implementer",
+        purpose: "Make only the frozen, task-scoped product changes and return reproducible evidence.",
+        validRoutes: changeRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "write", "execute", "implement"],
+        maxCapabilities: ["read", "write", "execute", "implement", "validate"],
+        specializations: ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"],
+        toolPack: { version: 1, required: implementationTools, optional: ["test-runner", "database-client"], forbidden: ["agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "source", "diff", "validation"], retrieval: "authorized", preservation: "projectable", budgetClass: "standard" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: true, canExecute: true, canApprove: false, canSelfAccept: false, leaseRequired: true },
+        defaultSkills: ["implementation-discipline", "scope-discipline", "focused-regression-testing", "implementation-evidence"],
+        inputContract: "assigned-work-units-and-frozen-blueprint",
+        outputContract: "work-unit-result",
+        invocationConditions: ["direct-or-delegated-change"]
+    },
+    {
+        version: 1,
+        role: "Reviewer",
+        purpose: "Independently assess scope, correctness, security, and evidence without changing the candidate.",
+        validRoutes: changeRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "review", "validate"],
+        maxCapabilities: ["read", "review", "validate", "research"],
+        specializations: ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"],
+        toolPack: { version: 1, required: readOnlyTools, optional: ["test-runner", "validation-read"], forbidden: ["repository-write", "command-execute", "agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "source", "diff", "validation", "evidence"], retrieval: "authorized", preservation: "verbatim", budgetClass: "standard" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: false, canExecute: false, canApprove: false, canSelfAccept: false, leaseRequired: false },
+        defaultSkills: ["independent-review", "evidence-based-findings", "review-scope-discipline", "finding-quality"],
+        inputContract: "candidate-and-review-dimensions",
+        outputContract: "review-result",
+        invocationConditions: ["independent-review-required"]
+    },
+    {
+        version: 1,
+        role: "Repairer",
+        purpose: "Apply bounded repairs to a failed candidate while preserving frozen scope and independent re-validation.",
+        validRoutes: changeRoutes,
+        validAssurance: changeAssurance,
+        baseCapabilities: ["read", "write", "execute", "repair"],
+        maxCapabilities: ["read", "write", "execute", "repair", "validate"],
+        specializations: ["cross-cutting", "typescript-node", "dotnet-csharp", "postgresql"],
+        toolPack: { version: 1, required: implementationTools, optional: ["test-runner", "database-client"], forbidden: ["agent-spawn-by-name"] },
+        context: { requiredKinds: ["instruction", "normative", "failure-packet", "diff", "validation"], retrieval: "authorized", preservation: "projectable", budgetClass: "standard" },
+        delegation: { allowed: false, allowedRoles: [], maxChildren: 0, requiresSupervisorApproval: true },
+        authority: { canRead: true, canWrite: true, canExecute: true, canApprove: false, canSelfAccept: false, leaseRequired: true },
+        defaultSkills: ["root-cause-remediation", "minimal-repair", "regression-preservation", "failure-classification"],
+        inputContract: "failure-packet-and-frozen-scope",
+        outputContract: "repair-result",
+        invocationConditions: ["repair-required"]
+    }
+];
+export function defaultRoleProfiles() {
+    return DEFAULT_ROLE_PROFILES_V1;
+}
+export function roleProfile(role) {
+    const profile = DEFAULT_ROLE_PROFILES_V1.find((candidate) => candidate.role === role);
+    if (!profile)
+        throw new Error(`No default profile exists for canonical role: ${role}`);
+    return profile;
+}
+//# sourceMappingURL=roles.js.map

package/dist/releases/release-1791018639698-16341-356f840f/participants/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/participants/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAG/F,MAAM,aAAa,GAAG,CAAC,iBAAiB,EAAE,cAAc,CAAU,CAAC;AACnE,MAAM,mBAAmB,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,CAAU,CAAC;AAChH,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,CAAU,CAAC;AAE5F,MAAM,SAAS,GAAG,CAAC,GAAG,yBAAyB,CAAU,CAAC;AAC1D,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AACpE,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,YAAY,CAAU,CAAC;AACjE,MAAM,YAAY,GAAG,CAAC,GAAG,oBAAoB,CAAU,CAAC;AACxD,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,6FAA6F;QACtG,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,YAAY;QAC5B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAU;QACpE,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAU;QACpG,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAU,EAAE;QACnL,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE;QACzK,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,sBAAsB,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,CAAU,EAAE,WAAW,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE;QAC7N,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAC7H,aAAa,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,sBAAsB,CAAC;QAC3G,aAAa,EAAE,iCAAiC;QAChD,cAAc,EAAE,mBAAmB;QACnC,oBAAoB,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;KACjE;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,6FAA6F;QACtG,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAU;QAC5D,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAU;QAClF,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,iBAAiB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAU,EAAE;QAC9J,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE;QACjK,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,CAAU,EAAE,WAAW,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE;QACrM,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAC7H,aAAa,EAAE,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,oBAAoB,CAAC;QACpH,aAAa,EAAE,0CAA0C;QACzD,cAAc,EAAE,uBAAuB;QACvC,oBAAoB,EAAE,CAAC,mBAAmB,CAAC;KAC5C;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,+FAA+F;QACxG,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAU;QAC/C,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAU;QAC1D,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,gBAAgB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,CAAU,EAAE;QAC5K,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,QAAQ,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE;QAC/J,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QAC/H,aAAa,EAAE,CAAC,sBAAsB,EAAE,wBAAwB,EAAE,+BAA+B,CAAC;QAClG,aAAa,EAAE,8BAA8B;QAC7C,cAAc,EAAE,sBAAsB;QACtC,oBAAoB,EAAE,CAAC,kBAAkB,CAAC;KAC3C;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,oGAAoG;QAC7G,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAU;QAC/C,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAU;QAC1D,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAU,EAAE,QAAQ,EAAE,CAAC,mBAAmB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAU,EAAE;QACxK,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE;QAChK,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QAC/H,aAAa,EAAE,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,0BAA0B,CAAC;QACjJ,aAAa,EAAE,uBAAuB;QACtC,cAAc,EAAE,gBAAgB;QAChC,oBAAoB,EAAE,CAAC,eAAe,CAAC;KACxC;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,wEAAwE;QACjF,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAU;QAC3C,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAU;QACtD,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,gBAAgB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,CAAU,EAAE;QAChL,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE;QAC5K,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QAC/H,aAAa,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,4BAA4B,CAAC;QACvH,aAAa,EAAE,yCAAyC;QACxD,cAAc,EAAE,YAAY;QAC5B,oBAAoB,EAAE,CAAC,2BAA2B,CAAC;KACpD;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,yFAAyF;QAClG,WAAW,EAAE,CAAC,YAAY,CAAU;QACpC,cAAc,EAAE,CAAC,UAAU,EAAE,UAAU,CAAU;QACjD,gBAAgB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;QAC1D,eAAe,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;QACzD,eAAe,EAAE,CAAC,eAAe,CAAU;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,CAAU,EAAE,QAAQ,EAAE,CAAC,iBAAiB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,CAAU,EAAE;QAC9N,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE;QACrK,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QAC/H,aAAa,EAAE,CAAC,uBAAuB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,oBAAoB,CAAC;QACjH,aAAa,EAAE,sCAAsC;QACrD,cAAc,EAAE,0BAA0B;QAC1C,oBAAoB,EAAE,CAAC,kBAAkB,CAAC;KAC3C;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,qFAAqF;QAC9F,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAU;QACpE,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAU;QAC/E,eAAe,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,CAAU;QAC7F,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAU,EAAE,SAAS,EAAE,CAAC,qBAAqB,CAAU,EAAE;QAC3J,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE;QAChL,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5H,aAAa,EAAE,CAAC,2BAA2B,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,yBAAyB,CAAC;QACzH,aAAa,EAAE,0CAA0C;QACzD,cAAc,EAAE,kBAAkB;QAClC,oBAAoB,EAAE,CAAC,4BAA4B,CAAC;KACrD;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,iGAAiG;QAC1G,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAU;QACzD,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAU;QACpE,eAAe,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,CAAU;QAC7F,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAU,EAAE,SAAS,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,CAAU,EAAE;QAC5L,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;QACzL,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QAC/H,aAAa,EAAE,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,iBAAiB,CAAC;QAC9G,aAAa,EAAE,iCAAiC;QAChD,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,CAAC,6BAA6B,CAAC;KACtD;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,0GAA0G;QACnH,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,eAAe;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAU;QACjE,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU;QAC5E,eAAe,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,CAAU;QAC7F,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAU,EAAE,SAAS,EAAE,CAAC,qBAAqB,CAAU,EAAE;QAC3J,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,CAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE;QACxL,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE;QAClG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5H,aAAa,EAAE,CAAC,wBAAwB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,wBAAwB,CAAC;QAChH,aAAa,EAAE,iCAAiC;QAChD,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,CAAC,iBAAiB,CAAC;KAC1C;CACiC,CAAC;AAErC,MAAM,UAAU,mBAAmB;IACjC,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAA2B;IACrD,MAAM,OAAO,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtF,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAC;IACvF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/releases/release-1791018639698-16341-356f840f/paseo/native.d.ts

@@ -0,0 +1,78 @@
+import { type PaseoSdkPermissionStop } from "./sdk.js";
+import { type PaseoTimelineEventEnvelopeV1 } from "../telemetry/paseoTimeline.js";
+import type { ProviderTelemetryEvidenceV2 } from "../telemetry/efficiency.js";
+export interface PaseoNativeUsage {
+    inputTokens?: number;
+    cachedInputTokens?: number;
+    outputTokens?: number;
+    totalCostUsd?: number;
+    contextWindowMaxTokens?: number;
+    contextWindowUsedTokens?: number;
+}
+export interface PaseoNativeAgentSnapshot {
+    id: string;
+    status?: string;
+    workspaceId?: string;
+    /** Paseo's host-owned timestamp for the most recent inbound user turn. */
+    lastUserMessageAt?: string;
+    labels?: Record<string, string>;
+    lastUsage?: PaseoNativeUsage;
+    raw: Record<string, unknown>;
+}
+export interface PaseoContextUsageSnapshot {
+    used?: number;
+    limit?: number;
+    ratio?: number;
+    source: "paseo-agent-snapshot";
+    availability: "available" | "no-usage-yet" | "provider-usage-unavailable";
+}
+export interface PaseoProviderPreflightResult {
+    ok: boolean;
+    provider: string;
+    model?: string;
+    providerStatus?: string;
+    availableModels?: string[];
+    source: "paseo-provider-snapshot" | "paseo-provider-models" | "paseo-provider-diagnostic" | "paseo-provider-unchecked";
+    message: string;
+}
+export interface PaseoNativeWaitResult {
+    id: string;
+    workspaceId?: string;
+    status?: string;
+    lastMessage?: string;
+    error?: string;
+    permission?: PaseoSdkPermissionStop;
+    efficiencyTelemetry?: ProviderTelemetryEvidenceV2;
+    source: "paseo-agent-subscription";
+    updatesObserved: number;
+}
+export interface PaseoTurnBaseline {
+    lastAssistantMessage?: string;
+    lastUserMessageAt?: string;
+}
+export interface NativeAgentHandle {
+    readonly id: string;
+    latest?(): Record<string, unknown> | null;
+    refetch?(requestId?: string): Promise<{
+        agent: Record<string, unknown>;
+        project?: unknown;
+    } | null>;
+    refresh?(requestId?: string): Promise<{
+        agent: Record<string, unknown>;
+        project?: unknown;
+    } | null>;
+    subscribe?(handler: (update: unknown) => void): () => void;
+    timeline?: {
+        refetch(options?: Record<string, unknown>): Promise<unknown>;
+        subscribe?(handler: (event: unknown) => void): (() => void) & {
+            ready?: Promise<void>;
+        };
+    };
+}
+export declare function inspectPaseoNativeAgent(root: string, agentId: string): Promise<PaseoNativeAgentSnapshot | undefined>;
+export declare function normalizePaseoNativeAgent(raw: Record<string, unknown>): PaseoNativeAgentSnapshot;
+export declare function contextUsageFromPaseoSnapshot(snapshot: PaseoNativeAgentSnapshot): PaseoContextUsageSnapshot;
+export declare function capturePaseoAgentTurnBaseline(root: string, agentId: string): Promise<PaseoTurnBaseline>;
+export declare function preflightPaseoProviderModel(root: string, providerValue: string, modelValue?: string, cwd?: string): Promise<PaseoProviderPreflightResult>;
+export declare function waitForPaseoAgentNative(root: string, agentId: string, timeoutMs?: number, baseline?: PaseoTurnBaseline): Promise<PaseoNativeWaitResult>;
+export declare function waitForPaseoAgentHandle(handle: NativeAgentHandle, timeoutMs?: number, baseline?: PaseoTurnBaseline, pollIntervalMs?: number, captureEfficiencyTelemetry?: boolean, onTimelineActivity?: (sessionId: string, envelope: PaseoTimelineEventEnvelopeV1) => Promise<void>): Promise<PaseoNativeWaitResult>;