@c4a/context 0.6.19 → 0.7.0

package/indexerMainLifecycle.d.ts

@@ -0,0 +1,258 @@
+import { z } from "zod";
+import { buildIndexerMainWorkset, type IndexerMainAuthorWorkset, type IndexerMainPartitionWorkset, type IndexerMainWorksetSet, type IndexerTargetResolutionView } from "./indexerMainWorkset.js";
+import { validateIndexerMainRunResult, type IndexerMainRunRequest, type IndexerMainRunResult } from "./indexerMainRunProtocol.js";
+import { type IndexerPartitionPlan, type IndexerPartitionStrategy } from "./indexerPartitionPlan.js";
+import { type IndexerInventoryMember } from "./indexerInventoryDisposition.js";
+import { type IndexerPartitionSubject } from "./indexerSubjectCatalog.js";
+export interface IndexerPartitionValidationInput {
+    plan: unknown;
+    workset: IndexerMainPartitionWorkset;
+    canonical_inventory_members: readonly IndexerInventoryMember[];
+    authorized_source_refs: readonly string[];
+    authorized_strategies: readonly {
+        strategy_ref: IndexerPartitionStrategy;
+        strategy_digest: string;
+    }[];
+    required_question_target_refs?: readonly string[];
+}
+export declare function validateIndexerPartitionInputs(inputs: readonly IndexerPartitionValidationInput[]): Array<{
+    workset: IndexerMainPartitionWorkset;
+    plan: IndexerPartitionPlan;
+}>;
+export declare function indexerPartitionGroupRef(input: {
+    partition_workset_digest: string;
+    group_key: string;
+}): string;
+export declare function projectIndexerPartitionSubjects(inputs: readonly IndexerPartitionValidationInput[]): IndexerPartitionSubject[];
+type PartitionWorksetInput = Parameters<typeof buildIndexerMainWorkset>[0] & {
+    stage: "partition";
+};
+export declare function buildIndexerMainPartitionWorksets(inputs: readonly PartitionWorksetInput[]): {
+    worksets: IndexerMainPartitionWorkset[];
+    workset_set: IndexerMainWorksetSet;
+};
+export interface IndexerAuthorGroupContext {
+    partition_workset_digest: string;
+    group_key: string;
+    group_dependency_view_digest: string;
+    allowed_artifact_policy_variants: readonly string[];
+    artifact_policy_eligibility_digest: string;
+    target_resolution_view?: IndexerTargetResolutionView;
+}
+export declare function buildIndexerMainAuthorWorksets(input: {
+    partitions: readonly IndexerPartitionValidationInput[];
+    group_contexts: readonly IndexerAuthorGroupContext[];
+}): {
+    worksets: IndexerMainAuthorWorkset[];
+    workset_set: IndexerMainWorksetSet;
+};
+export declare const indexerMainAcceptedRecordSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.main-accepted-result/v1">;
+    workset_digest: z.ZodString;
+    stage: z.ZodEnum<["partition", "author"]>;
+    execution_request_digest: z.ZodString;
+    result_digest: z.ZodString;
+    receipt_digest: z.ZodString;
+    run_envelope_digest: z.ZodString;
+    artifact_dependency_set_digest: z.ZodNullable<z.ZodString>;
+    acceptance_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.main-accepted-result/v1";
+    workset_digest: string;
+    receipt_digest: string;
+    stage: "partition" | "author";
+    execution_request_digest: string;
+    result_digest: string;
+    run_envelope_digest: string;
+    artifact_dependency_set_digest: string | null;
+    acceptance_digest: string;
+}, {
+    protocol: "context.indexer.main-accepted-result/v1";
+    workset_digest: string;
+    receipt_digest: string;
+    stage: "partition" | "author";
+    execution_request_digest: string;
+    result_digest: string;
+    run_envelope_digest: string;
+    artifact_dependency_set_digest: string | null;
+    acceptance_digest: string;
+}>;
+export type IndexerMainAcceptedRecord = z.infer<typeof indexerMainAcceptedRecordSchema>;
+export declare function validateIndexerMainAcceptedRecord(value: unknown): IndexerMainAcceptedRecord;
+export declare function buildIndexerMainAcceptedRecord(input: {
+    request: IndexerMainRunRequest;
+    result: IndexerMainRunResult;
+    run_envelope: ReturnType<typeof validateIndexerMainRunResult>["run_envelope"];
+    artifact_dependency_set: ReturnType<typeof validateIndexerMainRunResult>["artifact_dependency_set"];
+}): IndexerMainAcceptedRecord;
+export declare function validateAndRecordIndexerMainRun(input: Parameters<typeof validateIndexerMainRunResult>[0]): ReturnType<typeof validateIndexerMainRunResult> & {
+    accepted_record: IndexerMainAcceptedRecord;
+};
+export declare const indexerMainStateRecordSchema: z.ZodUnion<[z.ZodObject<{
+    workset_digest: z.ZodString;
+    state: z.ZodLiteral<"pending">;
+}, "strict", z.ZodTypeAny, {
+    workset_digest: string;
+    state: "pending";
+}, {
+    workset_digest: string;
+    state: "pending";
+}>, z.ZodObject<{
+    workset_digest: z.ZodString;
+    state: z.ZodLiteral<"running">;
+    execution_request_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    workset_digest: string;
+    state: "running";
+    execution_request_digest: string;
+}, {
+    workset_digest: string;
+    state: "running";
+    execution_request_digest: string;
+}>, z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.main-accepted-result/v1">;
+    workset_digest: z.ZodString;
+    stage: z.ZodEnum<["partition", "author"]>;
+    execution_request_digest: z.ZodString;
+    result_digest: z.ZodString;
+    receipt_digest: z.ZodString;
+    run_envelope_digest: z.ZodString;
+    artifact_dependency_set_digest: z.ZodNullable<z.ZodString>;
+    acceptance_digest: z.ZodString;
+} & {
+    state: z.ZodLiteral<"accepted">;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.main-accepted-result/v1";
+    workset_digest: string;
+    state: "accepted";
+    receipt_digest: string;
+    stage: "partition" | "author";
+    execution_request_digest: string;
+    result_digest: string;
+    run_envelope_digest: string;
+    artifact_dependency_set_digest: string | null;
+    acceptance_digest: string;
+}, {
+    protocol: "context.indexer.main-accepted-result/v1";
+    workset_digest: string;
+    state: "accepted";
+    receipt_digest: string;
+    stage: "partition" | "author";
+    execution_request_digest: string;
+    result_digest: string;
+    run_envelope_digest: string;
+    artifact_dependency_set_digest: string | null;
+    acceptance_digest: string;
+}>, z.ZodObject<{
+    workset_digest: z.ZodString;
+    state: z.ZodLiteral<"failed">;
+    execution_request_digest: z.ZodString;
+    reason_code: z.ZodEffects<z.ZodString, string, string>;
+    dependency_digests: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    workset_digest: string;
+    state: "failed";
+    reason_code: string;
+    execution_request_digest: string;
+    dependency_digests: string[];
+}, {
+    workset_digest: string;
+    state: "failed";
+    reason_code: string;
+    execution_request_digest: string;
+    dependency_digests: string[];
+}>, z.ZodObject<{
+    workset_digest: z.ZodString;
+    state: z.ZodLiteral<"stale">;
+    previous_workset_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    workset_digest: string;
+    state: "stale";
+    previous_workset_digest: string;
+}, {
+    workset_digest: string;
+    state: "stale";
+    previous_workset_digest: string;
+}>]>;
+export type IndexerMainStateRecord = z.infer<typeof indexerMainStateRecordSchema>;
+export declare const indexerMainWorksetStatusSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.main-workset-status/v1">;
+    workset_set_digest: z.ZodString;
+    total_count: z.ZodNumber;
+    pending_count: z.ZodNumber;
+    accepted_count: z.ZodNumber;
+    failed_count: z.ZodNumber;
+    stale_count: z.ZodNumber;
+    next_refs: z.ZodArray<z.ZodObject<{
+        workset_digest: z.ZodString;
+        stage: z.ZodEnum<["partition", "author"]>;
+        indexer_id: z.ZodEffects<z.ZodString, string, string>;
+        owner_cohort_ref: z.ZodString;
+        group_key: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<["pending", "failed", "stale"]>;
+    }, "strict", z.ZodTypeAny, {
+        workset_digest: string;
+        state: "failed" | "pending" | "stale";
+        indexer_id: string;
+        stage: "partition" | "author";
+        owner_cohort_ref: string;
+        group_key?: string | undefined;
+    }, {
+        workset_digest: string;
+        state: "failed" | "pending" | "stale";
+        indexer_id: string;
+        stage: "partition" | "author";
+        owner_cohort_ref: string;
+        group_key?: string | undefined;
+    }>, "many">;
+    accepted_result_set_digest: z.ZodString;
+    outcome: z.ZodEnum<["complete", "index-main-workset-pending", "index-main-workset-failed", "index-main-workset-stale"]>;
+    can_advance: z.ZodBoolean;
+    status_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.main-workset-status/v1";
+    workset_set_digest: string;
+    outcome: "complete" | "index-main-workset-pending" | "index-main-workset-failed" | "index-main-workset-stale";
+    total_count: number;
+    pending_count: number;
+    accepted_count: number;
+    failed_count: number;
+    stale_count: number;
+    next_refs: {
+        workset_digest: string;
+        state: "failed" | "pending" | "stale";
+        indexer_id: string;
+        stage: "partition" | "author";
+        owner_cohort_ref: string;
+        group_key?: string | undefined;
+    }[];
+    accepted_result_set_digest: string;
+    can_advance: boolean;
+    status_digest: string;
+}, {
+    protocol: "context.indexer.main-workset-status/v1";
+    workset_set_digest: string;
+    outcome: "complete" | "index-main-workset-pending" | "index-main-workset-failed" | "index-main-workset-stale";
+    total_count: number;
+    pending_count: number;
+    accepted_count: number;
+    failed_count: number;
+    stale_count: number;
+    next_refs: {
+        workset_digest: string;
+        state: "failed" | "pending" | "stale";
+        indexer_id: string;
+        stage: "partition" | "author";
+        owner_cohort_ref: string;
+        group_key?: string | undefined;
+    }[];
+    accepted_result_set_digest: string;
+    can_advance: boolean;
+    status_digest: string;
+}>;
+export type IndexerMainWorksetStatus = z.infer<typeof indexerMainWorksetStatusSchema>;
+export declare function observeIndexerMainWorksetState(input: {
+    workset_set: unknown;
+    records: readonly unknown[];
+}): IndexerMainWorksetStatus;
+export {};