@osstack/protocol 0.20.0 → 0.22.0

package/dist/delivery-contract.d.ts

@@ -0,0 +1,734 @@
+import { z } from "zod";
+export declare const DeliveryCompletionV2: z.ZodEnum<["local_verified", "pr_opened", "merged", "deployed"]>;
+export declare const DeliveryPublicationScopeV2: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"none">;
+}, "strict", z.ZodTypeAny, {
+    mode: "none";
+}, {
+    mode: "none";
+}>, z.ZodObject<{
+    mode: z.ZodEnum<["push", "draft_pr", "review_pr"]>;
+    hostname: z.ZodLiteral<"github.com">;
+    repository: z.ZodString;
+    remote: z.ZodString;
+    base_ref: z.ZodEffects<z.ZodString, string, string>;
+    head_ref: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    mode: "push" | "draft_pr" | "review_pr";
+    hostname: "github.com";
+    repository: string;
+    remote: string;
+    base_ref: string;
+    head_ref: string;
+}, {
+    mode: "push" | "draft_pr" | "review_pr";
+    hostname: "github.com";
+    repository: string;
+    remote: string;
+    base_ref: string;
+    head_ref: string;
+}>]>;
+/** Scope and authority references constrain existing host authorization. Neither grants it. */
+export declare const DeliveryContractV2: z.ZodEffects<z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    contract_id: z.ZodString;
+    parent_contract_id: z.ZodOptional<z.ZodString>;
+    task_id: z.ZodString;
+    canonical_repo: z.ZodEffects<z.ZodString, string, string>;
+    mode: z.ZodEnum<["scout", "implement"]>;
+    base_head: z.ZodString;
+    goal: z.ZodString;
+    required_checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        registry_ref: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        registry_ref: string;
+    }, {
+        id: string;
+        registry_ref: string;
+    }>, "many">;
+    review_policy_ref: z.ZodString;
+    requested_completion: z.ZodEnum<["local_verified", "pr_opened", "merged", "deployed"]>;
+    allowed_paths: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    requested_actions: z.ZodArray<z.ZodEnum<["build", "verify", "commit", "push", "open_pr", "merge", "deploy:staging", "deploy:production"]>, "many">;
+    budget_ref: z.ZodString;
+    policy_digest: z.ZodString;
+    publication_scope: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, "strict", z.ZodTypeAny, {
+        mode: "none";
+    }, {
+        mode: "none";
+    }>, z.ZodObject<{
+        mode: z.ZodEnum<["push", "draft_pr", "review_pr"]>;
+        hostname: z.ZodLiteral<"github.com">;
+        repository: z.ZodString;
+        remote: z.ZodString;
+        base_ref: z.ZodEffects<z.ZodString, string, string>;
+        head_ref: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    }, {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    }>]>;
+    merge_authority: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, "strict", z.ZodTypeAny, {
+        mode: "none";
+    }, {
+        mode: "none";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"existing_guarded_policy">;
+        policy_ref: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    }, {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    schema_version: 2;
+    mode: "scout" | "implement";
+    task_id: string;
+    contract_id: string;
+    canonical_repo: string;
+    base_head: string;
+    goal: string;
+    required_checks: {
+        id: string;
+        registry_ref: string;
+    }[];
+    review_policy_ref: string;
+    requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+    allowed_paths: string[];
+    requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+    budget_ref: string;
+    policy_digest: string;
+    publication_scope: {
+        mode: "none";
+    } | {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    };
+    merge_authority: {
+        mode: "none";
+    } | {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    };
+    parent_contract_id?: string | undefined;
+}, {
+    schema_version: 2;
+    mode: "scout" | "implement";
+    task_id: string;
+    contract_id: string;
+    canonical_repo: string;
+    base_head: string;
+    goal: string;
+    required_checks: {
+        id: string;
+        registry_ref: string;
+    }[];
+    review_policy_ref: string;
+    requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+    allowed_paths: string[];
+    requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+    budget_ref: string;
+    policy_digest: string;
+    publication_scope: {
+        mode: "none";
+    } | {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    };
+    merge_authority: {
+        mode: "none";
+    } | {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    };
+    parent_contract_id?: string | undefined;
+}>, {
+    schema_version: 2;
+    mode: "scout" | "implement";
+    task_id: string;
+    contract_id: string;
+    canonical_repo: string;
+    base_head: string;
+    goal: string;
+    required_checks: {
+        id: string;
+        registry_ref: string;
+    }[];
+    review_policy_ref: string;
+    requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+    allowed_paths: string[];
+    requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+    budget_ref: string;
+    policy_digest: string;
+    publication_scope: {
+        mode: "none";
+    } | {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    };
+    merge_authority: {
+        mode: "none";
+    } | {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    };
+    parent_contract_id?: string | undefined;
+}, {
+    schema_version: 2;
+    mode: "scout" | "implement";
+    task_id: string;
+    contract_id: string;
+    canonical_repo: string;
+    base_head: string;
+    goal: string;
+    required_checks: {
+        id: string;
+        registry_ref: string;
+    }[];
+    review_policy_ref: string;
+    requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+    allowed_paths: string[];
+    requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+    budget_ref: string;
+    policy_digest: string;
+    publication_scope: {
+        mode: "none";
+    } | {
+        mode: "push" | "draft_pr" | "review_pr";
+        hostname: "github.com";
+        repository: string;
+        remote: string;
+        base_ref: string;
+        head_ref: string;
+    };
+    merge_authority: {
+        mode: "none";
+    } | {
+        mode: "existing_guarded_policy";
+        policy_ref: string;
+    };
+    parent_contract_id?: string | undefined;
+}>;
+export type DeliveryContractV2 = z.infer<typeof DeliveryContractV2>;
+export declare const FrozenDeliveryContractV2: z.ZodObject<{
+    contract: z.ZodEffects<z.ZodObject<{
+        schema_version: z.ZodLiteral<2>;
+        contract_id: z.ZodString;
+        parent_contract_id: z.ZodOptional<z.ZodString>;
+        task_id: z.ZodString;
+        canonical_repo: z.ZodEffects<z.ZodString, string, string>;
+        mode: z.ZodEnum<["scout", "implement"]>;
+        base_head: z.ZodString;
+        goal: z.ZodString;
+        required_checks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            registry_ref: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            registry_ref: string;
+        }, {
+            id: string;
+            registry_ref: string;
+        }>, "many">;
+        review_policy_ref: z.ZodString;
+        requested_completion: z.ZodEnum<["local_verified", "pr_opened", "merged", "deployed"]>;
+        allowed_paths: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        requested_actions: z.ZodArray<z.ZodEnum<["build", "verify", "commit", "push", "open_pr", "merge", "deploy:staging", "deploy:production"]>, "many">;
+        budget_ref: z.ZodString;
+        policy_digest: z.ZodString;
+        publication_scope: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, "strict", z.ZodTypeAny, {
+            mode: "none";
+        }, {
+            mode: "none";
+        }>, z.ZodObject<{
+            mode: z.ZodEnum<["push", "draft_pr", "review_pr"]>;
+            hostname: z.ZodLiteral<"github.com">;
+            repository: z.ZodString;
+            remote: z.ZodString;
+            base_ref: z.ZodEffects<z.ZodString, string, string>;
+            head_ref: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        }, {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        }>]>;
+        merge_authority: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, "strict", z.ZodTypeAny, {
+            mode: "none";
+        }, {
+            mode: "none";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"existing_guarded_policy">;
+            policy_ref: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        }, {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        }>]>;
+    }, "strict", z.ZodTypeAny, {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    }, {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    }>, {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    }, {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    }>;
+    digest: z.ZodString;
+    brief: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    contract: {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    };
+    digest: string;
+    brief: string;
+}, {
+    contract: {
+        schema_version: 2;
+        mode: "scout" | "implement";
+        task_id: string;
+        contract_id: string;
+        canonical_repo: string;
+        base_head: string;
+        goal: string;
+        required_checks: {
+            id: string;
+            registry_ref: string;
+        }[];
+        review_policy_ref: string;
+        requested_completion: "local_verified" | "pr_opened" | "merged" | "deployed";
+        allowed_paths: string[];
+        requested_actions: ("push" | "build" | "verify" | "commit" | "open_pr" | "merge" | "deploy:staging" | "deploy:production")[];
+        budget_ref: string;
+        policy_digest: string;
+        publication_scope: {
+            mode: "none";
+        } | {
+            mode: "push" | "draft_pr" | "review_pr";
+            hostname: "github.com";
+            repository: string;
+            remote: string;
+            base_ref: string;
+            head_ref: string;
+        };
+        merge_authority: {
+            mode: "none";
+        } | {
+            mode: "existing_guarded_policy";
+            policy_ref: string;
+        };
+        parent_contract_id?: string | undefined;
+    };
+    digest: string;
+    brief: string;
+}>;
+export type FrozenDeliveryContractV2 = z.infer<typeof FrozenDeliveryContractV2>;
+export declare const DeliveryCandidateIdentityV2: z.ZodObject<{
+    base_head: z.ZodString;
+    head: z.ZodString;
+    tree_id: z.ZodString;
+    diff_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    base_head: string;
+    head: string;
+    tree_id: string;
+    diff_digest: string;
+}, {
+    base_head: string;
+    head: string;
+    tree_id: string;
+    diff_digest: string;
+}>;
+export type DeliveryCandidateIdentityV2 = z.infer<typeof DeliveryCandidateIdentityV2>;
+/** Host-generated receipt. Parsing validates structure, never establishes provenance. */
+export declare const DeliveryVerificationReceiptV2: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    source: z.ZodLiteral<"osstack_loop_host">;
+    run_id: z.ZodString;
+    task_id: z.ZodString;
+    run_kind: z.ZodEnum<["guarded-local", "guarded-git"]>;
+    contract_digest: z.ZodString;
+    policy_digest: z.ZodString;
+    candidate: z.ZodObject<{
+        base_head: z.ZodString;
+        head: z.ZodString;
+        tree_id: z.ZodString;
+        diff_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        base_head: string;
+        head: string;
+        tree_id: string;
+        diff_digest: string;
+    }, {
+        base_head: string;
+        head: string;
+        tree_id: string;
+        diff_digest: string;
+    }>;
+    workspace_state_digest: z.ZodString;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        registry_ref: z.ZodString;
+        command_digest: z.ZodString;
+        exit_code: z.ZodNumber;
+        duration_ms: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        registry_ref: string;
+        command_digest: string;
+        exit_code: number;
+        duration_ms: number;
+    }, {
+        id: string;
+        registry_ref: string;
+        command_digest: string;
+        exit_code: number;
+        duration_ms: number;
+    }>, "many">;
+    review: z.ZodObject<{
+        policy_ref: z.ZodString;
+        verdict: z.ZodEnum<["approved", "changes_requested", "blocked", "inconclusive"]>;
+        builder_agent_id: z.ZodString;
+        reviewer_agent_id: z.ZodString;
+        builder_provider: z.ZodString;
+        builder_model: z.ZodString;
+        reviewer_provider: z.ZodString;
+        reviewer_model: z.ZodString;
+        identity_source: z.ZodLiteral<"reported">;
+        artifact_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        policy_ref: string;
+        verdict: "approved" | "blocked" | "changes_requested" | "inconclusive";
+        builder_agent_id: string;
+        reviewer_agent_id: string;
+        builder_provider: string;
+        builder_model: string;
+        reviewer_provider: string;
+        reviewer_model: string;
+        identity_source: "reported";
+        artifact_digest: string;
+    }, {
+        policy_ref: string;
+        verdict: "approved" | "blocked" | "changes_requested" | "inconclusive";
+        builder_agent_id: string;
+        reviewer_agent_id: string;
+        builder_provider: string;
+        builder_model: string;
+        reviewer_provider: string;
+        reviewer_model: string;
+        identity_source: "reported";
+        artifact_digest: string;
+    }>;
+    observed_at: z.ZodString;
+    context_receipt_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        digest: string;
+    }, {
+        path: string;
+        digest: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    run_id: string;
+    schema_version: 2;
+    task_id: string;
+    policy_digest: string;
+    source: "osstack_loop_host";
+    run_kind: "guarded-local" | "guarded-git";
+    contract_digest: string;
+    candidate: {
+        base_head: string;
+        head: string;
+        tree_id: string;
+        diff_digest: string;
+    };
+    workspace_state_digest: string;
+    checks: {
+        id: string;
+        registry_ref: string;
+        command_digest: string;
+        exit_code: number;
+        duration_ms: number;
+    }[];
+    review: {
+        policy_ref: string;
+        verdict: "approved" | "blocked" | "changes_requested" | "inconclusive";
+        builder_agent_id: string;
+        reviewer_agent_id: string;
+        builder_provider: string;
+        builder_model: string;
+        reviewer_provider: string;
+        reviewer_model: string;
+        identity_source: "reported";
+        artifact_digest: string;
+    };
+    observed_at: string;
+    context_receipt_refs: {
+        path: string;
+        digest: string;
+    }[];
+}, {
+    run_id: string;
+    schema_version: 2;
+    task_id: string;
+    policy_digest: string;
+    source: "osstack_loop_host";
+    run_kind: "guarded-local" | "guarded-git";
+    contract_digest: string;
+    candidate: {
+        base_head: string;
+        head: string;
+        tree_id: string;
+        diff_digest: string;
+    };
+    workspace_state_digest: string;
+    checks: {
+        id: string;
+        registry_ref: string;
+        command_digest: string;
+        exit_code: number;
+        duration_ms: number;
+    }[];
+    review: {
+        policy_ref: string;
+        verdict: "approved" | "blocked" | "changes_requested" | "inconclusive";
+        builder_agent_id: string;
+        reviewer_agent_id: string;
+        builder_provider: string;
+        builder_model: string;
+        reviewer_provider: string;
+        reviewer_model: string;
+        identity_source: "reported";
+        artifact_digest: string;
+    };
+    observed_at: string;
+    context_receipt_refs?: {
+        path: string;
+        digest: string;
+    }[] | undefined;
+}>;
+export type DeliveryVerificationReceiptV2 = z.infer<typeof DeliveryVerificationReceiptV2>;
+export declare const DeliveryReceiptReferenceV2: z.ZodObject<{
+    path: z.ZodString;
+    digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    digest: string;
+}, {
+    path: string;
+    digest: string;
+}>;
+export type DeliveryReceiptReferenceV2 = z.infer<typeof DeliveryReceiptReferenceV2>;
+//# sourceMappingURL=delivery-contract.d.ts.map