@honua/react 0.1.7-beta.0 → 0.1.9-beta.0

package/gen/geospatial/v1/execution_types_pb.d.ts

@@ -0,0 +1,1186 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Extent, Severity, SpatialReference, StatisticDefinition } from "./common_pb.js";
+import type { Geometry, SpatialFilter } from "./spatial_types_pb.js";
+import type { MaterializationState, RetentionPolicyRef, WorkspaceRef } from "./workspace_artifact_types_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file geospatial/v1/execution_types.proto.
+ */
+export declare const file_geospatial_v1_execution_types: GenFile;
+/**
+ * ExecutionPlan describes a sequence of steps to execute.
+ *
+ * @generated from message geospatial.v1.ExecutionPlan
+ */
+export type ExecutionPlan = Message<"geospatial.v1.ExecutionPlan"> & {
+    /**
+     * @generated from field: string plan_id = 1;
+     */
+    planId: string;
+    /**
+     * @generated from field: string spec_version = 2;
+     */
+    specVersion: string;
+    /**
+     * @generated from field: geospatial.v1.WorkflowFamily workflow_family = 3;
+     */
+    workflowFamily: WorkflowFamily;
+    /**
+     * @generated from field: repeated geospatial.v1.PlanStep steps = 4;
+     */
+    steps: PlanStep[];
+    /**
+     * @generated from field: repeated string expected_outputs = 5;
+     */
+    expectedOutputs: string[];
+};
+/**
+ * Describes the message geospatial.v1.ExecutionPlan.
+ * Use `create(ExecutionPlanSchema)` to create a new message.
+ */
+export declare const ExecutionPlanSchema: GenMessage<ExecutionPlan>;
+/**
+ * PlanStep describes a single step within an execution plan.
+ * Standard step kinds for analysis workflows: query_features, geoprocess,
+ * aggregate, render_map, export. Standard kinds should use the typed
+ * ParameterValue branches where a canonical message exists (e.g.,
+ * spatial_filter_value for query_features spatial filters).
+ *
+ * @generated from message geospatial.v1.PlanStep
+ */
+export type PlanStep = Message<"geospatial.v1.PlanStep"> & {
+    /**
+     * @generated from field: string step_id = 1;
+     */
+    stepId: string;
+    /**
+     * @generated from field: string kind = 2;
+     */
+    kind: string;
+    /**
+     * @generated from field: map<string, geospatial.v1.ParameterValue> inputs = 3;
+     */
+    inputs: {
+        [key: string]: ParameterValue;
+    };
+    /**
+     * @generated from field: repeated string dependencies = 4;
+     */
+    dependencies: string[];
+};
+/**
+ * Describes the message geospatial.v1.PlanStep.
+ * Use `create(PlanStepSchema)` to create a new message.
+ */
+export declare const PlanStepSchema: GenMessage<PlanStep>;
+/**
+ * ErrorDetail is the canonical, structured application-error type for the
+ * protocol. It is reused (directly or embedded) by every surface that reports a
+ * structured error — streaming terminal error events, feature edit failures
+ * (FeatureService), and spec diagnostics (SpecService) — so that clients parse
+ * one error shape everywhere.
+ *
+ * Fields 1-3 are the canonical core (code, message, details); fields 4-8 carry
+ * optional execution-context that the operator/execution surfaces populate and
+ * that other surfaces simply leave unset. Fields 9-10 carry diagnostic context
+ * (severity, remedy) used by surfaces that classify errors at a severity level,
+ * such as SpecService plan and apply diagnostics.
+ *
+ * @generated from message geospatial.v1.ErrorDetail
+ */
+export type ErrorDetail = Message<"geospatial.v1.ErrorDetail"> & {
+    /**
+     * Numeric, machine-parseable error code. Aligned with GeoServices/Esri REST
+     * error-code semantics where applicable (e.g. 400 invalid/missing parameters,
+     * 403 forbidden, 404 not found, 498/499 token/auth, 500 internal server
+     * error); these also line up with HTTP/gRPC status conventions. 0 means
+     * unset.
+     *
+     * @generated from field: int32 code = 1;
+     */
+    code: number;
+    /**
+     * Human-readable error message.
+     *
+     * @generated from field: string message = 2;
+     */
+    message: string;
+    /**
+     * Additional machine-readable key/value context for the error.
+     *
+     * @generated from field: map<string, string> details = 3;
+     */
+    details: {
+        [key: string]: string;
+    };
+    /**
+     * Domain of the error (execution surfaces).
+     *
+     * @generated from field: geospatial.v1.ErrorCategory category = 4;
+     */
+    category: ErrorCategory;
+    /**
+     * Descriptive label for the execution phase where the error occurred.
+     *
+     * @generated from field: string phase = 5;
+     */
+    phase: string;
+    /**
+     * Correlates to the originating node: PlanStep.step_id (ProcessService),
+     * PipelineStage.stage_id (PipelineService), or a server-chosen stage
+     * identifier (RenderService, BuilderService, DeploymentService, SpecService).
+     *
+     * @generated from field: string node_id = 6;
+     */
+    nodeId: string;
+    /**
+     * @generated from field: geospatial.v1.Retryability retryability = 7;
+     */
+    retryability: Retryability;
+    /**
+     * @generated from field: string suggested_action = 8;
+     */
+    suggestedAction: string;
+    /**
+     * Diagnostic severity. Set by surfaces that classify errors at a severity
+     * level (e.g., SpecService warnings in PlanSpec and ApplySpec). Execution-
+     * phase terminal errors implicitly have SEVERITY_ERROR; callers may leave
+     * this unset for non-diagnostic error contexts.
+     *
+     * @generated from field: geospatial.v1.Severity severity = 9;
+     */
+    severity: Severity;
+    /**
+     * Optional remediation hint. Populated by surfaces that can suggest a
+     * corrective action (e.g., SpecService diagnostics).
+     *
+     * @generated from field: string remedy = 10;
+     */
+    remedy: string;
+};
+/**
+ * Describes the message geospatial.v1.ErrorDetail.
+ * Use `create(ErrorDetailSchema)` to create a new message.
+ */
+export declare const ErrorDetailSchema: GenMessage<ErrorDetail>;
+/**
+ * ArtifactRef identifies a produced artifact and carries the canonical typed
+ * handles for its owning workspace, bound retention policy, and
+ * materialization state. The full Artifact resource is returned by
+ * ArtifactService.GetArtifact.
+ *
+ * Field 5 (workspace_ref), field 6 (retention_policy_ref), and field 7
+ * (materialization_state) are the legacy string handles. They remain wire-
+ * and JSON-compatible with prior v1 releases and are deprecated in favor of
+ * the typed handles on fields 8, 9, and 10. When both the legacy string
+ * field and the typed replacement are populated, the typed replacement is
+ * authoritative; the legacy field, if populated, MUST describe the same
+ * underlying identity. Producers should populate only the typed fields on
+ * new writes.
+ *
+ * @generated from message geospatial.v1.ArtifactRef
+ */
+export type ArtifactRef = Message<"geospatial.v1.ArtifactRef"> & {
+    /**
+     * @generated from field: string artifact_id = 1;
+     */
+    artifactId: string;
+    /**
+     * @generated from field: geospatial.v1.ArtifactClass artifact_class = 2;
+     */
+    artifactClass: ArtifactClass;
+    /**
+     * @generated from field: int32 artifact_version = 3;
+     */
+    artifactVersion: number;
+    /**
+     * Producer identifier — typically an ExecutionResult, PipelineResult,
+     * RenderResult, BuildResult, or DeploymentResult job id.
+     *
+     * @generated from field: string producer_ref = 4;
+     */
+    producerRef: string;
+    /**
+     * Deprecated since v1: use `workspace` (field 8) instead. Legacy workspace
+     * id retained for wire and JSON compatibility. Removal target: v2.
+     *
+     * @generated from field: string workspace_ref = 5 [deprecated = true];
+     * @deprecated
+     */
+    workspaceRef: string;
+    /**
+     * Deprecated since v1: use `retention` (field 9) instead. Legacy retention
+     * policy id retained for wire and JSON compatibility. Removal target: v2.
+     *
+     * @generated from field: string retention_policy_ref = 6 [deprecated = true];
+     * @deprecated
+     */
+    retentionPolicyRef: string;
+    /**
+     * Deprecated since v1: use `materialization` (field 10) instead. Legacy
+     * string label retained for wire and JSON compatibility. Removal
+     * target: v2.
+     *
+     * @generated from field: string materialization_state = 7 [deprecated = true];
+     * @deprecated
+     */
+    materializationState: string;
+    /**
+     * Owning workspace. Carries scope and revision for drift detection.
+     * Authoritative over the deprecated `workspace_ref` string.
+     *
+     * @generated from field: geospatial.v1.WorkspaceRef workspace = 8;
+     */
+    workspace?: WorkspaceRef | undefined;
+    /**
+     * Bound retention policy. Populated when the server has resolved a
+     * retention binding for the artifact. Authoritative over the deprecated
+     * `retention_policy_ref` string.
+     *
+     * @generated from field: geospatial.v1.RetentionPolicyRef retention = 9;
+     */
+    retention?: RetentionPolicyRef | undefined;
+    /**
+     * Whether the artifact's bytes are materialized in the workspace backend.
+     * Authoritative over the deprecated `materialization_state` string.
+     *
+     * @generated from field: geospatial.v1.MaterializationState materialization = 10;
+     */
+    materialization: MaterializationState;
+};
+/**
+ * Describes the message geospatial.v1.ArtifactRef.
+ * Use `create(ArtifactRefSchema)` to create a new message.
+ */
+export declare const ArtifactRefSchema: GenMessage<ArtifactRef>;
+/**
+ * EstimatedArtifact describes an artifact expected from a dry run.
+ *
+ * @generated from message geospatial.v1.EstimatedArtifact
+ */
+export type EstimatedArtifact = Message<"geospatial.v1.EstimatedArtifact"> & {
+    /**
+     * @generated from field: geospatial.v1.ArtifactClass artifact_class = 1;
+     */
+    artifactClass: ArtifactClass;
+    /**
+     * @generated from field: int64 estimated_size_bytes = 2;
+     */
+    estimatedSizeBytes: bigint;
+    /**
+     * @generated from field: string description = 3;
+     */
+    description: string;
+};
+/**
+ * Describes the message geospatial.v1.EstimatedArtifact.
+ * Use `create(EstimatedArtifactSchema)` to create a new message.
+ */
+export declare const EstimatedArtifactSchema: GenMessage<EstimatedArtifact>;
+/**
+ * SideEffect describes an external effect that execution would produce.
+ *
+ * @generated from message geospatial.v1.SideEffect
+ */
+export type SideEffect = Message<"geospatial.v1.SideEffect"> & {
+    /**
+     * @generated from field: string effect_type = 1;
+     */
+    effectType: string;
+    /**
+     * @generated from field: string target = 2;
+     */
+    target: string;
+    /**
+     * @generated from field: string description = 3;
+     */
+    description: string;
+};
+/**
+ * Describes the message geospatial.v1.SideEffect.
+ * Use `create(SideEffectSchema)` to create a new message.
+ */
+export declare const SideEffectSchema: GenMessage<SideEffect>;
+/**
+ * CostEstimate provides estimated resource consumption for execution.
+ *
+ * @generated from message geospatial.v1.CostEstimate
+ */
+export type CostEstimate = Message<"geospatial.v1.CostEstimate"> & {
+    /**
+     * @generated from field: string units = 1;
+     */
+    units: string;
+    /**
+     * @generated from field: double amount = 2;
+     */
+    amount: number;
+};
+/**
+ * Describes the message geospatial.v1.CostEstimate.
+ * Use `create(CostEstimateSchema)` to create a new message.
+ */
+export declare const CostEstimateSchema: GenMessage<CostEstimate>;
+/**
+ * DryRunResult contains the estimated impact of executing a plan without side
+ * effects. Fields 1-4 are the canonical cost envelope used by the five operator
+ * services (ProcessService, PipelineService, RenderService, BuilderService,
+ * DeploymentService). Fields 5-10 extend the message for per-node DAG
+ * estimation and actuals, used by SpecService where the cost model is
+ * per-node rather than per-plan. Operator-service dry-run responses populate
+ * fields 1-4; SpecService node estimates populate fields 5-7; SpecService
+ * apply-event actuals populate fields 8-10.
+ *
+ * @generated from message geospatial.v1.DryRunResult
+ */
+export type DryRunResult = Message<"geospatial.v1.DryRunResult"> & {
+    /**
+     * @generated from field: int64 estimated_duration_seconds = 1;
+     */
+    estimatedDurationSeconds: bigint;
+    /**
+     * @generated from field: repeated geospatial.v1.EstimatedArtifact estimated_artifacts = 2;
+     */
+    estimatedArtifacts: EstimatedArtifact[];
+    /**
+     * @generated from field: repeated geospatial.v1.SideEffect side_effects = 3;
+     */
+    sideEffects: SideEffect[];
+    /**
+     * @generated from field: geospatial.v1.CostEstimate cost_estimate = 4;
+     */
+    costEstimate?: CostEstimate | undefined;
+    /**
+     * Per-node estimation fields for dependency-DAG workflows (SpecService).
+     *
+     * @generated from field: int64 estimated_rows = 5;
+     */
+    estimatedRows: bigint;
+    /**
+     * @generated from field: int64 estimated_bytes = 6;
+     */
+    estimatedBytes: bigint;
+    /**
+     * @generated from field: double estimated_duration_ms = 7;
+     */
+    estimatedDurationMs: number;
+    /**
+     * Per-node actual execution metrics, populated in streaming apply events
+     * after a node completes (SpecService ApplySpec).
+     *
+     * @generated from field: int64 actual_rows = 8;
+     */
+    actualRows: bigint;
+    /**
+     * @generated from field: int64 actual_bytes = 9;
+     */
+    actualBytes: bigint;
+    /**
+     * @generated from field: double actual_duration_ms = 10;
+     */
+    actualDurationMs: number;
+};
+/**
+ * Describes the message geospatial.v1.DryRunResult.
+ * Use `create(DryRunResultSchema)` to create a new message.
+ */
+export declare const DryRunResultSchema: GenMessage<DryRunResult>;
+/**
+ * JobProgress reports the current state of a running job.
+ *
+ * @generated from message geospatial.v1.JobProgress
+ */
+export type JobProgress = Message<"geospatial.v1.JobProgress"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: geospatial.v1.JobState state = 2;
+     */
+    state: JobState;
+    /**
+     * @generated from field: int32 progress_percent = 3;
+     */
+    progressPercent: number;
+    /**
+     * Correlates to the originating node: PlanStep.step_id (ProcessService),
+     * PipelineStage.stage_id (PipelineService), or a server-chosen stage
+     * identifier (RenderService, BuilderService, DeploymentService).
+     *
+     * @generated from field: string current_node_id = 4;
+     */
+    currentNodeId: string;
+    /**
+     * UTC milliseconds since epoch
+     *
+     * @generated from field: int64 started_at = 5;
+     */
+    startedAt: bigint;
+    /**
+     * UTC milliseconds since epoch
+     *
+     * @generated from field: int64 updated_at = 6;
+     */
+    updatedAt: bigint;
+    /**
+     * @generated from field: string message = 7;
+     */
+    message: string;
+};
+/**
+ * Describes the message geospatial.v1.JobProgress.
+ * Use `create(JobProgressSchema)` to create a new message.
+ */
+export declare const JobProgressSchema: GenMessage<JobProgress>;
+/**
+ * StageResult reports the outcome of an individual execution stage.
+ *
+ * @generated from message geospatial.v1.StageResult
+ */
+export type StageResult = Message<"geospatial.v1.StageResult"> & {
+    /**
+     * Correlates to the originating node: PlanStep.step_id (ProcessService),
+     * PipelineStage.stage_id (PipelineService), or a server-chosen stage
+     * identifier (RenderService, BuilderService, DeploymentService).
+     *
+     * @generated from field: string node_id = 1;
+     */
+    nodeId: string;
+    /**
+     * @generated from field: geospatial.v1.StageState state = 2;
+     */
+    state: StageState;
+    /**
+     * @generated from field: geospatial.v1.ErrorDetail error = 3;
+     */
+    error?: ErrorDetail | undefined;
+    /**
+     * @generated from field: repeated geospatial.v1.ArtifactRef partial_artifacts = 4;
+     */
+    partialArtifacts: ArtifactRef[];
+};
+/**
+ * Describes the message geospatial.v1.StageResult.
+ * Use `create(StageResultSchema)` to create a new message.
+ */
+export declare const StageResultSchema: GenMessage<StageResult>;
+/**
+ * PlanValidationIssue describes a problem found during plan or pipeline validation.
+ *
+ * @generated from message geospatial.v1.PlanValidationIssue
+ */
+export type PlanValidationIssue = Message<"geospatial.v1.PlanValidationIssue"> & {
+    /**
+     * Correlates to the originating node: PlanStep.step_id (ProcessService),
+     * PipelineStage.stage_id (PipelineService), or a server-chosen stage
+     * identifier (RenderService, BuilderService, DeploymentService).
+     *
+     * @generated from field: string node_id = 1;
+     */
+    nodeId: string;
+    /**
+     * @generated from field: string field = 2;
+     */
+    field: string;
+    /**
+     * @generated from field: string message = 3;
+     */
+    message: string;
+    /**
+     * @generated from field: geospatial.v1.Severity severity = 4;
+     */
+    severity: Severity;
+};
+/**
+ * Describes the message geospatial.v1.PlanValidationIssue.
+ * Use `create(PlanValidationIssueSchema)` to create a new message.
+ */
+export declare const PlanValidationIssueSchema: GenMessage<PlanValidationIssue>;
+/**
+ * Assumption records a decision or inference made during execution.
+ *
+ * @generated from message geospatial.v1.Assumption
+ */
+export type Assumption = Message<"geospatial.v1.Assumption"> & {
+    /**
+     * @generated from field: string assumption_id = 1;
+     */
+    assumptionId: string;
+    /**
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * @generated from field: string rationale = 3;
+     */
+    rationale: string;
+    /**
+     * @generated from field: bool user_confirmed = 4;
+     */
+    userConfirmed: boolean;
+};
+/**
+ * Describes the message geospatial.v1.Assumption.
+ * Use `create(AssumptionSchema)` to create a new message.
+ */
+export declare const AssumptionSchema: GenMessage<Assumption>;
+/**
+ * ProvenanceRecord captures the full execution lineage for a result.
+ *
+ * @generated from message geospatial.v1.ProvenanceRecord
+ */
+export type ProvenanceRecord = Message<"geospatial.v1.ProvenanceRecord"> & {
+    /**
+     * @generated from field: repeated string source_dataset_refs = 1;
+     */
+    sourceDatasetRefs: string[];
+    /**
+     * @generated from field: repeated string process_definition_refs = 2;
+     */
+    processDefinitionRefs: string[];
+    /**
+     * @generated from field: repeated geospatial.v1.Assumption assumptions = 3;
+     */
+    assumptions: Assumption[];
+    /**
+     * UTC milliseconds since epoch
+     *
+     * @generated from field: int64 executed_at = 4;
+     */
+    executedAt: bigint;
+    /**
+     * @generated from field: int64 duration_seconds = 5;
+     */
+    durationSeconds: bigint;
+};
+/**
+ * Describes the message geospatial.v1.ProvenanceRecord.
+ * Use `create(ProvenanceRecordSchema)` to create a new message.
+ */
+export declare const ProvenanceRecordSchema: GenMessage<ProvenanceRecord>;
+/**
+ * ParameterValue represents a typed parameter for step inputs and stage config.
+ * Scalar, list, and struct branches handle generic parameters. Typed branches
+ * for canonical geospatial messages let standard step and stage kinds reference
+ * protocol-owned types directly instead of requiring ad-hoc struct encoding.
+ *
+ * @generated from message geospatial.v1.ParameterValue
+ */
+export type ParameterValue = Message<"geospatial.v1.ParameterValue"> & {
+    /**
+     * @generated from oneof geospatial.v1.ParameterValue.kind
+     */
+    kind: {
+        /**
+         * @generated from field: string string_value = 1;
+         */
+        value: string;
+        case: "stringValue";
+    } | {
+        /**
+         * @generated from field: int64 int64_value = 2;
+         */
+        value: bigint;
+        case: "int64Value";
+    } | {
+        /**
+         * @generated from field: double double_value = 3;
+         */
+        value: number;
+        case: "doubleValue";
+    } | {
+        /**
+         * @generated from field: bool bool_value = 4;
+         */
+        value: boolean;
+        case: "boolValue";
+    } | {
+        /**
+         * @generated from field: bytes bytes_value = 5;
+         */
+        value: Uint8Array;
+        case: "bytesValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.ParameterList list_value = 6;
+         */
+        value: ParameterList;
+        case: "listValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.ParameterMap struct_value = 7;
+         */
+        value: ParameterMap;
+        case: "structValue";
+    } | {
+        /**
+         * Typed geospatial branches — reuse canonical protocol messages.
+         *
+         * @generated from field: geospatial.v1.SpatialFilter spatial_filter_value = 8;
+         */
+        value: SpatialFilter;
+        case: "spatialFilterValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.SpatialReference spatial_reference_value = 9;
+         */
+        value: SpatialReference;
+        case: "spatialReferenceValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.Geometry geometry_value = 10;
+         */
+        value: Geometry;
+        case: "geometryValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.Extent extent_value = 11;
+         */
+        value: Extent;
+        case: "extentValue";
+    } | {
+        /**
+         * @generated from field: geospatial.v1.StatisticDefinition statistic_value = 12;
+         */
+        value: StatisticDefinition;
+        case: "statisticValue";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message geospatial.v1.ParameterValue.
+ * Use `create(ParameterValueSchema)` to create a new message.
+ */
+export declare const ParameterValueSchema: GenMessage<ParameterValue>;
+/**
+ * ParameterList is an ordered sequence of parameter values.
+ *
+ * @generated from message geospatial.v1.ParameterList
+ */
+export type ParameterList = Message<"geospatial.v1.ParameterList"> & {
+    /**
+     * @generated from field: repeated geospatial.v1.ParameterValue values = 1;
+     */
+    values: ParameterValue[];
+};
+/**
+ * Describes the message geospatial.v1.ParameterList.
+ * Use `create(ParameterListSchema)` to create a new message.
+ */
+export declare const ParameterListSchema: GenMessage<ParameterList>;
+/**
+ * ParameterMap is a string-keyed structure of parameter values.
+ *
+ * @generated from message geospatial.v1.ParameterMap
+ */
+export type ParameterMap = Message<"geospatial.v1.ParameterMap"> & {
+    /**
+     * @generated from field: map<string, geospatial.v1.ParameterValue> fields = 1;
+     */
+    fields: {
+        [key: string]: ParameterValue;
+    };
+};
+/**
+ * Describes the message geospatial.v1.ParameterMap.
+ * Use `create(ParameterMapSchema)` to create a new message.
+ */
+export declare const ParameterMapSchema: GenMessage<ParameterMap>;
+/**
+ * ExecutionContext is the shared cross-cutting request context for the
+ * operator execution surface (Execute* RPCs on ProcessService,
+ * PipelineService, RenderService, BuilderService, and DeploymentService)
+ * and for the WorkspaceService and ArtifactService lifecycle surface,
+ * including their non-mutating read and list RPCs (for example
+ * OpenWorkspace, GetWorkspace, ListWorkspaces, GetQuotaUsage, GetArtifact,
+ * InspectArtifact, ListArtifacts, GetRetentionPolicy, and
+ * ListRetentionPolicies). The `workspace` handle carries the canonical
+ * WorkspaceRef for requests that need workspace context. When the enclosing
+ * request already provides a resource-scoped or filter-scoped WorkspaceRef,
+ * that handle is authoritative for routing, artifact scope, job state, and
+ * authorization. On list RPCs without an active workspace selector (for
+ * example ListWorkspacesRequest, ListRetentionPoliciesRequest, or
+ * ListArtifactsRequest when the workspace filter is unset),
+ * `ExecutionContext.workspace` is informational only; it does not implicitly
+ * narrow results, and servers evaluate caller scope from request metadata.
+ *
+ * Workspace identity precedence. When the enclosing request already carries
+ * a WorkspaceRef elsewhere — for example `ArtifactRef.workspace`,
+ * `ArtifactHeader.workspace`, `WorkspaceRef ref` on WorkspaceService
+ * requests, `DeploymentSpec.workspace`, or a list-request workspace filter
+ * such as `ListArtifactsRequest.workspace` when set — that resource-scoped
+ * or filter handle is authoritative. If `ExecutionContext.workspace` is
+ * also set, it MUST identify the same workspace (matching `workspace_id`
+ * at minimum; servers SHOULD reject mismatched `scope_token` or
+ * `workspace_revision`) and the server returns INVALID_ARGUMENT on
+ * mismatch. Callers that already carry workspace identity on the resource
+ * or filter handle MAY leave `ExecutionContext.workspace` unset.
+ *
+ * Field 1 (workspace_id) is the legacy string handle retained for wire and
+ * JSON compatibility. It is deprecated in favor of the typed `workspace`
+ * handle on field 4; when both are populated they MUST identify the same
+ * workspace and the typed field is authoritative. Producers should populate
+ * only the typed field on new writes.
+ *
+ * @generated from message geospatial.v1.ExecutionContext
+ */
+export type ExecutionContext = Message<"geospatial.v1.ExecutionContext"> & {
+    /**
+     * Deprecated since v1: use `workspace` (field 4) instead. Legacy workspace
+     * id retained for wire and JSON compatibility. Removal target: v2.
+     *
+     * @generated from field: string workspace_id = 1 [deprecated = true];
+     * @deprecated
+     */
+    workspaceId: string;
+    /**
+     * @generated from field: int64 timeout_seconds = 2;
+     */
+    timeoutSeconds: bigint;
+    /**
+     * @generated from field: map<string, string> metadata = 3;
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Canonical typed workspace handle for this request. Authoritative over
+     * the deprecated `workspace_id` string.
+     *
+     * @generated from field: geospatial.v1.WorkspaceRef workspace = 4;
+     */
+    workspace?: WorkspaceRef | undefined;
+};
+/**
+ * Describes the message geospatial.v1.ExecutionContext.
+ * Use `create(ExecutionContextSchema)` to create a new message.
+ */
+export declare const ExecutionContextSchema: GenMessage<ExecutionContext>;
+/**
+ * ValidateResponse is the shared response for Validate* RPCs across the five
+ * operator services. Servers always return gRPC status OK; plan or spec issues
+ * are conveyed in the issues list with valid=false.
+ *
+ * @generated from message geospatial.v1.ValidateResponse
+ */
+export type ValidateResponse = Message<"geospatial.v1.ValidateResponse"> & {
+    /**
+     * @generated from field: bool valid = 1;
+     */
+    valid: boolean;
+    /**
+     * @generated from field: repeated geospatial.v1.PlanValidationIssue issues = 2;
+     */
+    issues: PlanValidationIssue[];
+};
+/**
+ * Describes the message geospatial.v1.ValidateResponse.
+ * Use `create(ValidateResponseSchema)` to create a new message.
+ */
+export declare const ValidateResponseSchema: GenMessage<ValidateResponse>;
+/**
+ * DryRunResponse is the shared response for DryRun* RPCs across the five
+ * operator services. Servers always return gRPC status OK; plan or spec issues
+ * are conveyed in issues with valid=false; result is populated on success.
+ *
+ * @generated from message geospatial.v1.DryRunResponse
+ */
+export type DryRunResponse = Message<"geospatial.v1.DryRunResponse"> & {
+    /**
+     * @generated from field: bool valid = 1;
+     */
+    valid: boolean;
+    /**
+     * @generated from field: repeated geospatial.v1.PlanValidationIssue issues = 2;
+     */
+    issues: PlanValidationIssue[];
+    /**
+     * @generated from field: geospatial.v1.DryRunResult result = 3;
+     */
+    result?: DryRunResult | undefined;
+};
+/**
+ * Describes the message geospatial.v1.DryRunResponse.
+ * Use `create(DryRunResponseSchema)` to create a new message.
+ */
+export declare const DryRunResponseSchema: GenMessage<DryRunResponse>;
+/**
+ * SubmitJobResponse is the shared response for Submit*Job RPCs across the five
+ * operator services and SpecService. Confirms submission and returns the job
+ * identifier and initial state.
+ *
+ * @generated from message geospatial.v1.SubmitJobResponse
+ */
+export type SubmitJobResponse = Message<"geospatial.v1.SubmitJobResponse"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: geospatial.v1.JobState state = 2;
+     */
+    state: JobState;
+};
+/**
+ * Describes the message geospatial.v1.SubmitJobResponse.
+ * Use `create(SubmitJobResponseSchema)` to create a new message.
+ */
+export declare const SubmitJobResponseSchema: GenMessage<SubmitJobResponse>;
+/**
+ * GetJobRequest is the shared request for Get*Job RPCs across the five
+ * operator services. Retrieves the current state and progress of a submitted
+ * job.
+ *
+ * @generated from message geospatial.v1.GetJobRequest
+ */
+export type GetJobRequest = Message<"geospatial.v1.GetJobRequest"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+};
+/**
+ * Describes the message geospatial.v1.GetJobRequest.
+ * Use `create(GetJobRequestSchema)` to create a new message.
+ */
+export declare const GetJobRequestSchema: GenMessage<GetJobRequest>;
+/**
+ * GetJobResponse is the shared response for Get*Job RPCs across the five
+ * operator services. Returns the job state and current progress.
+ *
+ * @generated from message geospatial.v1.GetJobResponse
+ */
+export type GetJobResponse = Message<"geospatial.v1.GetJobResponse"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: geospatial.v1.JobState state = 2;
+     */
+    state: JobState;
+    /**
+     * @generated from field: geospatial.v1.JobProgress progress = 3;
+     */
+    progress?: JobProgress | undefined;
+};
+/**
+ * Describes the message geospatial.v1.GetJobResponse.
+ * Use `create(GetJobResponseSchema)` to create a new message.
+ */
+export declare const GetJobResponseSchema: GenMessage<GetJobResponse>;
+/**
+ * GetJobResultRequest is the shared request for Get*JobResult RPCs across the
+ * five operator services. Retrieves the results of a completed job.
+ *
+ * @generated from message geospatial.v1.GetJobResultRequest
+ */
+export type GetJobResultRequest = Message<"geospatial.v1.GetJobResultRequest"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+};
+/**
+ * Describes the message geospatial.v1.GetJobResultRequest.
+ * Use `create(GetJobResultRequestSchema)` to create a new message.
+ */
+export declare const GetJobResultRequestSchema: GenMessage<GetJobResultRequest>;
+/**
+ * CancelJobRequest is the shared request for Cancel*Job RPCs across the five
+ * operator services and SpecService. Requests cooperative cancellation of a
+ * running or pending job.
+ *
+ * @generated from message geospatial.v1.CancelJobRequest
+ */
+export type CancelJobRequest = Message<"geospatial.v1.CancelJobRequest"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+};
+/**
+ * Describes the message geospatial.v1.CancelJobRequest.
+ * Use `create(CancelJobRequestSchema)` to create a new message.
+ */
+export declare const CancelJobRequestSchema: GenMessage<CancelJobRequest>;
+/**
+ * CancelJobResponse is the shared response for Cancel*Job RPCs across the five
+ * operator services and SpecService. Confirms the cancellation outcome.
+ *
+ * @generated from message geospatial.v1.CancelJobResponse
+ */
+export type CancelJobResponse = Message<"geospatial.v1.CancelJobResponse"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: geospatial.v1.JobState state = 2;
+     */
+    state: JobState;
+};
+/**
+ * Describes the message geospatial.v1.CancelJobResponse.
+ * Use `create(CancelJobResponseSchema)` to create a new message.
+ */
+export declare const CancelJobResponseSchema: GenMessage<CancelJobResponse>;
+/**
+ * WorkflowFamily identifies the category of operator workflow.
+ * Values are scoped to families with a defined owning service in this package.
+ *
+ * @generated from enum geospatial.v1.WorkflowFamily
+ */
+export declare enum WorkflowFamily {
+    /**
+     * @generated from enum value: WORKFLOW_FAMILY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: WORKFLOW_FAMILY_ANALYZE = 1;
+     */
+    ANALYZE = 1,
+    /**
+     * @generated from enum value: WORKFLOW_FAMILY_PUBLISH = 2;
+     */
+    PUBLISH = 2,
+    /**
+     * @generated from enum value: WORKFLOW_FAMILY_BUILD = 3;
+     */
+    BUILD = 3,
+    /**
+     * @generated from enum value: WORKFLOW_FAMILY_DEPLOY = 4;
+     */
+    DEPLOY = 4
+}
+/**
+ * Describes the enum geospatial.v1.WorkflowFamily.
+ */
+export declare const WorkflowFamilySchema: GenEnum<WorkflowFamily>;
+/**
+ * JobState represents the lifecycle state of an execution job.
+ *
+ * @generated from enum geospatial.v1.JobState
+ */
+export declare enum JobState {
+    /**
+     * @generated from enum value: JOB_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: JOB_STATE_DRAFT = 1;
+     */
+    DRAFT = 1,
+    /**
+     * @generated from enum value: JOB_STATE_AWAITING_CLARIFICATION = 2;
+     */
+    AWAITING_CLARIFICATION = 2,
+    /**
+     * @generated from enum value: JOB_STATE_VALIDATED = 3;
+     */
+    VALIDATED = 3,
+    /**
+     * @generated from enum value: JOB_STATE_AWAITING_APPROVAL = 4;
+     */
+    AWAITING_APPROVAL = 4,
+    /**
+     * @generated from enum value: JOB_STATE_RUNNING = 5;
+     */
+    RUNNING = 5,
+    /**
+     * @generated from enum value: JOB_STATE_COMPLETED = 6;
+     */
+    COMPLETED = 6,
+    /**
+     * @generated from enum value: JOB_STATE_FAILED = 7;
+     */
+    FAILED = 7,
+    /**
+     * @generated from enum value: JOB_STATE_CANCELLED = 8;
+     */
+    CANCELLED = 8
+}
+/**
+ * Describes the enum geospatial.v1.JobState.
+ */
+export declare const JobStateSchema: GenEnum<JobState>;
+/**
+ * StageState represents the state of an individual execution stage.
+ *
+ * @generated from enum geospatial.v1.StageState
+ */
+export declare enum StageState {
+    /**
+     * @generated from enum value: STAGE_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: STAGE_STATE_PENDING = 1;
+     */
+    PENDING = 1,
+    /**
+     * @generated from enum value: STAGE_STATE_RUNNING = 2;
+     */
+    RUNNING = 2,
+    /**
+     * @generated from enum value: STAGE_STATE_COMPLETED = 3;
+     */
+    COMPLETED = 3,
+    /**
+     * @generated from enum value: STAGE_STATE_NEEDS_USER_INPUT = 4;
+     */
+    NEEDS_USER_INPUT = 4,
+    /**
+     * @generated from enum value: STAGE_STATE_BLOCKED = 5;
+     */
+    BLOCKED = 5,
+    /**
+     * @generated from enum value: STAGE_STATE_FAILED = 6;
+     */
+    FAILED = 6,
+    /**
+     * @generated from enum value: STAGE_STATE_SKIPPED = 7;
+     */
+    SKIPPED = 7,
+    /**
+     * @generated from enum value: STAGE_STATE_CANCELLED = 8;
+     */
+    CANCELLED = 8
+}
+/**
+ * Describes the enum geospatial.v1.StageState.
+ */
+export declare const StageStateSchema: GenEnum<StageState>;
+/**
+ * ErrorCategory classifies the domain of an execution error.
+ *
+ * @generated from enum geospatial.v1.ErrorCategory
+ */
+export declare enum ErrorCategory {
+    /**
+     * @generated from enum value: ERROR_CATEGORY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_VALIDATION = 1;
+     */
+    VALIDATION = 1,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_AUTHORIZATION = 2;
+     */
+    AUTHORIZATION = 2,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_POLICY = 3;
+     */
+    POLICY = 3,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_EXECUTION = 4;
+     */
+    EXECUTION = 4,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_ARTIFACT = 5;
+     */
+    ARTIFACT = 5,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_PACKAGING = 6;
+     */
+    PACKAGING = 6,
+    /**
+     * @generated from enum value: ERROR_CATEGORY_DEPLOYMENT = 7;
+     */
+    DEPLOYMENT = 7
+}
+/**
+ * Describes the enum geospatial.v1.ErrorCategory.
+ */
+export declare const ErrorCategorySchema: GenEnum<ErrorCategory>;
+/**
+ * Retryability classifies how a failed operation may be retried.
+ *
+ * @generated from enum geospatial.v1.Retryability
+ */
+export declare enum Retryability {
+    /**
+     * @generated from enum value: RETRYABILITY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: RETRYABILITY_FIX_PLAN_AND_RETRY = 1;
+     */
+    FIX_PLAN_AND_RETRY = 1,
+    /**
+     * @generated from enum value: RETRYABILITY_FIX_DATA_AND_RETRY = 2;
+     */
+    FIX_DATA_AND_RETRY = 2,
+    /**
+     * @generated from enum value: RETRYABILITY_INSUFFICIENT_QUOTA = 3;
+     */
+    INSUFFICIENT_QUOTA = 3,
+    /**
+     * @generated from enum value: RETRYABILITY_TRANSIENT_BACKEND_ERROR = 4;
+     */
+    TRANSIENT_BACKEND_ERROR = 4,
+    /**
+     * @generated from enum value: RETRYABILITY_PERMANENT_FAILURE = 5;
+     */
+    PERMANENT_FAILURE = 5
+}
+/**
+ * Describes the enum geospatial.v1.Retryability.
+ */
+export declare const RetryabilitySchema: GenEnum<Retryability>;
+/**
+ * ArtifactClass identifies the type of an execution artifact.
+ *
+ * @generated from enum geospatial.v1.ArtifactClass
+ */
+export declare enum ArtifactClass {
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_SCALAR = 1;
+     */
+    SCALAR = 1,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_FEATURE_LAYER = 2;
+     */
+    FEATURE_LAYER = 2,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_TABLE = 3;
+     */
+    TABLE = 3,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_RASTER = 4;
+     */
+    RASTER = 4,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_FILE = 5;
+     */
+    FILE = 5,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_REPORT = 6;
+     */
+    REPORT = 6,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_MAP = 7;
+     */
+    MAP = 7,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_APP_BUNDLE = 8;
+     */
+    APP_BUNDLE = 8,
+    /**
+     * @generated from enum value: ARTIFACT_CLASS_SERVICE_DEFINITION = 9;
+     */
+    SERVICE_DEFINITION = 9
+}
+/**
+ * Describes the enum geospatial.v1.ArtifactClass.
+ */
+export declare const ArtifactClassSchema: GenEnum<ArtifactClass>;
+//# sourceMappingURL=execution_types_pb.d.ts.map