@sequenceholdings/artifact-studio 0.10.0 → 0.11.0

package/dist/platform-client.js

@@ -0,0 +1,47 @@
+import { createConsumerPlatformClient, PlatformError } from '@sequenceholdings/platform/browser';
+import { seq, createArtifactStorageClient } from './sdk.js';
+/**
+ * Browser bootstrap for the shared Platform SDK. Authentication and capability checks
+ * stay in the trusted Artifact host; no base URL, token, or service authority is accepted.
+ * Create again with a new sdk when the host/action scope changes.
+ */
+export function createArtifactPlatformClient({ sdk = seq } = {}) {
+    if (!sdk?.api || typeof sdk.api.fetch !== 'function') {
+        throw new PlatformError({ status: 401, code: 'artifact_host_unavailable', message: 'Open the artifact through its Atlas host or preview' });
+    }
+    const shared = createConsumerPlatformClient({ transport: {
+            async request({ path, method, body }) {
+                const result = await sdk.api.fetch(path, { method, body });
+                if (!result.ok)
+                    throw new PlatformError({ status: result.status, code: 'platform_request_failed', message: `Platform request failed (${result.status})`, path });
+                return result.body;
+            },
+            async upload({ path, file }) {
+                const result = await sdk.api.upload(path, file);
+                if (!result.ok)
+                    throw new PlatformError({ status: result.status, code: 'platform_request_failed', message: `Platform upload failed (${result.status})`, path });
+                return result.body;
+            },
+        } });
+    return {
+        ...shared,
+        /** App-owned compatibility routes, still subject to the artifact manifest and live grants. */
+        api: sdk.api,
+        user: sdk.user,
+        env: sdk.env,
+        auth: sdk.auth,
+        flags: sdk.flags,
+        host: sdk.host,
+        offline: sdk.offline,
+        functions: { ...shared.functions, invoke: ({ id, params }) => sdk.functions.invoke(id, params) },
+        lattice: { ...shared.lattice, context: () => sdk.lattice.context() },
+        storage: { ...createArtifactStorageClient(sdk), preview: sdk.storage.preview?.bind(sdk.storage) },
+        agents: { ...shared.agents, chat: (options) => sdk.ai.fetch('/api/agents/chat', { ...options, method: 'POST' }), files: { ...shared.agents.files, download: (input) => sdk.ai.fetch(shared.agents.files.contentPath(input), { method: 'GET' }) } },
+        files: {
+            ...shared.files,
+            upload: ({ file, fields, options }) => sdk.api.upload('/api/files', file, fields, options),
+            download: (input) => sdk.api.fetch(shared.files.downloadPath(input)),
+            speech: { ...shared.files.speech, transcribe: ({ file, timeoutMs = 90_000 }) => sdk.api.upload('/api/files/speech/stt', file, {}, { fieldName: 'audio', timeoutMs }) },
+        },
+    };
+}

package/dist/preview-key.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The preview a `deploy --preview` replaces: an explicit --key, else the --ref
+ * it was built from (so each branch keeps its own preview), else `default`.
+ */
+export declare function branchPreviewKey({ key, ref }: {
+    key: string | true | undefined;
+    ref: string | true | undefined;
+}): string;

package/dist/preview-key.js

@@ -0,0 +1,12 @@
+/**
+ * The preview a `deploy --preview` replaces: an explicit --key, else the --ref
+ * it was built from (so each branch keeps its own preview), else `default`.
+ */
+export function branchPreviewKey({ key, ref }) {
+    if (typeof key === 'string')
+        return key;
+    const fromRef = typeof ref === 'string'
+        ? ref.replace(/^refs\/(heads|tags)\//, '').replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 128)
+        : '';
+    return fromRef || 'default';
+}

package/dist/sdk-processes.d.ts

@@ -0,0 +1,28 @@
+import { type ArtifactServerProcesses } from './server/processes.js';
+import type { ArtifactServerRequest } from './server/broker-contract.js';
+import { type SequenceApiFetchResponse } from './sdk.js';
+/**
+ * Lattice from a static application: the Next.js server SDK's process operations, minus the
+ * Next-only API adapters (group task pages, task assignments, batch describe, human-completion
+ * readers). Every call is checked by Atlas against `capabilities.processes` in the deployed
+ * manifest; then the user's own process and run grants decide.
+ */
+export type ArtifactProcesses = Omit<ArtifactServerProcesses, 'listGroupTasksPage' | 'readTaskAssignments' | 'describeMany' | 'getHumanContinuation' | 'getHumanCompletion'>;
+/** The host transport `createArtifactProcesses` sends each operation through. */
+export interface SequenceProcessesBridge {
+    request<TBody = unknown>(operation: ArtifactServerRequest): Promise<SequenceApiFetchResponse<TBody>>;
+}
+/**
+ * Start, read and act on runs of the processes this artifact declares under
+ * `capabilities.processes.start | read | act`, as the signed-in user:
+ *
+ * ```ts
+ * const processes = createArtifactProcesses()
+ * const run = await processes.start({ process: 'maintenance-request', metadata: { unit: '4B' } })
+ * ```
+ *
+ * A process the manifest does not declare is refused (403) before any grant is checked.
+ */
+export declare function createArtifactProcesses(sdk?: {
+    processes?: SequenceProcessesBridge;
+}): ArtifactProcesses;

package/dist/sdk-processes.js

@@ -0,0 +1,30 @@
+import { createArtifactProcessesClient } from './server/processes.js';
+import { ArtifactServerError, platformRequestError } from './server/errors.js';
+import { seq } from './sdk.js';
+/**
+ * Start, read and act on runs of the processes this artifact declares under
+ * `capabilities.processes.start | read | act`, as the signed-in user:
+ *
+ * ```ts
+ * const processes = createArtifactProcesses()
+ * const run = await processes.start({ process: 'maintenance-request', metadata: { unit: '4B' } })
+ * ```
+ *
+ * A process the manifest does not declare is refused (403) before any grant is checked.
+ */
+export function createArtifactProcesses(sdk = seq) {
+    const bridge = sdk?.processes;
+    if (!bridge || typeof bridge.request !== 'function') {
+        throw new ArtifactServerError(501, 'processes_unavailable', 'Lattice processes need the authenticated Artifact Studio host from a newer Atlas; open the deployed artifact or its preview');
+    }
+    // The omitted methods use broker API adapters, which the static process route refuses.
+    return createArtifactProcessesClient({
+        mode: 'user',
+        json: async (operation) => {
+            const response = await bridge.request(operation);
+            if (!response.ok)
+                throw platformRequestError({ status: response.status, body: response.body, operation: operation.operation });
+            return response.status === 204 ? undefined : response.body;
+        },
+    });
+}

package/dist/sdk.d.ts

@@ -1,7 +1,12 @@
+export { createArtifactPlatformClient, type ArtifactPlatformClient } from './platform-client.js';
 import type { SequenceOfflineManagement } from './offline/management-types.js';
 export type { SequenceOfflineManagement, SequenceOfflineManagementStatus, SequenceOfflineManagementIssue } from './offline/management-types.js';
-import { type StartStorageUpload, type StorageUploadSession } from '@sequenceholdings/storage';
+import { type StartStorageUpload, type StorageUploadSession } from '@sequenceholdings/platform/storage';
 export { createArtifactOrmExecutor, type ArtifactOrmExecutorConfig } from './sdk-orm.js';
+export { createArtifactProcesses, type ArtifactProcesses, type SequenceProcessesBridge } from './sdk-processes.js';
+export type { ArtifactProcessAdvance, ArtifactProcessAdvanceResult, ArtifactProcessAssign, ArtifactProcessAssignResult, ArtifactProcessDefinition, ArtifactProcessDescribeQuery, ArtifactProcessRun, ArtifactProcessRunRecord, ArtifactProcessRunSnapshot, ArtifactProcessRunsQuery, ArtifactProcessStart, ArtifactProcessTask, ArtifactProcessTasksQuery, } from './server/processes.js';
+export { ArtifactServerError } from './server/errors.js';
+import type { SequenceProcessesBridge } from './sdk-processes.js';
 export type { ArtifactOrmJsonScalars } from './orm-json-scalars.js';
 export interface SequenceStorageOptions {
     signal?: AbortSignal;
@@ -213,6 +218,8 @@ export interface SequenceArtifactSdk {
     flags: SequenceFlags;
     lattice: SequenceLattice;
     host: SequenceHost;
+    /** Transport for {@link createArtifactProcesses}; absent on older Atlas hosts. */
+    processes?: SequenceProcessesBridge;
 }
 declare global {
     interface Window {
@@ -248,7 +255,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                 fileId: string;
                 uploadUrl: string | null;
                 expiresAt: string;
-                state: "pending" | "complete" | "aborted";
+                state: "aborted" | "pending" | "complete";
                 versionId: string | null;
                 maxBytes: number;
             }>;
@@ -257,16 +264,16 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                 fileId: string;
                 uploadUrl: string | null;
                 expiresAt: string;
-                state: "pending" | "complete" | "aborted";
+                state: "aborted" | "pending" | "complete";
                 versionId: string | null;
                 maxBytes: number;
             }>;
-            complete: (id: string, input?: import("@sequenceholdings/storage").CompleteStorageUpload) => Promise<{
+            complete: (id: string, input?: import("@sequenceholdings/platform/storage").CompleteStorageUpload) => Promise<{
                 id: string;
                 fileId: string;
                 uploadUrl: string | null;
                 expiresAt: string;
-                state: "pending" | "complete" | "aborted";
+                state: "aborted" | "pending" | "complete";
                 versionId: string | null;
                 maxBytes: number;
             }>;
@@ -275,7 +282,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                 fileId: string;
                 uploadUrl: string | null;
                 expiresAt: string;
-                state: "pending" | "complete" | "aborted";
+                state: "aborted" | "pending" | "complete";
                 versionId: string | null;
                 maxBytes: number;
             }>;
@@ -285,7 +292,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                     fileId: string;
                     uploadUrl: string | null;
                     expiresAt: string;
-                    state: "pending" | "complete" | "aborted";
+                    state: "aborted" | "pending" | "complete";
                     versionId: string | null;
                     maxBytes: number;
                 }[];
@@ -295,7 +302,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                     id: string;
                     fileId: string;
                     name: string;
-                    state: "pending" | "complete" | "aborted";
+                    state: "aborted" | "pending" | "complete";
                     expiresAt: string;
                     maxBytes: number;
                     expectedSize: number | null;
@@ -313,7 +320,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                     id: string;
                     fileId: string;
                     name: string;
-                    state: "pending" | "complete" | "aborted";
+                    state: "aborted" | "pending" | "complete";
                     expiresAt: string;
                     maxBytes: number;
                     expectedSize: number | null;
@@ -325,7 +332,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                     id: string;
                     fileId: string;
                     name: string;
-                    state: "pending" | "complete" | "aborted";
+                    state: "aborted" | "pending" | "complete";
                     expiresAt: string;
                     maxBytes: number;
                     expectedSize: number | null;
@@ -337,7 +344,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
                     id: string;
                     fileId: string;
                     name: string;
-                    state: "pending" | "complete" | "aborted";
+                    state: "aborted" | "pending" | "complete";
                     expiresAt: string;
                     maxBytes: number;
                     expectedSize: number | null;
@@ -365,7 +372,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             workspaceId: string;
             targetId: string | null;
             kind: "purge" | "delete_version";
-            status: "queued" | "running" | "succeeded" | "failed";
+            status: "running" | "failed" | "queued" | "succeeded";
             completed: number;
             total: number;
             error: string | null;
@@ -373,7 +380,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             updatedAt: string;
             canRetry: boolean;
         }>;
-        list: (options?: import("@sequenceholdings/storage").StorageListOptions & {
+        list: (options?: import("@sequenceholdings/platform/storage").StorageListOptions & {
             parentId?: string | null;
             trash?: boolean;
         }) => Promise<{
@@ -413,6 +420,40 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             size: number | null;
             contentType: string | null;
         }>;
+        getNodeWithAncestors: (id: string) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+            ancestors: {
+                id: string;
+                workspaceId: string;
+                parentId: string | null;
+                name: string;
+                kind: "file" | "folder";
+                state: "active" | "trashed" | "purging";
+                restricted: boolean;
+                revision: number;
+                currentVersionId: string | null;
+                metadata: Record<string, string>;
+                createdAt: string;
+                updatedAt: string;
+                role: "viewer" | "editor" | "admin";
+                size: number | null;
+                contentType: string | null;
+            }[];
+        }>;
         createFolder: (name: string, parentId?: string | null, { idempotencyKey, }?: {
             idempotencyKey?: string;
         }) => Promise<{
@@ -432,7 +473,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             size: number | null;
             contentType: string | null;
         }>;
-        update: (id: string, input: import("zod").input<typeof import("@sequenceholdings/storage").updateNodeSchema>) => Promise<{
+        update: (id: string, input: import("zod").input<typeof import("@sequenceholdings/platform/storage").updateNodeSchema>) => Promise<{
             id: string;
             workspaceId: string;
             parentId: string | null;
@@ -488,7 +529,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             workspaceId: string;
             targetId: string | null;
             kind: "purge" | "delete_version";
-            status: "queued" | "running" | "succeeded" | "failed";
+            status: "running" | "failed" | "queued" | "succeeded";
             completed: number;
             total: number;
             error: string | null;
@@ -537,7 +578,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             workspaceId: string;
             targetId: string | null;
             kind: "purge" | "delete_version";
-            status: "queued" | "running" | "succeeded" | "failed";
+            status: "running" | "failed" | "queued" | "succeeded";
             completed: number;
             total: number;
             error: string | null;
@@ -549,7 +590,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             revision: number;
             restricted: boolean;
             grants: {
-                type: "user" | "group" | "organization" | "service_account";
+                type: "user" | "service_account" | "group" | "organization";
                 id: string;
                 role: "viewer" | "editor" | "admin";
             }[];
@@ -558,11 +599,11 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             workspaceAdminOverride: true;
             displayNames: Record<string, string>;
         }>;
-        setAccess: (input: import("zod").input<typeof import("@sequenceholdings/storage").updateStorageAccessSchema>, id?: string) => Promise<{
+        setAccess: (input: import("zod").input<typeof import("@sequenceholdings/platform/storage").updateStorageAccessSchema>, id?: string) => Promise<{
             revision: number;
             restricted: boolean;
             grants: {
-                type: "user" | "group" | "organization" | "service_account";
+                type: "user" | "service_account" | "group" | "organization";
                 id: string;
                 role: "viewer" | "editor" | "admin";
             }[];
@@ -578,7 +619,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             revision: number;
             restricted: boolean;
             grants: {
-                type: "user" | "group" | "organization" | "service_account";
+                type: "user" | "service_account" | "group" | "organization";
                 id: string;
                 role: "viewer" | "editor" | "admin";
             }[];
@@ -590,14 +631,14 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
         operations: (options?: {
             before?: string;
             limit?: number;
-            scope?: import("@sequenceholdings/storage").StorageOperationScope;
+            scope?: import("@sequenceholdings/platform/storage").StorageOperationScope;
         }) => Promise<{
             items: {
                 id: string;
                 workspaceId: string;
                 targetId: string | null;
                 kind: "purge" | "delete_version";
-                status: "queued" | "running" | "succeeded" | "failed";
+                status: "running" | "failed" | "queued" | "succeeded";
                 completed: number;
                 total: number;
                 error: string | null;
@@ -612,7 +653,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             workspaceId: string;
             targetId: string | null;
             kind: "purge" | "delete_version";
-            status: "queued" | "running" | "succeeded" | "failed";
+            status: "running" | "failed" | "queued" | "succeeded";
             completed: number;
             total: number;
             error: string | null;
@@ -634,7 +675,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
             max: number;
         };
     }>;
-    list: (options?: import("@sequenceholdings/storage").StorageListOptions) => Promise<{
+    list: (options?: import("@sequenceholdings/platform/storage").StorageListOptions) => Promise<{
         items: {
             id: string;
             name: string;
@@ -650,7 +691,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
         }[];
         nextCursor: string | null;
     }>;
-    shared: (options?: import("@sequenceholdings/storage").StorageListOptions & {
+    shared: (options?: import("@sequenceholdings/platform/storage").StorageListOptions & {
         trash?: boolean;
     }) => Promise<{
         items: {
@@ -672,7 +713,7 @@ export declare function createArtifactStorageClient(sdk?: SequenceArtifactSdk):
         }[];
         nextCursor: string | null;
     }>;
-    apply: (manifest: import("@sequenceholdings/storage").WorkspaceManifest) => Promise<{
+    apply: (manifest: import("@sequenceholdings/platform/storage").WorkspaceManifest) => Promise<{
         id: string;
         name: string;
         description: string;

package/dist/sdk.js

@@ -1,5 +1,8 @@
-import { storageClient } from '@sequenceholdings/storage';
+export { createArtifactPlatformClient } from './platform-client.js';
+import { storageClient } from '@sequenceholdings/platform/storage';
 export { createArtifactOrmExecutor } from './sdk-orm.js';
+export { createArtifactProcesses } from './sdk-processes.js';
+export { ArtifactServerError } from './server/errors.js';
 export const seq = typeof window !== 'undefined'
     ? window.seq
     : undefined;

package/dist/server/broker-contract.d.ts

@@ -330,12 +330,12 @@ export declare const artifactServerRequestSchema: z.ZodDiscriminatedUnion<[z.Zod
         import: "import";
         share: "share";
         upload: "upload";
-        submit: "submit";
         view: "view";
         create: "create";
         update: "update";
         download: "download";
         export: "export";
+        submit: "submit";
         approve: "approve";
         reject: "reject";
         execute: "execute";

package/dist/server/client.d.ts

@@ -1,4 +1,5 @@
-import { storageClient } from '@sequenceholdings/storage';
+import { type ArtifactServerPlatform } from './platform-client.js';
+import { storageClient } from '@sequenceholdings/platform/storage';
 import { type OperationExecutor } from '@sequenceholdings/orm/client';
 import { type ArtifactAuditAction, type ArtifactServerMode } from './broker-contract.js';
 import { type ArtifactServerGroups } from './groups.js';
@@ -75,6 +76,8 @@ export interface ArtifactServerAudit {
 export type ArtifactServerContext = ArtifactRequestContext | RequestContextV2External;
 export interface ArtifactServerClient<TContext extends ArtifactServerContext = ArtifactRequestContext> {
     context: TContext;
+    /** Unified shared Platform clients, retaining this request's verified broker authority. */
+    readonly platform: ArtifactServerPlatform;
     /** Who the request acts for. An `external` principal reaches platform services only through `asService()`. */
     principal: ArtifactPrincipal;
     mode: ArtifactServerMode;

package/dist/server/client.js

@@ -1,5 +1,6 @@
+import { createArtifactServerPlatformAdapter } from './platform-client.js';
 import { randomUUID } from 'node:crypto';
-import { StorageApiError, storageClient, storageErrorSchema } from '@sequenceholdings/storage';
+import { StorageApiError, storageClient, storageErrorSchema } from '@sequenceholdings/platform/storage';
 import { OrmOperationError } from '@sequenceholdings/orm/client';
 import { z } from 'zod';
 import { artifactOrmIdempotencyKeySchema, artifactServerRequestSchema } from './broker-contract.js';
@@ -90,6 +91,7 @@ function buildClient(args) {
         return Object.fromEntries(names.map(name => [name, parsed.data.flags[name] === true]));
     };
     return {
+        get platform() { return createArtifactServerPlatformAdapter(this); },
         context,
         principal,
         mode,