@nurix/nustack 0.10.0-dev.13 → 0.10.0-dev.15

package/dist/lib/git-sync/outbound/history_decision.js

@@ -49,11 +49,11 @@ export async function publishCurrentState(store, binding, repo, deps) {
             repo,
             client: deps.client,
             whitelistRef: { current: whitelist },
-            workspaceId: binding.workspaceId,
+            projectId: binding.projectId,
             now: deps.now ?? Date.now,
         };
         for (let staleDepth = 0;; staleDepth++) {
-            const delta = computeTreeDelta(repo, base, head, ctx.whitelistRef.current, binding.workspaceId);
+            const delta = computeTreeDelta(repo, base, head, ctx.whitelistRef.current, binding.projectId);
             if (!delta.ok)
                 return { ok: false, code: delta.code, detail: delta.path };
             const result = await pushOperations(ctx, head, base, delta.delta.operations);

package/dist/lib/git-sync/outbound/publisher.js

@@ -19,7 +19,7 @@ export async function runOutboundPublisher(ctx, runtime) {
         repo,
         client: runtime.client,
         whitelistRef: { current: whitelist },
-        workspaceId: binding.workspaceId,
+        projectId: binding.projectId,
         now,
     };
     for (const commitId of commitIds) {
@@ -32,7 +32,7 @@ export async function runOutboundPublisher(ctx, runtime) {
         switch (outcome.kind) {
             case "accepted":
                 updateBindingCursor(store, binding.id, { lastProcessedCommitId: commitId });
-                emit({ event: "upload_result", bindingId: binding.id, commitId, outcome: "accepted", handoffId: outcome.handoffId, workspaceSequence: outcome.workspaceSequence });
+                emit({ event: "upload_result", bindingId: binding.id, commitId, outcome: "accepted", handoffId: outcome.handoffId, projectSequence: outcome.projectSequence });
                 break;
             case "no_op":
                 updateBindingCursor(store, binding.id, { lastProcessedCommitId: commitId });

package/dist/lib/git-sync/outbound/queue.js

@@ -24,7 +24,7 @@ export async function submitHead(ctx, commitId) {
     return attempt(ctx, commitId, 0);
 }
 async function attempt(ctx, commitId, staleDepth) {
-    const extraction = extractCommitDelta(ctx.repo, commitId, ctx.whitelistRef.current, ctx.workspaceId);
+    const extraction = extractCommitDelta(ctx.repo, commitId, ctx.whitelistRef.current, ctx.projectId);
     if (!extraction.ok) {
         return blockBinding(ctx, commitId, extraction.code, { path: extraction.path });
     }
@@ -85,11 +85,11 @@ export async function pushOperations(ctx, commitId, parentCommitId, operations)
         bindingId: ctx.binding.id,
         commitId,
         handoffId: outcome.accepted.handoffId,
-        workspaceSequence: outcome.accepted.workspaceSequence,
+        projectSequence: outcome.accepted.projectSequence,
         manifestSha256: built.manifestSha256,
     });
     deleteUpload(ctx.store, ctx.binding.id, commitId);
-    return { kind: "accepted", handoffId: outcome.accepted.handoffId, workspaceSequence: outcome.accepted.workspaceSequence };
+    return { kind: "accepted", handoffId: outcome.accepted.handoffId, projectSequence: outcome.accepted.projectSequence };
 }
 async function repinWhitelist(ctx) {
     try {

package/dist/lib/git-sync/outbound/upload_client.js

@@ -18,7 +18,7 @@ const TERMINAL_CODES = new Set([
     "INVALID_STATE",
     "IDEMPOTENCY_CONFLICT",
     "HANDOFF_SUPERSEDED",
-    "WORKSPACE_NOT_FOUND",
+    "PROJECT_NOT_FOUND",
     "DOCUMENT_NOT_FOUND",
 ]);
 const AUTH_CODES = new Set(["AUTH_REQUIRED", "ACCESS_TOKEN_EXPIRED", "DEVICE_CREDENTIAL_INVALID"]);
@@ -120,11 +120,11 @@ export function createUploadClient(deps) {
                 const data = (response.body?.data ?? {});
                 if (data.noOp)
                     return { ok: true, value: { noOp: true } };
-                const workspaceSequence = data.workspaceSequence ?? response.body?.meta?.workspaceSequence;
-                if (!data.handoffId || typeof workspaceSequence !== "number") {
+                const projectSequence = data.projectSequence ?? response.body?.meta?.projectSequence;
+                if (!data.handoffId || typeof projectSequence !== "number") {
                     return { ok: false, error: { kind: "terminal", code: "MALFORMED_ACCEPTANCE" } };
                 }
-                return { ok: true, value: { accepted: { handoffId: data.handoffId, workspaceSequence } } };
+                return { ok: true, value: { accepted: { handoffId: data.handoffId, projectSequence } } };
             });
         },
         reportHealth(bindingId, report) {

package/dist/lib/git-sync/whitelist/index.js

@@ -1,4 +1,4 @@
 export { SYNC_PROTOCOL_VERSION, isWhitelistManifest, } from "./types.js";
 export { matchPath, isProtectedPath, globMatch } from "./matcher.js";
-export { validateOperationContent, mediaTypeForPath, frontmatterWorkspaceId, } from "./validation.js";
+export { validateOperationContent, mediaTypeForPath, frontmatterProjectId, } from "./validation.js";
 export { fetchWhitelist, pinWhitelist, loadPinnedWhitelist, canonicalWhitelistSha256, whitelistCacheFile, WhitelistError, } from "./store.js";

package/dist/lib/git-sync/whitelist/types.js

@@ -36,7 +36,7 @@ export function isWhitelistManifest(value) {
     return (manifest.schemaVersion === 1 &&
         typeof manifest.manifestId === "string" &&
         typeof manifest.version === "number" &&
-        typeof manifest.workspaceId === "string" &&
+        typeof manifest.projectId === "string" &&
         typeof manifest.protocolVersion === "string" &&
         Array.isArray(manifest.entries) &&
         manifest.entries.every(isEntry) &&

package/dist/lib/git-sync/whitelist/validation.js

@@ -14,7 +14,7 @@ export function mediaTypeForPath(path) {
     const ext = path.slice(dot + 1).toLowerCase();
     return MEDIA_TYPE_BY_EXTENSION[ext] ?? null;
 }
-export function frontmatterWorkspaceId(text) {
+export function frontmatterProjectId(text) {
     if (!text.startsWith("---"))
         return null;
     const firstNewline = text.indexOf("\n");
@@ -26,7 +26,7 @@ export function frontmatterWorkspaceId(text) {
     const closeIndex = rest.search(/\n---\s*(\n|$)/);
     const block = closeIndex < 0 ? rest : rest.slice(0, closeIndex);
     for (const line of block.split("\n")) {
-        const match = /^\s*(?:workspace_id|workspaceId|app_id|appId)\s*:\s*(.+?)\s*$/.exec(line);
+        const match = /^\s*(?:project_id|projectId|app_id|appId)\s*:\s*(.+?)\s*$/.exec(line);
         if (match)
             return match[1].replace(/^["']|["']$/g, "");
     }
@@ -52,9 +52,9 @@ export function validateOperationContent(input) {
     }
     if (text.includes(NUL))
         return { ok: false, code: "invalid_encoding" };
-    const declaredWorkspace = frontmatterWorkspaceId(text);
-    if (declaredWorkspace !== null && declaredWorkspace !== input.workspaceId) {
-        return { ok: false, code: "cross_workspace_marker" };
+    const declaredProject = frontmatterProjectId(text);
+    if (declaredProject !== null && declaredProject !== input.projectId) {
+        return { ok: false, code: "cross_project_marker" };
     }
     return { ok: true };
 }

package/dist/lib/lanes/supervisor.js

@@ -40,7 +40,7 @@ export class LaneSupervisor {
     registryPath() {
         return path.join(lanesHome(this.env), "registry.json");
     }
-    async boundWorkspaceOf(projectPath) {
+    async boundProjectOf(projectPath) {
         try {
             const parsed = JSON.parse(await readFile(path.join(projectPath, ".nustack", "workspace.json"), "utf8"));
             const id = parsed?.workspaceId;
@@ -52,10 +52,10 @@ export class LaneSupervisor {
     }
     async moveLaneSession(record, to) {
         const client = this.options.sessions;
-        if (!client || !record.workspaceId)
+        if (!client || !record.projectId)
             return;
         try {
-            await client.transitionSession(record.workspaceId, record.laneId, to);
+            await client.transitionSession(record.projectId, record.laneId, to);
         }
         catch {
         }
@@ -153,7 +153,7 @@ export class LaneSupervisor {
             providerSessionId: null,
             createdAt: new Date().toISOString(),
             status: "open",
-            workspaceId: await this.boundWorkspaceOf(projectPath),
+            projectId: await this.boundProjectOf(projectPath),
         };
         const adapterOptions = {
             cwd: worktree.worktreePath,
@@ -183,8 +183,8 @@ export class LaneSupervisor {
                 record.providerSessionId = sessionId;
                 void this.updateRegistry((lanes) => lanes.map((row) => (row.laneId === laneId ? { ...row, providerSessionId: sessionId } : row)));
                 const client = this.options.sessions;
-                if (client && record.workspaceId) {
-                    void client.setVendorSessionId(record.workspaceId, laneId, sessionId).catch(() => undefined);
+                if (client && record.projectId) {
+                    void client.setVendorSessionId(record.projectId, laneId, sessionId).catch(() => undefined);
                 }
             },
             onExit: (code) => {
@@ -207,9 +207,9 @@ export class LaneSupervisor {
         }
         this.lanes.set(laneId, { adapter, record });
         await this.updateRegistry((lanes) => [...lanes.filter((row) => row.laneId !== laneId), record]);
-        if (this.options.sessions && record.workspaceId) {
+        if (this.options.sessions && record.projectId) {
             try {
-                await this.options.sessions.createSession(record.workspaceId, {
+                await this.options.sessions.createSession(record.projectId, {
                     id: laneId,
                     startedBy: "person",
                     substrate: "device",

package/dist/lib/local_store/accepted_uploads.js

@@ -3,7 +3,7 @@ function mapRow(row) {
         bindingId: row.binding_id,
         commitId: row.commit_id,
         handoffId: row.handoff_id,
-        workspaceSequence: row.workspace_sequence,
+        projectSequence: row.project_sequence,
         manifestSha256: row.manifest_sha256,
         createdAtMs: row.created_at_ms,
     };
@@ -11,16 +11,16 @@ function mapRow(row) {
 export function recordAcceptedUpload(store, input) {
     store.db
         .prepare(`INSERT INTO local_accepted_uploads (
-                binding_id, commit_id, handoff_id, workspace_sequence, manifest_sha256, created_at_ms
+                binding_id, commit_id, handoff_id, project_sequence, manifest_sha256, created_at_ms
             ) VALUES (
-                :binding_id, :commit_id, :handoff_id, :workspace_sequence, :manifest_sha256, :created_at_ms
+                :binding_id, :commit_id, :handoff_id, :project_sequence, :manifest_sha256, :created_at_ms
             )
             ON CONFLICT(binding_id, commit_id) DO NOTHING`)
         .run({
         binding_id: input.bindingId,
         commit_id: input.commitId,
         handoff_id: input.handoffId,
-        workspace_sequence: input.workspaceSequence,
+        project_sequence: input.projectSequence,
         manifest_sha256: input.manifestSha256,
         created_at_ms: Date.now(),
     });
@@ -42,7 +42,7 @@ export function latestAcceptedUpload(store, bindingId) {
     const row = store.db
         .prepare(`SELECT * FROM local_accepted_uploads
              WHERE binding_id = :binding_id
-             ORDER BY workspace_sequence DESC, created_at_ms DESC
+             ORDER BY project_sequence DESC, created_at_ms DESC
              LIMIT 1`)
         .get({ binding_id: bindingId });
     return row ? mapRow(row) : null;

package/dist/lib/local_store/bindings.js

@@ -3,7 +3,7 @@ import { LIVE_BINDING_STATUSES } from "./sync_vocabulary.js";
 function mapRow(row) {
     return {
         id: row.id,
-        workspaceId: row.workspace_id,
+        projectId: row.project_id,
         organizationId: row.organization_id,
         repositoryRoot: row.repository_root,
         gitDir: row.git_dir,
@@ -11,7 +11,7 @@ function mapRow(row) {
         repositoryFingerprint: row.repository_fingerprint,
         boundBranch: row.bound_branch,
         lastProcessedCommitId: row.last_processed_commit_id ?? null,
-        lastAppliedWorkspaceSequence: row.last_applied_workspace_sequence,
+        lastAppliedProjectSequence: row.last_applied_project_sequence,
         whitelistManifestId: row.whitelist_manifest_id ?? null,
         whitelistManifestSha256: row.whitelist_manifest_sha256 ?? null,
         whitelistCachePath: row.whitelist_cache_path ?? null,
@@ -28,21 +28,21 @@ export function insertBinding(store, input) {
     const now = Date.now();
     store.db
         .prepare(`INSERT INTO local_bindings (
-                id, workspace_id, organization_id, repository_root, git_dir, git_common_dir,
+                id, project_id, organization_id, repository_root, git_dir, git_common_dir,
                 repository_fingerprint, bound_branch, last_processed_commit_id,
-                last_applied_workspace_sequence, whitelist_manifest_id, whitelist_manifest_sha256,
+                last_applied_project_sequence, whitelist_manifest_id, whitelist_manifest_sha256,
                 whitelist_cache_path, etna_profile_json, status, last_error_code,
                 last_error_detail, created_at_ms, updated_at_ms
             ) VALUES (
-                :id, :workspace_id, :organization_id, :repository_root, :git_dir, :git_common_dir,
+                :id, :project_id, :organization_id, :repository_root, :git_dir, :git_common_dir,
                 :repository_fingerprint, :bound_branch, :last_processed_commit_id,
-                :last_applied_workspace_sequence, :whitelist_manifest_id, :whitelist_manifest_sha256,
+                :last_applied_project_sequence, :whitelist_manifest_id, :whitelist_manifest_sha256,
                 :whitelist_cache_path, :etna_profile_json, :status, NULL,
                 NULL, :created_at_ms, :updated_at_ms
             )`)
         .run({
         id: input.id,
-        workspace_id: input.workspaceId,
+        project_id: input.projectId,
         organization_id: input.organizationId,
         repository_root: input.repositoryRoot,
         git_dir: input.gitDir,
@@ -50,7 +50,7 @@ export function insertBinding(store, input) {
         repository_fingerprint: input.repositoryFingerprint,
         bound_branch: input.boundBranch,
         last_processed_commit_id: input.lastProcessedCommitId ?? null,
-        last_applied_workspace_sequence: input.lastAppliedWorkspaceSequence ?? 0,
+        last_applied_project_sequence: input.lastAppliedProjectSequence ?? 0,
         whitelist_manifest_id: input.whitelistManifestId ?? null,
         whitelist_manifest_sha256: input.whitelistManifestSha256 ?? null,
         whitelist_cache_path: input.whitelistCachePath ?? null,
@@ -103,12 +103,12 @@ export function updateBindingCursor(store, bindingId, patch) {
                      WHERE id = :id`)
                 .run({ commit: patch.lastProcessedCommitId ?? null, now, id: bindingId });
         }
-        if (patch.lastAppliedWorkspaceSequence !== undefined) {
+        if (patch.lastAppliedProjectSequence !== undefined) {
             store.db
                 .prepare(`UPDATE local_bindings
-                     SET last_applied_workspace_sequence = :seq, updated_at_ms = :now
+                     SET last_applied_project_sequence = :seq, updated_at_ms = :now
                      WHERE id = :id`)
-                .run({ seq: patch.lastAppliedWorkspaceSequence, now, id: bindingId });
+                .run({ seq: patch.lastAppliedProjectSequence, now, id: bindingId });
         }
         return getBindingById(store, bindingId);
     });

package/dist/lib/local_store/index.js

@@ -10,5 +10,5 @@ export * from "./recovery_bundles.js";
 export * from "./pending_uploads.js";
 export * from "./history_decisions.js";
 export * from "./accepted_uploads.js";
-export * from "./workspace_events_cache.js";
+export * from "./project_events_cache.js";
 export * from "./filebeat_state.js";

package/dist/lib/local_store/migrations.js

@@ -193,6 +193,18 @@ const MIGRATION_V6 = {
         `CREATE INDEX local_bindings_workspace_idx ON local_bindings (workspace_id)`,
     ],
 };
+const MIGRATION_V7 = {
+    version: 7,
+    statements: [
+        `ALTER TABLE local_bindings RENAME COLUMN workspace_id TO project_id`,
+        `ALTER TABLE local_bindings RENAME COLUMN last_applied_workspace_sequence TO last_applied_project_sequence`,
+        `ALTER TABLE cached_workspace_events RENAME COLUMN workspace_sequence TO project_sequence`,
+        `ALTER TABLE local_accepted_uploads RENAME COLUMN workspace_sequence TO project_sequence`,
+        `ALTER TABLE cached_workspace_events RENAME TO cached_project_events`,
+        `DROP INDEX IF EXISTS local_bindings_workspace_idx`,
+        `CREATE INDEX local_bindings_project_idx ON local_bindings (project_id)`,
+    ],
+};
 export const MIGRATIONS = [
     MIGRATION_V1,
     MIGRATION_V2,
@@ -200,6 +212,7 @@ export const MIGRATIONS = [
     MIGRATION_V4,
     MIGRATION_V5,
     MIGRATION_V6,
+    MIGRATION_V7,
 ];
 export const LATEST_SCHEMA_VERSION = MIGRATIONS[MIGRATIONS.length - 1].version;
 export class LocalSchemaTooNewError extends Error {

package/dist/lib/local_store/project_events_cache.js

@@ -0,0 +1,54 @@
+export const DEFAULT_PROJECT_EVENT_KEEP_COUNT = 500;
+function mapRow(row) {
+    return {
+        bindingId: row.binding_id,
+        projectSequence: row.project_sequence,
+        eventType: row.event_type,
+        payloadJson: row.payload_json ?? null,
+        appliedAtMs: row.applied_at_ms ?? null,
+        createdAtMs: row.created_at_ms,
+    };
+}
+export function cacheProjectEvents(store, bindingId, events) {
+    const now = Date.now();
+    const insert = store.db.prepare(`INSERT INTO cached_project_events (
+            binding_id, project_sequence, event_type, payload_json, applied_at_ms, created_at_ms
+        ) VALUES (
+            :binding_id, :project_sequence, :event_type, :payload_json, :applied_at_ms, :created_at_ms
+        )
+        ON CONFLICT(binding_id, project_sequence) DO NOTHING`);
+    for (const event of events) {
+        insert.run({
+            binding_id: bindingId,
+            project_sequence: event.projectSequence,
+            event_type: event.eventType,
+            payload_json: event.payloadJson ?? null,
+            applied_at_ms: event.appliedAtMs ?? null,
+            created_at_ms: now,
+        });
+    }
+}
+export function latestCachedSequence(store, bindingId) {
+    const row = store.db
+        .prepare("SELECT MAX(project_sequence) AS latest FROM cached_project_events WHERE binding_id = :binding_id")
+        .get({ binding_id: bindingId });
+    return row?.latest ?? null;
+}
+export function listCachedProjectEvents(store, bindingId) {
+    const rows = store.db
+        .prepare("SELECT * FROM cached_project_events WHERE binding_id = :binding_id ORDER BY project_sequence ASC")
+        .all({ binding_id: bindingId });
+    return rows.map(mapRow);
+}
+export function pruneProjectEvents(store, bindingId, keepCount = DEFAULT_PROJECT_EVENT_KEEP_COUNT) {
+    store.db
+        .prepare(`DELETE FROM cached_project_events
+             WHERE binding_id = :binding_id
+               AND project_sequence NOT IN (
+                   SELECT project_sequence FROM cached_project_events
+                   WHERE binding_id = :binding_id
+                   ORDER BY project_sequence DESC
+                   LIMIT :keep
+               )`)
+        .run({ binding_id: bindingId, keep: keepCount });
+}

package/dist/lib/nustack_client.js

@@ -60,7 +60,7 @@ export async function exchangeServiceCredential(baseUrl, accessToken, params) {
     const response = await authorizedFetch(`${baseUrl}/api/v1/keys/exchange`, {
         method: "POST",
         headers: { Authorization: `Bearer ${accessToken}`, "Content-Type": "application/json" },
-        body: JSON.stringify({ workspaceId: params.workspaceId, service: params.service }),
+        body: JSON.stringify({ projectId: params.projectId, service: params.service }),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
     const payload = (await response.json().catch(() => null));
@@ -71,7 +71,7 @@ export async function exchangeServiceCredential(baseUrl, accessToken, params) {
 }
 export async function fetchServiceCredential(baseUrl, accessToken, params) {
     const url = new URL(`${baseUrl}/api/v1/keys/credentials`);
-    url.searchParams.set("workspaceId", assertSafeOpaqueId("The Workspace id", params.workspaceId));
+    url.searchParams.set("projectId", assertSafeOpaqueId("The Project id", params.projectId));
     url.searchParams.set("service", assertSafeOpaqueId("The Service slug", params.service));
     const response = await authorizedFetch(url, {
         headers: { Authorization: `Bearer ${accessToken}` },
@@ -83,9 +83,9 @@ export async function fetchServiceCredential(baseUrl, accessToken, params) {
     }
     return narrowProjection(payload, params.service);
 }
-export async function listWorkspaceIntegrations(baseUrl, accessToken, workspaceId) {
+export async function listProjectIntegrations(baseUrl, accessToken, projectId) {
     const url = new URL(`${baseUrl}/api/v1/keys/integrations`);
-    url.searchParams.set("workspaceId", assertSafeOpaqueId("The Workspace id", workspaceId));
+    url.searchParams.set("projectId", assertSafeOpaqueId("The Project id", projectId));
     const response = await authorizedFetch(url, {
         headers: { Authorization: `Bearer ${accessToken}` },
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
@@ -101,7 +101,7 @@ export async function fetchBrokeredCredential(baseUrl, accessToken, params) {
     const response = await authorizedFetch(`${baseUrl}/api/v1/keys/broker/${encodeURIComponent(service)}`, {
         method: "POST",
         headers: { Authorization: `Bearer ${accessToken}`, "Content-Type": "application/json" },
-        body: JSON.stringify({ workspaceId: params.workspaceId }),
+        body: JSON.stringify({ projectId: params.projectId }),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
     const payload = (await response.json().catch(() => null));
@@ -110,8 +110,8 @@ export async function fetchBrokeredCredential(baseUrl, accessToken, params) {
     }
     return { url: payload.url ?? null, key: payload.key, meta: payload.meta ?? null, grantId: payload.grantId };
 }
-export async function searchWorkspaces(baseUrl, query, opts = {}) {
-    const url = new URL(`${baseUrl}/public/v1/workspaces`);
+export async function searchProjects(baseUrl, query, opts = {}) {
+    const url = new URL(`${baseUrl}/public/v1/projects`);
     url.searchParams.set("q", query);
     if (opts.category)
         url.searchParams.set("category", opts.category);
@@ -120,7 +120,7 @@ export async function searchWorkspaces(baseUrl, query, opts = {}) {
     const response = await authorizedFetch(url, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
     const payload = (await response.json().catch(() => null));
     if (!response.ok || !Array.isArray(payload?.data?.items)) {
-        throw new Error(errorMessage(payload, response.status, "workspace search failed"));
+        throw new Error(errorMessage(payload, response.status, "project search failed"));
     }
     return payload.data.items;
 }
@@ -190,10 +190,10 @@ export async function acknowledgeBindingCursor(baseUrl, accessToken, params) {
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
     const payload = (await response.json().catch(() => null));
-    if (!response.ok || typeof payload?.data?.lastAppliedWorkspaceSequence !== "number") {
+    if (!response.ok || typeof payload?.data?.lastAppliedProjectSequence !== "number") {
         throw new Error(errorMessage(payload, response.status, "cursor acknowledgement failed"));
     }
-    return payload.data.lastAppliedWorkspaceSequence;
+    return payload.data.lastAppliedProjectSequence;
 }
 export async function fetchSyncWhitelist(baseUrl, accessToken, bindingId) {
     const safeId = assertSafeOpaqueId("The binding id", bindingId);
@@ -295,31 +295,31 @@ export async function createOrganization(baseUrl, accessToken, params, idempoten
     }
     return payload.data;
 }
-export async function listWorkspaces(baseUrl, accessToken, organizationId) {
+export async function listProjects(baseUrl, accessToken, organizationId) {
     const safeId = assertSafeOpaqueId("The Organization id", organizationId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/workspaces`, {
+    const response = await authorizedFetch(`${baseUrl}/api/v2/projects`, {
         headers: { ...authHeaders(accessToken), "X-NuStack-Organization": safeId },
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
     const payload = (await response.json().catch(() => null));
     if (!response.ok || !Array.isArray(payload?.data?.items)) {
-        throw new Error(errorMessage(payload, response.status, "workspace list failed"));
+        throw new Error(errorMessage(payload, response.status, "project list failed"));
     }
     return payload.data.items;
 }
-export async function getWorkspace(baseUrl, accessToken, workspaceId) {
-    const safeId = assertSafeOpaqueId("The Workspace id", workspaceId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/workspaces/${encodeURIComponent(safeId)}`, {
+export async function getProject(baseUrl, accessToken, projectId) {
+    const safeId = assertSafeOpaqueId("The Project id", projectId);
+    const response = await authorizedFetch(`${baseUrl}/api/v2/projects/${encodeURIComponent(safeId)}`, {
         headers: authHeaders(accessToken),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
     const payload = (await response.json().catch(() => null));
     if (!response.ok || !payload?.data?.id) {
-        throw new Error(errorMessage(payload, response.status, "workspace fetch failed"));
+        throw new Error(errorMessage(payload, response.status, "project fetch failed"));
     }
     return payload.data;
 }
-export function mintWorkspaceId() {
+export function mintProjectId() {
     const bytes = crypto.getRandomValues(new Uint8Array(16));
     const ms = Date.now();
     bytes[0] = Math.floor(ms / 2 ** 40) & 0xff;
@@ -360,9 +360,9 @@ async function* readSseFrames(body) {
     for (const block of parser.flush())
         yield toFrame(block);
 }
-export async function createWorkspaceViaAsk(baseUrl, accessToken, organizationId, prompt, opts = {}) {
+export async function createProjectViaAsk(baseUrl, accessToken, organizationId, prompt, opts = {}) {
     const safeOrganization = assertSafeOpaqueId("The Organization id", organizationId);
-    const workspaceId = opts.workspaceId ?? mintWorkspaceId();
+    const projectId = opts.projectId ?? mintProjectId();
     const fetchImpl = opts.fetchImpl ?? fetch;
     const response = await fetchImpl(`${baseUrl}/api/v2/ask`, {
         method: "POST",
@@ -371,11 +371,11 @@ export async function createWorkspaceViaAsk(baseUrl, accessToken, organizationId
             "Content-Type": "application/json",
             "X-NuStack-Organization": safeOrganization,
         },
-        body: JSON.stringify({ prompt, workspaceId }),
+        body: JSON.stringify({ prompt, projectId }),
     });
     if (!response.ok || !response.body) {
         const payload = (await response.json().catch(() => null));
-        throw new Error(errorMessage(payload, response.status, "workspace create failed"));
+        throw new Error(errorMessage(payload, response.status, "project create failed"));
     }
     let started = false;
     let turnId = null;
@@ -384,7 +384,7 @@ export async function createWorkspaceViaAsk(baseUrl, accessToken, organizationId
         if (frame.event === "start") {
             started = true;
             turnId = typeof frame.data.turnId === "string" ? frame.data.turnId : null;
-            opts.onPhase?.("Workspace created — writing the first document");
+            opts.onPhase?.("Project created — writing the first document");
         }
         else if (frame.event === "thinking" && typeof frame.data.message === "string") {
             opts.onPhase?.(frame.data.message);
@@ -392,7 +392,7 @@ export async function createWorkspaceViaAsk(baseUrl, accessToken, organizationId
         else if (frame.event === "error") {
             const message = typeof frame.data.message === "string" ? frame.data.message : "generation failed";
             if (!started)
-                throw new Error(`workspace create failed: ${message}`);
+                throw new Error(`project create failed: ${message}`);
             generationError = message;
             break;
         }
@@ -401,12 +401,12 @@ export async function createWorkspaceViaAsk(baseUrl, accessToken, organizationId
         }
     }
     if (!started)
-        throw new Error("workspace create failed: the stream ended before the Workspace was reported");
-    return { workspaceId, turnId, generationError };
+        throw new Error("project create failed: the stream ended before the Project was reported");
+    return { projectId, turnId, generationError };
 }
-async function postWorkspacePublication(baseUrl, accessToken, workspaceId, action, body, idempotencyKey) {
-    const safeId = assertSafeOpaqueId("The Workspace id", workspaceId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/workspaces/${encodeURIComponent(safeId)}/${action}`, {
+async function postProjectPublication(baseUrl, accessToken, projectId, action, body, idempotencyKey) {
+    const safeId = assertSafeOpaqueId("The Project id", projectId);
+    const response = await authorizedFetch(`${baseUrl}/api/v2/projects/${encodeURIComponent(safeId)}/${action}`, {
         method: "POST",
         headers: mutationHeaders(accessToken, idempotencyKey),
         body: JSON.stringify(body),
@@ -414,19 +414,19 @@ async function postWorkspacePublication(baseUrl, accessToken, workspaceId, actio
     });
     const payload = (await response.json().catch(() => null));
     if (!response.ok || payload?.data === undefined) {
-        throw new Error(errorMessage(payload, response.status, `workspace ${action} failed`));
+        throw new Error(errorMessage(payload, response.status, `project ${action} failed`));
     }
     return payload.data;
 }
-export async function publishWorkspace(baseUrl, accessToken, workspaceId, profile, idempotencyKey) {
-    return postWorkspacePublication(baseUrl, accessToken, workspaceId, "publish", profile, idempotencyKey);
+export async function publishProject(baseUrl, accessToken, projectId, profile, idempotencyKey) {
+    return postProjectPublication(baseUrl, accessToken, projectId, "publish", profile, idempotencyKey);
 }
-export async function unpublishWorkspace(baseUrl, accessToken, workspaceId, idempotencyKey) {
-    return postWorkspacePublication(baseUrl, accessToken, workspaceId, "unpublish", {}, idempotencyKey);
+export async function unpublishProject(baseUrl, accessToken, projectId, idempotencyKey) {
+    return postProjectPublication(baseUrl, accessToken, projectId, "unpublish", {}, idempotencyKey);
 }
-export async function listDocuments(baseUrl, accessToken, workspaceId) {
-    const safeId = assertSafeOpaqueId("The Workspace id", workspaceId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/documents?workspaceId=${encodeURIComponent(safeId)}`, {
+export async function listDocuments(baseUrl, accessToken, projectId) {
+    const safeId = assertSafeOpaqueId("The Project id", projectId);
+    const response = await authorizedFetch(`${baseUrl}/api/v2/documents?projectId=${encodeURIComponent(safeId)}`, {
         headers: authHeaders(accessToken),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
@@ -448,9 +448,9 @@ export async function getDocument(baseUrl, accessToken, documentId) {
     }
     return payload.data;
 }
-export async function listHandoffs(baseUrl, accessToken, workspaceId) {
-    const safeId = assertSafeOpaqueId("The Workspace id", workspaceId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/workspaces/${encodeURIComponent(safeId)}/handoffs`, {
+export async function listHandoffs(baseUrl, accessToken, projectId) {
+    const safeId = assertSafeOpaqueId("The Project id", projectId);
+    const response = await authorizedFetch(`${baseUrl}/api/v2/projects/${encodeURIComponent(safeId)}/handoffs`, {
         headers: authHeaders(accessToken),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
@@ -472,13 +472,13 @@ export async function getHandoff(baseUrl, accessToken, handoffId) {
     }
     return payload.data;
 }
-export async function latestHandoff(baseUrl, accessToken, workspaceId) {
-    const handoffs = await listHandoffs(baseUrl, accessToken, workspaceId);
+export async function latestHandoff(baseUrl, accessToken, projectId) {
+    const handoffs = await listHandoffs(baseUrl, accessToken, projectId);
     return handoffs.length > 0 ? handoffs[0] : null;
 }
-export async function createBinding(baseUrl, accessToken, workspaceId, input, idempotencyKey) {
-    const safeId = assertSafeOpaqueId("The Workspace id", workspaceId);
-    const response = await authorizedFetch(`${baseUrl}/api/v2/workspaces/${encodeURIComponent(safeId)}/bindings`, {
+export async function createBinding(baseUrl, accessToken, projectId, input, idempotencyKey) {
+    const safeId = assertSafeOpaqueId("The Project id", projectId);
+    const response = await authorizedFetch(`${baseUrl}/api/v2/projects/${encodeURIComponent(safeId)}/bindings`, {
         method: "POST",
         headers: mutationHeaders(accessToken, idempotencyKey),
         body: JSON.stringify({