@vertesia/client 1.5.0-dev.20260722.120446Z → 1.5.0-dev.20260725.083715Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/client",
-  "version": "1.5.0-dev.20260722.120446Z",
+  "version": "1.5.0-dev.20260725.083715Z",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -12,16 +12,16 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/node": "^24.13.3",
-    "rolldown": "1.1.5",
+    "rolldown": "1.2.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "@vertesia/tsconfig": "0.1.0"
   },
   "dependencies": {
     "eventsource": "^4.1.0",
-    "@llumiverse/common": "1.5.0-dev.20260722.112223Z",
-    "@vertesia/common": "1.5.0-dev.20260722.120446Z",
-    "@vertesia/api-fetch-client": "1.5.0-dev.20260722.120446Z"
+    "@llumiverse/common": "1.5.0-dev.20260725.065646Z",
+    "@vertesia/api-fetch-client": "1.5.0-dev.20260725.083715Z",
+    "@vertesia/common": "1.5.0-dev.20260725.083715Z"
   },
   "exports": {
     ".": {
@@ -48,7 +48,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "203c30e5a8ddc583ac9f1acce0f5445eb38a9551",
+  "gitHead": "57bcc2f27dd17b3387f27c18e89329c4c37f98ac",
   "scripts": {
     "lint": "biome lint src",
     "clean:lib": "rimraf ./lib ./tsconfig.tsbuildinfo",

package/src/AppsApi.test.ts

@@ -106,10 +106,13 @@ describe('AppsApi', () => {
 
         expect(result.commit).toBe('2'.repeat(40));
         const request = requests[0];
-        expect(request?.url).toBe('https://studio.example.com/api/v1/apps/sample-app/repo/documents');
-        expect(request?.headers.get('content-type')).toContain('multipart/form-data; boundary=');
-        const form = await request?.formData();
-        expect(JSON.parse(String(form?.get('metadata')))).toEqual({
+        if (!request) {
+            throw new Error('Expected a multipart document request');
+        }
+        expect(request.url).toBe('https://studio.example.com/api/v1/apps/sample-app/repo/documents');
+        expect(request.headers.get('content-type')).toContain('multipart/form-data; boundary=');
+        const form = await request.formData();
+        expect(JSON.parse(String(form.get('metadata')))).toEqual({
             ref: 'main',
             expected_head: '1'.repeat(40),
             message: 'Add docs',
@@ -118,7 +121,12 @@ describe('AppsApi', () => {
                 { field: 'file_1', path: 'docs/diagram.png' },
             ],
         });
-        expect((form?.get('file_0') as File).name).toBe('guide.md');
-        expect((form?.get('file_1') as File).size).toBe(3);
+        const guideFile = form.get('file_0');
+        const diagramFile = form.get('file_1');
+        if (!(guideFile instanceof File) || !(diagramFile instanceof File)) {
+            throw new Error('Expected multipart file entries');
+        }
+        expect(guideFile.name).toBe('guide.md');
+        expect(diagramFile.size).toBe(3);
     });
 });

package/src/AppsApi.ts

@@ -2,6 +2,8 @@ import { ApiTopic, type ClientBase, type ServerError } from '@vertesia/api-fetch
 import type {
     AppBuildProgress,
     AppDeleteSummary,
+    AppDevelopmentTaskDetails,
+    AppDevelopmentTaskList,
     AppInspectionResult,
     AppInstallation,
     AppInstallationKind,
@@ -12,6 +14,7 @@ import type {
     AppManifestData,
     AppPackage,
     AppPackageScope,
+    AppRepoBranch,
     AppRepoCommits,
     AppRepoDocumentCommit,
     AppRepoRefs,
@@ -21,6 +24,7 @@ import type {
     AppVersionListQuery,
     AppVersionRecord,
     CountResult,
+    CreateAppRepoBranchRequest,
     DeleteAppVersionResponse,
     ProjectRef,
     PromoteAppVersionResponse,
@@ -218,6 +222,21 @@ export default class AppsApi extends ApiTopic {
         return this.get(`/${encodeURIComponent(appIdOrName)}/repo/refs`);
     }
 
+    /** List mutable development tasks represented by `agent/*` repository branches. */
+    listDevelopmentTasks(appIdOrName: string): Promise<AppDevelopmentTaskList> {
+        return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks`);
+    }
+
+    /** Get a development task and its latest parent Studio Assistant run, when started. */
+    getDevelopmentTask(appIdOrName: string, taskId: string): Promise<AppDevelopmentTaskDetails> {
+        return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks/${encodeURIComponent(taskId)}`);
+    }
+
+    /** Create a repository branch from an existing branch, tag, or commit. */
+    createRepoBranch(appIdOrName: string, payload: CreateAppRepoBranchRequest): Promise<AppRepoBranch> {
+        return this.post(`/${encodeURIComponent(appIdOrName)}/repo/branches`, { payload });
+    }
+
     /**
      * Get the promoted package an app exposes, filtered by scope. App-owned (in-code) artifacts are
      * package-resolved (no per-id route), so this is how a client reads the full definition — type

package/src/store/AgentsApi.ts

@@ -1,6 +1,7 @@
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import {
     type ActiveWorkstreamsQueryResult,
+    type AgentArtifactContentResponse,
     type AgentArtifactUrlResponse,
     type AgentEvent,
     type AgentMessage,
@@ -41,6 +42,8 @@ import {
     type ToolParameterAnalyticsResponse,
     type TopPrincipalsAnalyticsResponse,
     toAgentMessage,
+    type UpdateAgentArtifactContentPayload,
+    type UpdateAgentArtifactContentResponse,
     type UpdateAgentRunStatusPayload,
     type WorkflowAnalyticsFilterOptionsResponse,
     type WorkflowAnalyticsSummaryQuery,
@@ -734,6 +737,20 @@ export class AgentsApi extends ApiTopic {
         return this.get(`/${id}/artifacts`, { query });
     }
 
+    /** Read a text artifact together with its conditional-write generation token. */
+    getArtifactContent(id: string, path: string): Promise<AgentArtifactContentResponse> {
+        return this.get(`/${id}/artifact-content/${path}`);
+    }
+
+    /** Conditionally replace the text content of an agent artifact. */
+    updateArtifactContent(
+        id: string,
+        path: string,
+        payload: UpdateAgentArtifactContentPayload,
+    ): Promise<UpdateAgentArtifactContentResponse> {
+        return this.put(`/${id}/artifact-content/${path}`, { payload });
+    }
+
     /**
      * Get a signed download URL for an artifact.
      */

package/src/store/FilesApi.ts

@@ -17,6 +17,7 @@ import type {
 } from '@vertesia/common';
 import { StreamSource } from '../StreamSource.js';
 import { fetchSignedUrl } from './signed-url.js';
+import { getUploadMimeTypeHint, resolveUploadMimeType } from './uploadMimeType.js';
 
 export const MEMORIES_PREFIX = 'memories';
 export const ARTIFACTS_PREFIX = 'agents';
@@ -137,7 +138,7 @@ export class FilesApi extends ApiTopic {
     ): Promise<{ source: string; name: string; type?: string; etag?: string }[]> {
         const fileDescriptors = sources.map((s) => ({
             name: s.name,
-            mime_type: s.type,
+            mime_type: getUploadMimeTypeHint(s.type),
             id: s instanceof StreamSource ? s.id : undefined,
         }));
 
@@ -153,7 +154,7 @@ export class FilesApi extends ApiTopic {
                     const idx = i + j;
                     const { url, id, mime_type } = files[idx];
                     const isStream = source instanceof StreamSource;
-                    const sourceMimeType = source.type || mime_type;
+                    const sourceMimeType = resolveUploadMimeType(source.type, mime_type);
 
                     const res = await fetchSignedUrl(url, {
                         method: 'PUT',
@@ -193,13 +194,18 @@ export class FilesApi extends ApiTopic {
      */
     async uploadFileWithPath(source: StreamSource | File): Promise<{ id: string; path: string }> {
         const isStream = source instanceof StreamSource;
-        const { url, id, path } = await this.getUploadUrl(source);
+        const { url, id, path, mime_type } = await this.getUploadUrl({
+            id: isStream ? source.id : undefined,
+            name: source.name,
+            mime_type: getUploadMimeTypeHint(source.type),
+        });
+        const sourceMimeType = resolveUploadMimeType(source.type, mime_type) || 'application/gzip';
 
         const res = await fetchSignedUrl(url, {
             method: 'PUT',
             body: isStream ? source.stream : source,
             headers: {
-                'Content-Type': source.type || 'application/gzip',
+                'Content-Type': sourceMimeType,
             },
         }).catch((err) => {
             console.error('Failed to upload file', { err, url, id, path });

package/src/store/ObjectsApi.ts

@@ -56,6 +56,7 @@ import { StreamSource } from '../StreamSource.js';
 import { AnalyzeDocApi } from './AnalyzeDocApi.js';
 import type { ZenoClient } from './client.js';
 import { fetchSignedUrl } from './signed-url.js';
+import { getUploadMimeTypeHint, resolveUploadMimeType } from './uploadMimeType.js';
 
 type ContentObjectWritePayload = Omit<CreateContentObjectPayload, 'content'> & {
     content?: ContentSource | File | StreamSource;
@@ -259,9 +260,9 @@ export class ObjectsApi extends ApiTopic {
         const { url, id, mime_type } = await this.getUploadUrl({
             id: isStream ? source.id : undefined,
             name: source.name,
-            mime_type: source.type,
+            mime_type: getUploadMimeTypeHint(source.type),
         });
-        const sourceMimeType = source.type || mime_type;
+        const sourceMimeType = resolveUploadMimeType(source.type, mime_type);
 
         // upload the file content to the signed URL
         const res = await fetchSignedUrl(url, {

package/src/store/uploadMimeType.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+import { getUploadMimeTypeHint, resolveUploadMimeType } from './uploadMimeType.js';
+
+describe('upload MIME type resolution', () => {
+    it('keeps a specific browser-provided content type', () => {
+        expect(getUploadMimeTypeHint('text/plain')).toBe('text/plain');
+        expect(resolveUploadMimeType('text/plain', 'text/markdown')).toBe('text/plain');
+    });
+
+    it('uses filename inference when the browser reports generic binary content', () => {
+        expect(getUploadMimeTypeHint('application/octet-stream')).toBeUndefined();
+        expect(resolveUploadMimeType('application/octet-stream', 'text/markdown')).toBe('text/markdown');
+    });
+
+    it('uses filename inference when the browser omits the content type', () => {
+        expect(resolveUploadMimeType('', 'text/markdown')).toBe('text/markdown');
+    });
+
+    it('retains octet-stream when no more specific type can be inferred', () => {
+        expect(resolveUploadMimeType('application/octet-stream', undefined)).toBe('application/octet-stream');
+    });
+});

package/src/store/uploadMimeType.ts

@@ -0,0 +1,16 @@
+const GENERIC_BINARY_CONTENT_TYPE = 'application/octet-stream';
+
+function normalizedContentType(contentType: string | undefined): string | undefined {
+    return contentType?.split(';', 1)[0]?.trim().toLowerCase() || undefined;
+}
+
+export function getUploadMimeTypeHint(contentType: string | undefined): string | undefined {
+    return normalizedContentType(contentType) === GENERIC_BINARY_CONTENT_TYPE ? undefined : contentType || undefined;
+}
+
+export function resolveUploadMimeType(
+    sourceContentType: string | undefined,
+    inferredContentType: string | undefined,
+): string | undefined {
+    return getUploadMimeTypeHint(sourceContentType) || inferredContentType || sourceContentType || undefined;
+}