@c4a/context 0.6.18 → 0.7.0

package/indexerProviderResolution.d.ts

@@ -0,0 +1,752 @@
+import { z } from "zod";
+import type { IndexerExecution, IndexerProviderManifest } from "./indexerProvider.js";
+import { type IndexerDistribution } from "./indexerRegistry.js";
+export declare const providerResolutionRequestSchema: z.ZodObject<{
+    indexer_id: z.ZodEffects<z.ZodString, string, string>;
+    provider_id: z.ZodEffects<z.ZodString, string, string>;
+    skill: z.ZodEffects<z.ZodString, string, string>;
+    version: z.ZodString;
+    distribution: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"cli-bundled">;
+        locator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "cli-bundled";
+        locator: string;
+    }, {
+        kind: "cli-bundled";
+        locator: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"bundled">;
+        locator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "bundled";
+        locator: string;
+    }, {
+        kind: "bundled";
+        locator: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        locator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "workspace";
+        locator: string;
+    }, {
+        kind: "workspace";
+        locator: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"package">;
+        locator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "package";
+        locator: string;
+    }, {
+        kind: "package";
+        locator: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"marketplace">;
+        locator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "marketplace";
+        locator: string;
+    }, {
+        kind: "marketplace";
+        locator: string;
+    }>]>, {
+        kind: "cli-bundled";
+        locator: string;
+    } | {
+        kind: "bundled";
+        locator: string;
+    } | {
+        kind: "workspace";
+        locator: string;
+    } | {
+        kind: "package";
+        locator: string;
+    } | {
+        kind: "marketplace";
+        locator: string;
+    }, {
+        kind: "cli-bundled";
+        locator: string;
+    } | {
+        kind: "bundled";
+        locator: string;
+    } | {
+        kind: "workspace";
+        locator: string;
+    } | {
+        kind: "package";
+        locator: string;
+    } | {
+        kind: "marketplace";
+        locator: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    skill: string;
+    version: string;
+    distribution: {
+        kind: "cli-bundled";
+        locator: string;
+    } | {
+        kind: "bundled";
+        locator: string;
+    } | {
+        kind: "workspace";
+        locator: string;
+    } | {
+        kind: "package";
+        locator: string;
+    } | {
+        kind: "marketplace";
+        locator: string;
+    };
+    indexer_id: string;
+    provider_id: string;
+}, {
+    skill: string;
+    version: string;
+    distribution: {
+        kind: "cli-bundled";
+        locator: string;
+    } | {
+        kind: "bundled";
+        locator: string;
+    } | {
+        kind: "workspace";
+        locator: string;
+    } | {
+        kind: "package";
+        locator: string;
+    } | {
+        kind: "marketplace";
+        locator: string;
+    };
+    indexer_id: string;
+    provider_id: string;
+}>;
+export declare const resolvedProviderBundleSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.resolved-provider-bundle/v1">;
+    request: z.ZodObject<{
+        indexer_id: z.ZodEffects<z.ZodString, string, string>;
+        provider_id: z.ZodEffects<z.ZodString, string, string>;
+        skill: z.ZodEffects<z.ZodString, string, string>;
+        version: z.ZodString;
+        distribution: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"cli-bundled">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "cli-bundled";
+            locator: string;
+        }, {
+            kind: "cli-bundled";
+            locator: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"bundled">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "bundled";
+            locator: string;
+        }, {
+            kind: "bundled";
+            locator: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"workspace">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "workspace";
+            locator: string;
+        }, {
+            kind: "workspace";
+            locator: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"package">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "package";
+            locator: string;
+        }, {
+            kind: "package";
+            locator: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"marketplace">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "marketplace";
+            locator: string;
+        }, {
+            kind: "marketplace";
+            locator: string;
+        }>]>, {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        }, {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    }, {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    }>;
+    resolved: z.ZodObject<{
+        integrity: z.ZodString;
+        manifest_digest: z.ZodString;
+        issuer: z.ZodEffects<z.ZodString, string, string>;
+        trust: z.ZodEnum<["first-party", "verified", "project-authorized", "untrusted"]>;
+    }, "strict", z.ZodTypeAny, {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    }, {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    }>;
+    transport: z.ZodObject<{
+        kind: z.ZodEnum<["directory", "archive"]>;
+        path: z.ZodEffects<z.ZodString, string, string>;
+        expires_at: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    }, {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    }>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodString, string, string>;
+        digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        digest: string;
+    }, {
+        path: string;
+        digest: string;
+    }>, "many">;
+    receipt: z.ZodObject<{
+        resolver: z.ZodEffects<z.ZodString, string, string>;
+        resolved_at: z.ZodString;
+        authority_ref: z.ZodString;
+        receipt_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    }, {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.resolved-provider-bundle/v1";
+    files: {
+        path: string;
+        digest: string;
+    }[];
+    request: {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    };
+    resolved: {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    };
+    transport: {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    };
+    receipt: {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    };
+}, {
+    protocol: "context.indexer.resolved-provider-bundle/v1";
+    files: {
+        path: string;
+        digest: string;
+    }[];
+    request: {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    };
+    resolved: {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    };
+    transport: {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    };
+    receipt: {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    };
+}>, {
+    protocol: "context.indexer.resolved-provider-bundle/v1";
+    files: {
+        path: string;
+        digest: string;
+    }[];
+    request: {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    };
+    resolved: {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    };
+    transport: {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    };
+    receipt: {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    };
+}, {
+    protocol: "context.indexer.resolved-provider-bundle/v1";
+    files: {
+        path: string;
+        digest: string;
+    }[];
+    request: {
+        skill: string;
+        version: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        } | {
+            kind: "bundled";
+            locator: string;
+        } | {
+            kind: "workspace";
+            locator: string;
+        } | {
+            kind: "package";
+            locator: string;
+        } | {
+            kind: "marketplace";
+            locator: string;
+        };
+        indexer_id: string;
+        provider_id: string;
+    };
+    resolved: {
+        integrity: string;
+        manifest_digest: string;
+        issuer: string;
+        trust: "first-party" | "verified" | "project-authorized" | "untrusted";
+    };
+    transport: {
+        kind: "directory" | "archive";
+        path: string;
+        expires_at: string;
+    };
+    receipt: {
+        authority_ref: string;
+        receipt_digest: string;
+        resolver: string;
+        resolved_at: string;
+    };
+}>;
+export type ResolvedProviderBundle = z.infer<typeof resolvedProviderBundleSchema>;
+export type ProviderResolutionRequest = z.infer<typeof providerResolutionRequestSchema>;
+export interface ExpectedProviderResolution {
+    indexerId: string;
+    providerId: string;
+    skill: string;
+    version: string;
+    integrity: string;
+    distribution: IndexerDistribution;
+}
+export declare function indexerProviderBundleIntegrity(files: readonly ResolvedProviderBundle["files"][number][]): string;
+export declare function resolvedProviderReceiptDigest(bundle: ResolvedProviderBundle): string;
+export declare function resolvedProviderStableFingerprint(bundle: ResolvedProviderBundle): string;
+export declare function validateResolvedProviderBundle(value: unknown, expected: ExpectedProviderResolution, now?: Date): ResolvedProviderBundle;
+export declare const indexerCliReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.cli-release-manifest/v1">;
+    package: z.ZodLiteral<"@c4a/context-cli">;
+    version: z.ZodString;
+    issuer: z.ZodLiteral<"context4ai/context">;
+    bundles: z.ZodArray<z.ZodObject<{
+        skill: z.ZodEffects<z.ZodString, string, string>;
+        version: z.ZodString;
+        distribution: z.ZodObject<{
+            kind: z.ZodLiteral<"cli-bundled">;
+            locator: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "cli-bundled";
+            locator: string;
+        }, {
+            kind: "cli-bundled";
+            locator: string;
+        }>;
+        integrity: z.ZodString;
+        manifest_digest: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            digest: string;
+        }, {
+            path: string;
+            digest: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }, {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.cli-release-manifest/v1";
+    package: "@c4a/context-cli";
+    version: string;
+    issuer: "context4ai/context";
+    bundles: {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }[];
+}, {
+    protocol: "context.indexer.cli-release-manifest/v1";
+    package: "@c4a/context-cli";
+    version: string;
+    issuer: "context4ai/context";
+    bundles: {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }[];
+}>, {
+    protocol: "context.indexer.cli-release-manifest/v1";
+    package: "@c4a/context-cli";
+    version: string;
+    issuer: "context4ai/context";
+    bundles: {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }[];
+}, {
+    protocol: "context.indexer.cli-release-manifest/v1";
+    package: "@c4a/context-cli";
+    version: string;
+    issuer: "context4ai/context";
+    bundles: {
+        files: {
+            path: string;
+            digest: string;
+        }[];
+        skill: string;
+        version: string;
+        integrity: string;
+        distribution: {
+            kind: "cli-bundled";
+            locator: string;
+        };
+        manifest_digest: string;
+    }[];
+}>;
+export type IndexerCliReleaseManifest = z.infer<typeof indexerCliReleaseManifestSchema>;
+export declare const indexerHostExecutionCapabilitiesSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.host-execution-capabilities/v1">;
+    adapter: z.ZodEffects<z.ZodString, string, string>;
+    adapter_version: z.ZodString;
+    sandboxed_program: z.ZodLiteral<false>;
+}, "strict", z.ZodTypeAny, {
+    adapter: string;
+    protocol: "context.indexer.host-execution-capabilities/v1";
+    adapter_version: string;
+    sandboxed_program: false;
+}, {
+    adapter: string;
+    protocol: "context.indexer.host-execution-capabilities/v1";
+    adapter_version: string;
+    sandboxed_program: false;
+}>;
+export type IndexerHostExecutionCapabilities = z.infer<typeof indexerHostExecutionCapabilitiesSchema>;
+export declare const indexerProgramAuthorizationSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.program-authorization/v1">;
+    project_ref: z.ZodString;
+    provider_integrity: z.ZodString;
+    provider_fingerprint: z.ZodString;
+    manifest_digest: z.ZodString;
+    resource: z.ZodLiteral<"program">;
+    program_origin: z.ZodEnum<["provider-bundle", "project-local"]>;
+    program_digest: z.ZodString;
+    execution_digest: z.ZodString;
+    capability_set_digest: z.ZodString;
+    dependency_set_digest: z.ZodString;
+    scope_digest: z.ZodString;
+    execution_policy_digest: z.ZodString;
+    report_digest: z.ZodString;
+    authority_ref: z.ZodString;
+    authority_scope_digest: z.ZodString;
+    sandboxed_program: z.ZodLiteral<false>;
+    receipt_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.program-authorization/v1";
+    scope_digest: string;
+    authority_ref: string;
+    resource: "program";
+    receipt_digest: string;
+    manifest_digest: string;
+    sandboxed_program: false;
+    project_ref: string;
+    provider_integrity: string;
+    provider_fingerprint: string;
+    program_origin: "provider-bundle" | "project-local";
+    program_digest: string;
+    execution_digest: string;
+    capability_set_digest: string;
+    dependency_set_digest: string;
+    execution_policy_digest: string;
+    report_digest: string;
+    authority_scope_digest: string;
+}, {
+    protocol: "context.indexer.program-authorization/v1";
+    scope_digest: string;
+    authority_ref: string;
+    resource: "program";
+    receipt_digest: string;
+    manifest_digest: string;
+    sandboxed_program: false;
+    project_ref: string;
+    provider_integrity: string;
+    provider_fingerprint: string;
+    program_origin: "provider-bundle" | "project-local";
+    program_digest: string;
+    execution_digest: string;
+    capability_set_digest: string;
+    dependency_set_digest: string;
+    execution_policy_digest: string;
+    report_digest: string;
+    authority_scope_digest: string;
+}>;
+export type IndexerProgramAuthorization = z.infer<typeof indexerProgramAuthorizationSchema>;
+export declare function indexerProgramExecutionDigest(execution: IndexerExecution): string;
+export declare function indexerProgramIdentityDigest(input: {
+    origin: "provider-bundle" | "project-local";
+    path: string;
+    content_digest: string;
+    provider_integrity: string;
+    execution_digest: string;
+}): string;
+export declare function indexerProgramCapabilitySetDigest(capabilities: readonly string[]): string;
+export declare function indexerRequestedProgramPolicyDigest(input: {
+    execution_digest: string;
+    capability_set_digest: string;
+    dependency_set_digest: string;
+    scope_digest: string;
+    limits: {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    };
+}): string;
+export declare function validateIndexerProgramAuthorization(value: unknown): IndexerProgramAuthorization;
+export declare function buildIndexerProgramAuthorization(input: Omit<IndexerProgramAuthorization, "protocol" | "sandboxed_program" | "receipt_digest">): IndexerProgramAuthorization;
+export type IndexerProgramExecutionLevel = "declarative" | "trusted-program" | "sandboxed-program" | "advisory-only";
+export interface IndexerProgramExecutionPolicy {
+    protocol: "context.indexer.program-execution-policy/v1";
+    level: IndexerProgramExecutionLevel;
+    sandboxedProgram: false;
+    executable: boolean;
+    reason: "provider-is-declarative" | "first-party-provider" | "verified-provider" | "project-authorized-exact-digest" | "untrusted-program-without-sandbox";
+}
+export declare function deriveIndexerProgramExecutionPolicy(input: {
+    manifest: IndexerProviderManifest;
+    bundle: ResolvedProviderBundle;
+    host: IndexerHostExecutionCapabilities;
+    authorization?: IndexerProgramAuthorization;
+    projectRef: string;
+}): IndexerProgramExecutionPolicy;