@honua/app-platform 0.2.5 → 0.2.7

package/control-plane/dataset-import/index.d.ts

@@ -1,6 +1,7 @@
 export { hashDatasetImportFile } from "./file-hash.js";
 export type { DatasetImportFileHashOptions } from "./file-hash.js";
-export type { CreateDatasetImportTask, DatasetImportArtifactSource, DatasetImportAuthorityDescriptor, DatasetImportAuthorityRenewal, DatasetImportDestination, DatasetImportSource, DatasetImportTask, DatasetImportTaskOptions, DatasetImportTaskReference, RenewDatasetImportAuthority, } from "./types.js";
+export type { CreateDatasetImportTask, DatasetImportArtifactSource, DatasetImportAuthorityDescriptor, DatasetImportAuthorityRenewal, DatasetImportBrowserFileSource, DatasetImportDestination, DatasetImportLocalProcessSource, DatasetImportServerJobArtifactReference, DatasetImportServerJobArtifactSource, DatasetImportServerJobSource, DatasetImportSource, DatasetImportTask, DatasetImportTaskOptions, DatasetImportTaskReference, RenewDatasetImportAuthority, DescribeServerJobImportSource, ListServerJobImportSources, ServerJobImportSourceChoice, ServerJobImportSourcePage, } from "./types.js";
+export { DatasetImportServerJobSourceClient } from "./server-job-source-client.js";
 export { DatasetImportTaskApiError, DatasetImportTaskClient, } from "./client.js";
 export type { DatasetImportTaskClientOptions } from "./client.js";
 export { DatasetImportUploadClient } from "./upload-client.js";

package/control-plane/dataset-import/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,uCAAuC,EACvC,oCAAoC,EACpC,4BAA4B,EAC5B,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/control-plane/dataset-import/index.js

@@ -1,4 +1,5 @@
 export { hashDatasetImportFile } from "./file-hash.js";
+export { DatasetImportServerJobSourceClient } from "./server-job-source-client.js";
 export { DatasetImportTaskApiError, DatasetImportTaskClient, } from "./client.js";
 export { DatasetImportUploadClient } from "./upload-client.js";
 export { DatasetImportSubmissionClient } from "./submission-client.js";

package/control-plane/dataset-import/server-job-source-client.d.ts

@@ -0,0 +1,16 @@
+import type { DatasetImportTaskClientOptions } from "./client.js";
+import type { DatasetImportServerJobSource, DescribeServerJobImportSource, ListServerJobImportSources, ServerJobImportSourcePage } from "./types.js";
+/**
+ * Optional preview Server-job source APIs. Requires an installed Server that
+ * advertises these capabilities. Discovery is metadata-only; describe verifies
+ * the original output without returning its bytes or storage location. Server
+ * authorization remains authoritative on every observation and transfer.
+ */
+export declare class DatasetImportServerJobSourceClient {
+    private readonly transport;
+    private readonly targetId;
+    constructor(options: DatasetImportTaskClientOptions);
+    list(request: ListServerJobImportSources, signal?: AbortSignal): Promise<ServerJobImportSourcePage | null>;
+    describe(request: DescribeServerJobImportSource, signal?: AbortSignal): Promise<DatasetImportServerJobSource | null>;
+}
+//# sourceMappingURL=server-job-source-client.d.ts.map

package/control-plane/dataset-import/server-job-source-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-job-source-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/server-job-source-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,8BAA8B;IAK7C,IAAI,CAAC,OAAO,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IA2D1G,QAAQ,CACZ,OAAO,EAAE,6BAA6B,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;CA4DhD"}

package/control-plane/dataset-import/server-job-source-client.js

@@ -0,0 +1,143 @@
+import { DatasetImportWorkspaceTransport, validId } from "./transport.js";
+/**
+ * Optional preview Server-job source APIs. Requires an installed Server that
+ * advertises these capabilities. Discovery is metadata-only; describe verifies
+ * the original output without returning its bytes or storage location. Server
+ * authorization remains authoritative on every observation and transfer.
+ */
+export class DatasetImportServerJobSourceClient {
+    transport;
+    targetId;
+    constructor(options) {
+        this.transport = new DatasetImportWorkspaceTransport(options);
+        this.targetId = options.targetId;
+    }
+    async list(request, signal) {
+        const { jobId, offset = 0, resultPackageId = null } = request;
+        validId(jobId);
+        if (!Number.isSafeInteger(offset) || offset < 0 || (offset > 0 && resultPackageId === null))
+            throw new TypeError("Continuation requires a nonnegative offset and the original result package.");
+        if (resultPackageId !== null)
+            validPackage(jobId, resultPackageId);
+        const value = await this.transport.request("/dataset-import-sources/server-job-artifacts", "POST", JSON.stringify({ jobId, offset, resultPackageId }), signal, true);
+        if (value === null)
+            return null;
+        if (value.targetId !== this.targetId || value.jobId !== jobId)
+            throw new Error("The job source page changed deployment or job identity.");
+        validPackage(jobId, value.resultPackageId);
+        if (resultPackageId !== null && value.resultPackageId !== resultPackageId)
+            throw new Error("The job source page changed the original result version.");
+        // AgentWorkspaceJsonContext omits null members on the wire.
+        const nextOffset = value.nextOffset ?? null;
+        if (!Number.isSafeInteger(value.totalArtifacts) ||
+            value.totalArtifacts < offset ||
+            !Array.isArray(value.artifacts) ||
+            value.artifacts.length !== Math.min(50, value.totalArtifacts - offset) ||
+            nextOffset !== (offset + value.artifacts.length < value.totalArtifacts ? offset + value.artifacts.length : null))
+            throw new Error("The job source page has an inconsistent bounded continuation.");
+        const artifacts = value.artifacts.map((choice, index) => {
+            if (!choice ||
+                choice.artifactId !== `${jobId}:artifact:${offset + index + 1}` ||
+                typeof choice.kind !== "string" ||
+                !/^[A-Za-z][A-Za-z0-9]{0,63}$/.test(choice.kind) ||
+                typeof choice.label !== "string" ||
+                !/^[A-Za-z0-9 _.\-]{1,128}$/.test(choice.label) ||
+                typeof choice.canDescribeForImport !== "boolean")
+                throw new Error("The job source page contains an invalid artifact identity or metadata.");
+            return {
+                artifactId: choice.artifactId,
+                kind: choice.kind,
+                label: choice.label,
+                canDescribeForImport: choice.canDescribeForImport,
+            };
+        });
+        // Project only the supported metadata: never propagate unexpected bulk or
+        // storage-location members to an agent through a loosely typed JSON object.
+        return {
+            targetId: value.targetId,
+            jobId,
+            resultPackageId: value.resultPackageId,
+            artifacts,
+            totalArtifacts: value.totalArtifacts,
+            nextOffset,
+        };
+    }
+    async describe(request, signal) {
+        const { jobId, resultPackageId, artifactId } = request;
+        validId(jobId);
+        validPackage(jobId, resultPackageId);
+        validArtifact(jobId, artifactId);
+        const source = await this.transport.request("/dataset-import-sources/server-job-artifact", "POST", JSON.stringify({ jobId, resultPackageId, artifactId }), signal, true);
+        if (source === null)
+            return null;
+        const output = source.serverJobArtifact;
+        const reference = output?.reference;
+        if (source.kind !== "server-job-artifact" ||
+            source.fileName !== "job-artifact.geojson" ||
+            !positiveInteger(source.totalBytes) ||
+            !digest(source.expectedSha256) ||
+            source.artifact != null ||
+            source.browserSelectionId != null ||
+            !reference ||
+            reference.targetId !== this.targetId ||
+            reference.jobId !== jobId ||
+            reference.resultPackageId !== resultPackageId ||
+            reference.artifactId !== artifactId ||
+            !digest(reference.referenceSha256) ||
+            !positiveInteger(output.featureCount) ||
+            (output.crsState === "known"
+                ? !positiveInteger(output.sourceSrid) || output.sourceSrid > 2147483647
+                : output.crsState !== "unknown" || output.sourceSrid != null))
+            throw new Error("The job source description changed its original identity or content/coordinate contract.");
+        if (!principalText(output.producerActorId, 2048) ||
+            (output.producerTenantId != null && !principalText(output.producerTenantId, 512, true)))
+            throw new Error("The job source producer identity is outside the Server contract.");
+        return {
+            kind: "server-job-artifact",
+            fileName: source.fileName,
+            totalBytes: source.totalBytes,
+            expectedSha256: source.expectedSha256,
+            serverJobArtifact: {
+                reference: {
+                    targetId: this.targetId,
+                    jobId,
+                    resultPackageId,
+                    artifactId,
+                    referenceSha256: reference.referenceSha256,
+                },
+                producerActorId: output.producerActorId,
+                producerTenantId: output.producerTenantId ?? null,
+                crsState: output.crsState,
+                sourceSrid: output.sourceSrid ?? null,
+                featureCount: output.featureCount,
+            },
+        };
+    }
+}
+function validPackage(jobId, value) {
+    validId(value);
+    if (!value.startsWith(`${jobId}:v`) || !/^[1-9][0-9]*$/.test(value.slice(jobId.length + 2)))
+        throw new TypeError("The original versioned job result package is required.");
+}
+function validArtifact(jobId, value) {
+    validId(value);
+    const prefix = `${jobId}:artifact:`;
+    if (!value.startsWith(prefix) || !/^[1-9][0-9]*$/.test(value.slice(prefix.length)))
+        throw new TypeError("The original job artifact identity is required.");
+}
+function positiveInteger(value) {
+    return Number.isSafeInteger(value) && value > 0;
+}
+function digest(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+}
+// Principal identifiers have different Server bounds from workspace/job IDs.
+function principalText(value, maximum, allowEmpty = false) {
+    return (typeof value === "string" &&
+        (allowEmpty || value.length > 0) &&
+        value.length <= maximum &&
+        Array.from(value).every((character) => {
+            const code = character.charCodeAt(0);
+            return code > 31 && (code < 127 || code > 159);
+        }));
+}

package/control-plane/dataset-import/types.d.ts

@@ -10,14 +10,75 @@ export interface DatasetImportArtifactSource {
     readonly runId: string;
     readonly path: string;
 }
-export interface DatasetImportSource {
-    readonly kind: "browser-file" | "local-process-artifact";
+interface DatasetImportSourceMetadata {
     readonly fileName: string;
     readonly totalBytes: number;
     readonly expectedSha256?: string | null;
-    readonly artifact?: DatasetImportArtifactSource | null;
+}
+export interface DatasetImportBrowserFileSource extends DatasetImportSourceMetadata {
+    readonly kind: "browser-file";
     /** Original human file selection captured by the immutable originating turn. */
     readonly browserSelectionId?: string | null;
+    readonly artifact?: null;
+    readonly serverJobArtifact?: null;
+}
+export interface DatasetImportLocalProcessSource extends DatasetImportSourceMetadata {
+    readonly kind: "local-process-artifact";
+    readonly artifact: DatasetImportArtifactSource;
+    readonly browserSelectionId?: null;
+    readonly serverJobArtifact?: null;
+}
+/** Each source kind carries its own canonical reference rather than optional mixed identities. */
+export type DatasetImportSource = DatasetImportBrowserFileSource | DatasetImportLocalProcessSource | DatasetImportServerJobSource;
+/** Exact Server-owned result identity; no caller-supplied location or bulk content. */
+export interface DatasetImportServerJobArtifactReference {
+    readonly targetId: string;
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifactId: string;
+    readonly referenceSha256: string;
+}
+/** Server recomputes this description at task creation; it is not execution authority. */
+export interface DatasetImportServerJobArtifactSource {
+    readonly reference: DatasetImportServerJobArtifactReference;
+    readonly producerActorId: string;
+    readonly producerTenantId: string | null;
+    readonly crsState: "known" | "unknown";
+    readonly sourceSrid: number | null;
+    readonly featureCount: number;
+}
+export interface DatasetImportServerJobSource extends DatasetImportSourceMetadata {
+    readonly kind: "server-job-artifact";
+    readonly expectedSha256: string;
+    readonly serverJobArtifact: DatasetImportServerJobArtifactSource;
+    readonly artifact?: null;
+    readonly browserSelectionId?: null;
+}
+export interface ListServerJobImportSources {
+    readonly jobId: string;
+    readonly offset?: number;
+    /** Required for continuation, preserving the exact original result version. */
+    readonly resultPackageId?: string | null;
+}
+export interface DescribeServerJobImportSource {
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifactId: string;
+}
+export interface ServerJobImportSourceChoice {
+    readonly artifactId: string;
+    readonly kind: string;
+    readonly label: string;
+    /** Envelope eligibility only; describe still verifies content, CRS and current access. */
+    readonly canDescribeForImport: boolean;
+}
+export interface ServerJobImportSourcePage {
+    readonly targetId: string;
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifacts: readonly ServerJobImportSourceChoice[];
+    readonly totalArtifacts: number;
+    readonly nextOffset: number | null;
 }
 export interface DatasetImportTaskOptions {
     /** Current new-table slice supports Append (1); occupied destinations remain unsupported. */
@@ -147,4 +208,5 @@ export interface DatasetImportSubmissionReceipt {
     readonly acceptBefore?: string | null;
     readonly job?: DatasetImportJobReceipt | null;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/control-plane/dataset-import/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/types.ts"],"names":[],"mappings":"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"}

package/control-plane/dataset-import/upload-client.d.ts

@@ -14,6 +14,13 @@ export declare class DatasetImportUploadClient {
     /** Read-only recovery of a known session, preserving its immutable fields and terminal receipts. */
     reconcile(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt | null>;
     create(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
+    /**
+     * Transfer the original task's Server-owned job output through the canonical
+     * upload coordinator and retain it. This does not submit an import. A lost
+     * reply remains unknown: recover with read/reconcile before explicitly resuming
+     * this same task. Never create a replacement task or automatically retry.
+     */
+    transferServerJobArtifact(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     appendChunk(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, chunk: Blob, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     seal(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     retainSource(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;

package/control-plane/dataset-import/upload-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/upload-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAChD,OAAO,EAAE,8BAA8B;IAI7C,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAqB5C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAanH,oGAAoG;IAC9F,SAAS,CACb,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAcvC,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxG,WAAW,CACf,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAqBhC,IAAI,CACR,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,MAAM,CACV,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;YAaxB,MAAM;CAmBrB"}
+{"version":3,"file":"upload-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/upload-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAChD,OAAO,EAAE,8BAA8B;IAI7C,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAqB5C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAanH,oGAAoG;IAC9F,SAAS,CACb,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAcvC,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQ9G;;;;;OAKG;IACG,yBAAyB,CAC7B,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAchC,WAAW,CACf,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAqBhC,IAAI,CACR,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,MAAM,CACV,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;YAaxB,MAAM;CAmBrB"}

package/control-plane/dataset-import/upload-client.js

@@ -48,6 +48,20 @@ export class DatasetImportUploadClient {
         validate(value, pinned);
         return value;
     }
+    /**
+     * Transfer the original task's Server-owned job output through the canonical
+     * upload coordinator and retain it. This does not submit an import. A lost
+     * reply remains unknown: recover with read/reconcile before explicitly resuming
+     * this same task. Never create a replacement task or automatically retry.
+     */
+    async transferServerJobArtifact(reference, signal) {
+        const pinned = pin(reference);
+        const value = await this.transport.request(`${path(pinned)}/server-job-artifact`, "POST", JSON.stringify({ taskContentHash: pinned.contentHash }), signal);
+        validate(value, pinned);
+        if (value.state !== "sealed" || value.sourceRetention == null)
+            throw new Error("The Server job transfer did not return a sealed retained source receipt.");
+        return value;
+    }
     async appendChunk(reference, original, chunk, signal) {
         const pinned = pin(reference);
         const session = captureSession(original, pinned);

package/core/error-envelope.js

@@ -345,6 +345,7 @@ const SAFE_ERROR_NAMES = new Set([
     "HonuaReplicaSyncError",
     "HonuaRuntimeDiagnosticError",
     "HonuaSdkError",
+    "HonuaStacConformanceError",
     "HonuaTemporalPlaybackError",
     "HonuaTimeoutError",
     "HonuaWfsExceptionError",

package/core/stac-conformance.d.ts

@@ -0,0 +1,66 @@
+/**
+ * STAC API conformance classes this client actually uses.
+ *
+ * Predicates match the canonical URIs (and the historical `ogcapi-features`
+ * fragment aliases) exactly. A fragment class such as Item Search Filter does
+ * not count as Item Search itself. The legacy Query extension is recognized
+ * here and is not serialized: `StacSearchRequest` has no `query` parameter,
+ * and `Source.query` compiles attribute filters to CQL2.
+ *
+ * @module
+ */
+import { type HonuaErrorOptions, HonuaSdkError } from "./error-envelope.js";
+import type { StacSearchRequest } from "./types.js";
+/** Canonical conformance URI for each extension this client gates. */
+export declare const STAC_CONFORMANCE_CLASS: Readonly<{
+    readonly core: "https://api.stacspec.org/v1.0.0/core";
+    readonly "item-search": "https://api.stacspec.org/v1.0.0/item-search";
+    readonly filter: "https://api.stacspec.org/v1.0.0/item-search#filter";
+    readonly "cql2-text": "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text";
+    readonly "cql2-json": "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json";
+    readonly sort: "https://api.stacspec.org/v1.0.0/item-search#sort";
+    readonly fields: "https://api.stacspec.org/v1.0.0/item-search#fields";
+    /** Predicate only. This client does not emit the legacy Query extension. */
+    readonly query: "https://api.stacspec.org/v1.0.0/item-search#query";
+}>;
+export type StacConformanceKind = keyof typeof STAC_CONFORMANCE_CLASS;
+export interface HonuaStacConformanceErrorOptions extends HonuaErrorOptions {
+    /**
+     * The search used an extension before any `conformsTo` list was read.
+     * Distinct from a landing page that was read and does not declare the class.
+     */
+    readonly unread?: boolean;
+}
+/**
+ * A STAC search asked for an extension the catalog does not declare, or the
+ * client was about to emit that extension without having read `conformsTo`.
+ *
+ * `conformanceClass` is the first missing class. `missing` lists every class
+ * the request needed and the catalog did not declare, in requirement order.
+ * The registered code stays `core.capability-not-supported`.
+ */
+export declare class HonuaStacConformanceError extends HonuaSdkError {
+    readonly conformanceClass: string;
+    readonly missing: readonly string[];
+    readonly unread: boolean;
+    constructor(missing: readonly string[], options?: HonuaStacConformanceErrorOptions);
+}
+/** Copy string entries from a landing-page `conformsTo` array. Omitted becomes `[]` (read, nothing declared). */
+export declare function normalizeStacConformsTo(value: readonly string[] | undefined): readonly string[];
+/** True when `conformsTo` contains the canonical class for `kind`. */
+export declare function hasStacConformance(conformsTo: readonly string[] | undefined, kind: StacConformanceKind): boolean;
+/**
+ * Extension classes a search will put on the wire. Core Item Search parameters
+ * (`bbox`, `datetime`, `intersects`, `ids`, `collections`, `limit`, paging)
+ * are not gated. An extension property counts as soon as it is set, including
+ * an empty `fields` or `sortby`, because POST emits those members as-is.
+ * Opaque `nextParams` / `nextBody` continuations are not inspected.
+ */
+export declare function stacSearchExtensionRequirements(request: StacSearchRequest): readonly StacConformanceKind[];
+/**
+ * Refuse an extension search that has not been checked against `conformsTo`.
+ * `conformsTo === undefined` means the list was never read and fails before
+ * any HTTP request. `conformsTo: []` means it was read and the classes are absent.
+ */
+export declare function gateStacSearchExtensions(request: StacSearchRequest): void;
+//# sourceMappingURL=stac-conformance.d.ts.map

package/core/stac-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stac-conformance.d.ts","sourceRoot":"","sources":["../../../src/core/stac-conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOpD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB;;;;;;;;IAQjC,4EAA4E;;EAEnE,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAUtE,MAAM,WAAW,gCAAiC,SAAQ,iBAAiB;IACzE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,aAAa;IAC1D,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,SAAgB,MAAM,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,gCAAqC;CAoB9F;AAED,iHAAiH;AACjH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAG/F;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAMhH;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,mBAAmB,EAAE,CAmB1G;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAQzE"}

package/core/stac-conformance.js

@@ -0,0 +1,177 @@
+/**
+ * STAC API conformance classes this client actually uses.
+ *
+ * Predicates match the canonical URIs (and the historical `ogcapi-features`
+ * fragment aliases) exactly. A fragment class such as Item Search Filter does
+ * not count as Item Search itself. The legacy Query extension is recognized
+ * here and is not serialized: `StacSearchRequest` has no `query` parameter,
+ * and `Source.query` compiles attribute filters to CQL2.
+ *
+ * @module
+ */
+import { HonuaSdkError, mergeHonuaErrorContext } from "./error-envelope.js";
+const STAC_SPEC_ORIGIN = "https://api.stacspec.org";
+const ITEM_SEARCH_PATH = "/v1.0.0/item-search";
+const ITEM_SEARCH_URI = `${STAC_SPEC_ORIGIN}${ITEM_SEARCH_PATH}`;
+const CQL2_CONFORMANCE_URI = "http://www.opengis.net/spec/cql2/1.0/conf/";
+/** Canonical conformance URI for each extension this client gates. */
+export const STAC_CONFORMANCE_CLASS = Object.freeze({
+    core: `${STAC_SPEC_ORIGIN}/v1.0.0/core`,
+    "item-search": ITEM_SEARCH_URI,
+    filter: `${ITEM_SEARCH_URI}#filter`,
+    "cql2-text": `${CQL2_CONFORMANCE_URI}cql2-text`,
+    "cql2-json": `${CQL2_CONFORMANCE_URI}cql2-json`,
+    sort: `${ITEM_SEARCH_URI}#sort`,
+    fields: `${ITEM_SEARCH_URI}#fields`,
+    /** Predicate only. This client does not emit the legacy Query extension. */
+    query: `${ITEM_SEARCH_URI}#query`,
+});
+const OGC_FEATURES_PATH = "/v1.0.0/ogcapi-features";
+const EXTENSION_FRAGMENT = {
+    filter: "#filter",
+    sort: "#sort",
+    fields: "#fields",
+    query: "#query",
+};
+/**
+ * A STAC search asked for an extension the catalog does not declare, or the
+ * client was about to emit that extension without having read `conformsTo`.
+ *
+ * `conformanceClass` is the first missing class. `missing` lists every class
+ * the request needed and the catalog did not declare, in requirement order.
+ * The registered code stays `core.capability-not-supported`.
+ */
+export class HonuaStacConformanceError extends HonuaSdkError {
+    conformanceClass;
+    missing;
+    unread;
+    constructor(missing, options = {}) {
+        const { unread = false, ...rest } = options;
+        const conformanceClass = missing[0] ?? STAC_CONFORMANCE_CLASS["item-search"];
+        const named = missing.map((uri) => `"${uri}"`).join(", ");
+        const message = unread
+            ? `STAC search uses conformance class ${named} but the catalog conformsTo list was not read.`
+            : `STAC catalog does not declare conformance class ${named}.`;
+        super("core.capability-not-supported", message, {
+            ...rest,
+            context: mergeHonuaErrorContext(rest.context, {
+                conformanceClass,
+                missing: [...missing],
+                unread,
+            }),
+        });
+        this.name = "HonuaStacConformanceError";
+        this.conformanceClass = conformanceClass;
+        this.missing = Object.freeze([...missing]);
+        this.unread = unread;
+    }
+}
+/** Copy string entries from a landing-page `conformsTo` array. Omitted becomes `[]` (read, nothing declared). */
+export function normalizeStacConformsTo(value) {
+    if (!value)
+        return [];
+    return value.filter((entry) => typeof entry === "string");
+}
+/** True when `conformsTo` contains the canonical class for `kind`. */
+export function hasStacConformance(conformsTo, kind) {
+    if (!conformsTo)
+        return false;
+    for (const entry of conformsTo) {
+        if (typeof entry === "string" && matchesStacConformance(entry, kind))
+            return true;
+    }
+    return false;
+}
+/**
+ * Extension classes a search will put on the wire. Core Item Search parameters
+ * (`bbox`, `datetime`, `intersects`, `ids`, `collections`, `limit`, paging)
+ * are not gated. An extension property counts as soon as it is set, including
+ * an empty `fields` or `sortby`, because POST emits those members as-is.
+ * Opaque `nextParams` / `nextBody` continuations are not inspected.
+ */
+export function stacSearchExtensionRequirements(request) {
+    const usesFilter = request.filter !== undefined || request.filterLang !== undefined;
+    const usesSort = request.sortby !== undefined;
+    const usesFields = request.fields !== undefined;
+    if (!usesFilter && !usesSort && !usesFields)
+        return [];
+    const kinds = ["item-search"];
+    if (usesFilter) {
+        kinds.push("filter");
+        // STAC Filter defaults to CQL2 Text for GET and CQL2 JSON for POST.
+        // https://github.com/stac-api-extensions/filter#get-query-parameters-and-post-json-fields
+        // Gate the language the server will actually interpret when it is omitted.
+        const language = request.filterLang ?? (request.usePost === true ? "cql2-json" : "cql2-text");
+        if (language === "cql2-json")
+            kinds.push("cql2-json");
+        else if (language === "cql2-text")
+            kinds.push("cql2-text");
+        else
+            kinds.push("cql2-text", "cql2-json");
+    }
+    if (usesSort)
+        kinds.push("sort");
+    if (usesFields)
+        kinds.push("fields");
+    return kinds;
+}
+/**
+ * Refuse an extension search that has not been checked against `conformsTo`.
+ * `conformsTo === undefined` means the list was never read and fails before
+ * any HTTP request. `conformsTo: []` means it was read and the classes are absent.
+ */
+export function gateStacSearchExtensions(request) {
+    const required = stacSearchExtensionRequirements(request);
+    if (required.length === 0)
+        return;
+    const missing = required
+        .filter((kind) => !hasStacConformance(request.conformsTo, kind))
+        .map((kind) => STAC_CONFORMANCE_CLASS[kind]);
+    if (missing.length === 0)
+        return;
+    throw new HonuaStacConformanceError(missing, { unread: request.conformsTo === undefined });
+}
+function matchesStacConformance(value, kind) {
+    if (kind === "cql2-text" || kind === "cql2-json")
+        return matchesCql2(value, kind);
+    const uri = stacSpecUri(value);
+    if (!uri)
+        return false;
+    const path = uri.pathname.replace(/\/+$/, "");
+    if (kind === "core" || kind === "item-search") {
+        return uri.hash === "" && path === `/v1.0.0/${kind}`;
+    }
+    const fragment = EXTENSION_FRAGMENT[kind];
+    return fragment !== undefined && uri.hash === fragment && (path === ITEM_SEARCH_PATH || path === OGC_FEATURES_PATH);
+}
+function stacSpecUri(value) {
+    try {
+        const uri = new URL(value);
+        if (uri.protocol !== "https:" ||
+            uri.origin !== STAC_SPEC_ORIGIN ||
+            uri.username !== "" ||
+            uri.password !== "" ||
+            uri.search !== "") {
+            return undefined;
+        }
+        return uri;
+    }
+    catch {
+        return undefined;
+    }
+}
+function matchesCql2(value, leaf) {
+    try {
+        const uri = new URL(value);
+        if (uri.protocol !== "http:" && uri.protocol !== "https:")
+            return false;
+        if (uri.hostname !== "www.opengis.net" || uri.port !== "")
+            return false;
+        if (uri.username !== "" || uri.password !== "" || uri.search !== "" || uri.hash !== "")
+            return false;
+        return uri.pathname.replace(/\/+$/, "") === `/spec/cql2/1.0/conf/${leaf}`;
+    }
+    catch {
+        return false;
+    }
+}