@switchboard-mcp/core 0.1.0

package/dist/mandates/mandates.d.ts

@@ -0,0 +1,244 @@
+import * as z from "zod";
+import type { PathResolutionOptions } from "../config/paths.js";
+export type MandateRuntimeStatus = "active" | "expired";
+export type MandateHandoffState = "open" | "completed" | "blocked" | "cancelled";
+export type MandateApprovalRisk = "low" | "medium" | "high" | "critical";
+export interface MandateApprovalGate {
+    id: string;
+    toolPattern: string;
+    reason?: string | undefined;
+    risk?: MandateApprovalRisk | undefined;
+    labels?: string[] | undefined;
+}
+export interface CreateMandateApprovalGate {
+    id?: string | undefined;
+    toolPattern: string;
+    reason?: string | undefined;
+    risk?: string | undefined;
+    labels?: string[] | undefined;
+}
+export type MandateToolPolicyDecision = {
+    allowed: true;
+    approvalRequestId?: string | undefined;
+} | {
+    allowed: false;
+    reason: string;
+} | {
+    allowed: false;
+    reason: string;
+    approvalRequired: true;
+    approvalGate: MandateApprovalGate;
+};
+export declare const mandateApprovalGateSchema: z.ZodObject<{
+    id: z.ZodString;
+    toolPattern: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    risk: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+        critical: "critical";
+    }>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const mandateHandoffStateSchema: z.ZodEnum<{
+    open: "open";
+    completed: "completed";
+    blocked: "blocked";
+    cancelled: "cancelled";
+}>;
+export declare const mandateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    mandateUid: z.ZodOptional<z.ZodString>;
+    task: z.ZodString;
+    parentMandateId: z.ZodOptional<z.ZodString>;
+    parentMandateUid: z.ZodOptional<z.ZodString>;
+    delegatedBy: z.ZodOptional<z.ZodString>;
+    delegationPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    delegationUids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxLeaseExpiresAt: z.ZodOptional<z.ZodString>;
+    repoPath: z.ZodString;
+    worktreePath: z.ZodString;
+    branch: z.ZodString;
+    agentRole: z.ZodString;
+    profiles: z.ZodArray<z.ZodString>;
+    lease: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    allowedTools: z.ZodArray<z.ZodString>;
+    deniedTools: z.ZodArray<z.ZodString>;
+    approvalGates: z.ZodPipe<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        toolPattern: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        risk: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            low: "low";
+            high: "high";
+            critical: "critical";
+        }>>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodString]>>, z.ZodTransform<MandateApprovalGate[], (string | {
+        id: string;
+        toolPattern: string;
+        reason?: string | undefined;
+        risk?: "medium" | "low" | "high" | "critical" | undefined;
+        labels?: string[] | undefined;
+    })[]>>;
+    handoffState: z.ZodEnum<{
+        open: "open";
+        completed: "completed";
+        blocked: "blocked";
+        cancelled: "cancelled";
+    }>;
+    handoffSummary: z.ZodOptional<z.ZodString>;
+    handoffNextSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    handoffArtifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    handoffBy: z.ZodOptional<z.ZodString>;
+    handoffAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const mandateStoreSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    mandates: z.ZodArray<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        id: z.ZodString;
+        mandateUid: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        parentMandateId: z.ZodOptional<z.ZodString>;
+        parentMandateUid: z.ZodOptional<z.ZodString>;
+        delegatedBy: z.ZodOptional<z.ZodString>;
+        delegationPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        delegationUids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxLeaseExpiresAt: z.ZodOptional<z.ZodString>;
+        repoPath: z.ZodString;
+        worktreePath: z.ZodString;
+        branch: z.ZodString;
+        agentRole: z.ZodString;
+        profiles: z.ZodArray<z.ZodString>;
+        lease: z.ZodString;
+        createdAt: z.ZodString;
+        expiresAt: z.ZodString;
+        allowedTools: z.ZodArray<z.ZodString>;
+        deniedTools: z.ZodArray<z.ZodString>;
+        approvalGates: z.ZodPipe<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
+            toolPattern: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+            risk: z.ZodOptional<z.ZodEnum<{
+                medium: "medium";
+                low: "low";
+                high: "high";
+                critical: "critical";
+            }>>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodString]>>, z.ZodTransform<MandateApprovalGate[], (string | {
+            id: string;
+            toolPattern: string;
+            reason?: string | undefined;
+            risk?: "medium" | "low" | "high" | "critical" | undefined;
+            labels?: string[] | undefined;
+        })[]>>;
+        handoffState: z.ZodEnum<{
+            open: "open";
+            completed: "completed";
+            blocked: "blocked";
+            cancelled: "cancelled";
+        }>;
+        handoffSummary: z.ZodOptional<z.ZodString>;
+        handoffNextSteps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        handoffArtifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        handoffBy: z.ZodOptional<z.ZodString>;
+        handoffAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Mandate = z.infer<typeof mandateSchema>;
+export type MandateStore = z.infer<typeof mandateStoreSchema>;
+export type MandateWithStatus = Mandate & {
+    runtimeStatus: MandateRuntimeStatus | "closed";
+};
+export interface CreateMandateOptions {
+    task: string;
+    repoPath: string;
+    worktreePath: string;
+    branch: string;
+    agentRole: string;
+    profiles: string[];
+    lease: string;
+    allowedTools?: string[];
+    deniedTools?: string[];
+    approvalRequiredTools?: Array<string | CreateMandateApprovalGate>;
+    path?: string;
+    now?: () => Date;
+}
+export interface RenewMandateOptions {
+    id: string;
+    repoPath: string;
+    lease: string;
+    path?: string;
+    now?: () => Date;
+}
+export interface CreateChildMandateOptions {
+    parentId: string;
+    task: string;
+    repoPath: string;
+    worktreePath: string;
+    branch: string;
+    agentRole: string;
+    profiles: string[];
+    lease: string;
+    delegatedBy?: string | undefined;
+    allowedTools?: string[];
+    deniedTools?: string[];
+    approvalRequiredTools?: Array<string | CreateMandateApprovalGate>;
+    path?: string;
+    now?: () => Date;
+}
+export interface UpdateMandateHandoffOptions {
+    id: string;
+    repoPath: string;
+    state: Exclude<MandateHandoffState, "open">;
+    summary?: string | undefined;
+    nextSteps?: string[];
+    artifacts?: string[];
+    handoffBy?: string | undefined;
+    path?: string;
+    now?: () => Date;
+}
+export interface MandateToolPolicy {
+    allowedTools?: string[];
+    deniedTools?: string[];
+    approvalGates?: MandateApprovalGate[];
+    approvedApprovalRequests?: Array<{
+        id?: string | undefined;
+        approvalGateId: string;
+        toolName: string;
+    }>;
+}
+export interface ListMandatesOptions {
+    path?: string;
+    repoPath?: string;
+    id?: string;
+    now?: () => Date;
+}
+export interface ResolveActiveMandateOptions {
+    id: string;
+    repoPath: string;
+    path?: string;
+    now?: () => Date;
+}
+export declare function resolveMandateStorePath(options?: PathResolutionOptions): string;
+export declare function normalizeMandateId(value: string): string;
+export declare function parseMandateLease(value: string): number;
+export declare function mandateRuntimeStatus(mandate: Pick<Mandate, "expiresAt"> & Partial<Pick<Mandate, "handoffState">>, now?: Date): MandateWithStatus["runtimeStatus"];
+export declare function evaluateMandateToolPolicy(toolName: string, policy: MandateToolPolicy): MandateToolPolicyDecision;
+export declare function createMandate(options: CreateMandateOptions): Promise<MandateWithStatus>;
+export declare function createChildMandate(options: CreateChildMandateOptions): Promise<MandateWithStatus>;
+export declare function updateMandateHandoff(options: UpdateMandateHandoffOptions): Promise<MandateWithStatus>;
+export declare function renewMandate(options: RenewMandateOptions): Promise<MandateWithStatus>;
+export declare function listMandates(options?: ListMandatesOptions): Promise<MandateWithStatus[]>;
+export declare function resolveActiveMandate(options: ResolveActiveMandateOptions): Promise<MandateWithStatus>;
+export declare function readMandateStore(options?: {
+    path?: string;
+}): Promise<MandateStore>;
+//# sourceMappingURL=mandates.d.ts.map

package/dist/mandates/mandates.d.ts.map

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