@c4a/context 0.6.19 → 0.7.0

package/indexerControlledInvocation.d.ts

@@ -0,0 +1,512 @@
+import { z } from "zod";
+import { type IndexerExecution, type IndexerProviderManifest } from "./indexerProvider.js";
+import { type IndexerProgramAuthorization, type ResolvedProviderBundle } from "./indexerProviderResolution.js";
+declare const fixedDependencySchema: z.ZodObject<{
+    package: z.ZodString;
+    version: z.ZodString;
+    lock_integrity: z.ZodString;
+    resolved_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    package: string;
+    version: string;
+    lock_integrity: string;
+    resolved_digest: string;
+}, {
+    package: string;
+    version: string;
+    lock_integrity: string;
+    resolved_digest: string;
+}>;
+export declare const indexerFixedDependencySetSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.fixed-dependency-set/v1">;
+    dependencies: z.ZodArray<z.ZodObject<{
+        package: z.ZodString;
+        version: z.ZodString;
+        lock_integrity: z.ZodString;
+        resolved_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }, {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }>, "many">;
+    dependency_set_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.fixed-dependency-set/v1";
+    dependency_set_digest: string;
+    dependencies: {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }[];
+}, {
+    protocol: "context.indexer.fixed-dependency-set/v1";
+    dependency_set_digest: string;
+    dependencies: {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }[];
+}>, {
+    protocol: "context.indexer.fixed-dependency-set/v1";
+    dependency_set_digest: string;
+    dependencies: {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }[];
+}, {
+    protocol: "context.indexer.fixed-dependency-set/v1";
+    dependency_set_digest: string;
+    dependencies: {
+        package: string;
+        version: string;
+        lock_integrity: string;
+        resolved_digest: string;
+    }[];
+}>;
+export type IndexerFixedDependencySet = z.infer<typeof indexerFixedDependencySetSchema>;
+declare const executionLimitsSchema: z.ZodObject<{
+    timeout_ms: z.ZodNumber;
+    max_stdin_bytes: z.ZodNumber;
+    max_stdout_bytes: z.ZodNumber;
+    max_stderr_bytes: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    timeout_ms: number;
+    max_stdin_bytes: number;
+    max_stdout_bytes: number;
+    max_stderr_bytes: number;
+}, {
+    timeout_ms: number;
+    max_stdin_bytes: number;
+    max_stdout_bytes: number;
+    max_stderr_bytes: number;
+}>;
+export type IndexerExecutionLimits = z.infer<typeof executionLimitsSchema>;
+export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.controlled-invocation/v1">;
+    resource: z.ZodEnum<["program", "activation-detector", "authoring-inspector"]>;
+    program: z.ZodNullable<z.ZodObject<{
+        origin: z.ZodEnum<["provider-bundle", "project-local"]>;
+        path: z.ZodString;
+        content_digest: z.ZodString;
+        program_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    }, {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    }>>;
+    provider: 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;
+        bundle_integrity: z.ZodString;
+        manifest_digest: z.ZodString;
+        provider_fingerprint: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    }, {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    }>;
+    execution: z.ZodObject<{
+        runtime: z.ZodLiteral<"node">;
+        entry: z.ZodEffects<z.ZodString, string, string>;
+        args: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    }, {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    }>;
+    capabilities: z.ZodArray<z.ZodEnum<["source.read", "parser-facts.read", "indexer-result.write"]>, "many">;
+    dependencies: z.ZodEffects<z.ZodObject<{
+        protocol: z.ZodLiteral<"context.indexer.fixed-dependency-set/v1">;
+        dependencies: z.ZodArray<z.ZodObject<{
+            package: z.ZodString;
+            version: z.ZodString;
+            lock_integrity: z.ZodString;
+            resolved_digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }, {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }>, "many">;
+        dependency_set_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    }, {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    }>, {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    }, {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    }>;
+    authorized_scope: z.ZodEffects<z.ZodObject<{
+        source_ref: z.ZodString;
+        module_refs: z.ZodArray<z.ZodString, "many">;
+        scope_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }>, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }>;
+    authorization: z.ZodObject<{
+        level: z.ZodLiteral<"trusted-program">;
+        sandboxed_program: z.ZodLiteral<false>;
+        trust_basis: z.ZodEnum<["first-party", "verified", "project-authorized-exact-digest"]>;
+        authority_digest: z.ZodString;
+        policy_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    }, {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    }>;
+    environment: z.ZodLiteral<"empty">;
+    shell: z.ZodLiteral<false>;
+    limits: z.ZodObject<{
+        timeout_ms: z.ZodNumber;
+        max_stdin_bytes: z.ZodNumber;
+        max_stdout_bytes: z.ZodNumber;
+        max_stderr_bytes: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    }, {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    }>;
+    invocation_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.controlled-invocation/v1";
+    provider: {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    };
+    capabilities: ("source.read" | "parser-facts.read" | "indexer-result.write")[];
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    resource: "program" | "activation-detector" | "authoring-inspector";
+    execution: {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    };
+    program: {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    } | null;
+    dependencies: {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    };
+    authorization: {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    };
+    environment: "empty";
+    shell: false;
+    limits: {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    };
+    invocation_digest: string;
+}, {
+    protocol: "context.indexer.controlled-invocation/v1";
+    provider: {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    };
+    capabilities: ("source.read" | "parser-facts.read" | "indexer-result.write")[];
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    resource: "program" | "activation-detector" | "authoring-inspector";
+    execution: {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    };
+    program: {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    } | null;
+    dependencies: {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    };
+    authorization: {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    };
+    environment: "empty";
+    shell: false;
+    limits: {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    };
+    invocation_digest: string;
+}>, {
+    protocol: "context.indexer.controlled-invocation/v1";
+    provider: {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    };
+    capabilities: ("source.read" | "parser-facts.read" | "indexer-result.write")[];
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    resource: "program" | "activation-detector" | "authoring-inspector";
+    execution: {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    };
+    program: {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    } | null;
+    dependencies: {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    };
+    authorization: {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    };
+    environment: "empty";
+    shell: false;
+    limits: {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    };
+    invocation_digest: string;
+}, {
+    protocol: "context.indexer.controlled-invocation/v1";
+    provider: {
+        skill: string;
+        version: string;
+        indexer_id: string;
+        provider_id: string;
+        manifest_digest: string;
+        provider_fingerprint: string;
+        bundle_integrity: string;
+    };
+    capabilities: ("source.read" | "parser-facts.read" | "indexer-result.write")[];
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    resource: "program" | "activation-detector" | "authoring-inspector";
+    execution: {
+        entry: string;
+        args: string[];
+        runtime: "node";
+    };
+    program: {
+        path: string;
+        program_digest: string;
+        origin: "provider-bundle" | "project-local";
+        content_digest: string;
+    } | null;
+    dependencies: {
+        protocol: "context.indexer.fixed-dependency-set/v1";
+        dependency_set_digest: string;
+        dependencies: {
+            package: string;
+            version: string;
+            lock_integrity: string;
+            resolved_digest: string;
+        }[];
+    };
+    authorization: {
+        authority_digest: string;
+        sandboxed_program: false;
+        level: "trusted-program";
+        trust_basis: "first-party" | "verified" | "project-authorized-exact-digest";
+        policy_digest: string;
+    };
+    environment: "empty";
+    shell: false;
+    limits: {
+        timeout_ms: number;
+        max_stdin_bytes: number;
+        max_stdout_bytes: number;
+        max_stderr_bytes: number;
+    };
+    invocation_digest: string;
+}>;
+export type IndexerControlledInvocation = z.infer<typeof indexerControlledInvocationSchema>;
+export declare function assertIndexerCanonicalOrder(values: readonly string[], field: string): void;
+export declare function buildIndexerFixedDependencySet(dependencies: readonly z.input<typeof fixedDependencySchema>[]): IndexerFixedDependencySet;
+export declare function validateIndexerFixedDependencySet(value: unknown): IndexerFixedDependencySet;
+export declare function buildIndexerControlledInvocation(input: {
+    resource: IndexerControlledInvocation["resource"];
+    manifest: IndexerProviderManifest;
+    bundle: ResolvedProviderBundle;
+    execution: IndexerExecution;
+    capabilities: readonly IndexerControlledInvocation["capabilities"][number][];
+    dependencies: IndexerFixedDependencySet;
+    scope: {
+        source_ref: string;
+        module_refs: readonly string[];
+    };
+    limits: IndexerExecutionLimits;
+    project_ref: string;
+    project_authorization?: IndexerProgramAuthorization;
+    local_program?: {
+        path: string;
+        content_digest: string;
+    };
+}): IndexerControlledInvocation;
+export declare function validateIndexerControlledInvocation(value: unknown): IndexerControlledInvocation;
+export {};