@deepseek-ai/dsh-client-file-upload 0.1.6-alpha.1 → 0.1.7-alpha.1

package/lib/client.js

@@ -55,10 +55,11 @@ window.__ModuleLoader__.load({
 				this.name = "RemoteError";
 			}
 		};
-		//#endregion
-		//#region lib/types/protocol.js
-		/** Authenticated raw-byte route owned by the file-upload service. */
-		const FILE_UPLOAD_PATH = "/api/session/uploadFileBinary";
+		/**
+		* Browser-relative form of {@link FILE_UPLOAD_PATH}; see
+		* .agents/notes/implemented/architecture/2026-09-14-web-document-relative-app-routes.md.
+		*/
+		const FILE_UPLOAD_ROUTE = "/api/session/uploadFileBinary".slice(1);
 		//#endregion
 		//#region lib/types/client/runtime.js
 		/** Background browser upload implementation for Blob and byte-stream bodies. */
@@ -180,7 +181,7 @@ window.__ModuleLoader__.load({
 					const query = new URLSearchParams({ sessionId });
 					if (name !== void 0) query.set("name", name);
 					const response = await this.post({
-						path: `${FILE_UPLOAD_PATH}?${query.toString()}`,
+						path: `${FILE_UPLOAD_ROUTE}?${query.toString()}`,
 						body: data,
 						headers: { "content-type": "application/octet-stream" },
 						...signal === void 0 ? {} : { signal },
@@ -204,7 +205,7 @@ window.__ModuleLoader__.load({
 					...request.body instanceof ReadableStream ? { duplex: "half" } : {},
 					...request.signal === void 0 ? {} : { signal: request.signal }
 				};
-				const response = await customFetch(resolveUrl(request.path), init);
+				const response = await customFetch(request.path, init);
 				return {
 					status: response.status,
 					body: await response.text()
@@ -259,7 +260,7 @@ window.__ModuleLoader__.load({
 					}
 					request.signal?.addEventListener("abort", abort, { once: true });
 					const message = {
-						url: resolveUrl(request.path).href,
+						url: new URL(request.path, document.baseURI).href,
 						body: request.body,
 						headers: request.headers ?? {}
 					};
@@ -268,11 +269,6 @@ window.__ModuleLoader__.load({
 				});
 			} };
 		}
-		function resolveUrl(path) {
-			const pageLocation = Reflect.get(globalThis, "location");
-			const origin = typeof pageLocation === "object" && pageLocation !== null && "origin" in pageLocation && typeof pageLocation.origin === "string" ? pageLocation.origin : void 0;
-			return new URL(path, origin === void 0 || origin === "null" ? "http://dsh.internal" : origin);
-		}
 		function parseFileUploadResult(body) {
 			const value = JSON.parse(body);
 			if (!isRecord(value) || typeof value.ok !== "boolean") throw new TypeError("file upload transport returned an invalid result");

package/lib/index.js

@@ -71,6 +71,7 @@ async function* requestBodyChunks(body) {
 //#region lib/types/protocol.js
 /** Authenticated raw-byte route owned by the file-upload service. */
 const FILE_UPLOAD_PATH = "/api/session/uploadFileBinary";
+FILE_UPLOAD_PATH.slice(1);
 //#endregion
 //#region lib/types/index.js
 /** Host file-upload service: streamed intake and Agent-scoped staged receipts. */

package/lib/typert.host.js

@@ -1,19 +1,22 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema = z.object({
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema$value ??= z.object({
   'data': z.string().readonly(),
   'name': z.string().readonly().optional(),
-})
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema = z.object({
+}))
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema$value ??= z.object({
   'receiptId': z.intersection(z.string(), z.unknown()).readonly(),
   'file': z.object({
   'attachmentId': z.intersection(z.string(), z.unknown()),
   'name': z.string(),
   'bytes': z.number(),
 }).readonly(),
-})
+}))
 
 export const TYPERT = {
   package: '@deepseek-ai/dsh-client-file-upload',
@@ -40,7 +43,7 @@ export const TYPERT = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema,
+            create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema,
           },
         },
         {
@@ -50,7 +53,7 @@ export const TYPERT = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-client-file-upload/types#EncodedFileUploadRequest',
-            schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema,
+            create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema,
           },
         },
       ],
@@ -58,7 +61,7 @@ export const TYPERT = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-client-file-upload/types#FileUploadValue',
-        schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema,
+        create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema,
       },
       sourceLocation: {"file":"packages/client/file-upload/src/index.ts","line":106,"column":3},
     },
@@ -155,7 +158,7 @@ export const TYPERT = {
           },
           {
             "name": "AssistantMessage",
-            "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
+            "declaration": "export interface AssistantMessage extends MessageBase {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
           },
           {
             "name": "AssistantProviderMetadata",
@@ -193,6 +196,10 @@ export const TYPERT = {
             "name": "CommandSourceMap",
             "declaration": "export interface CommandSourceMap {\n    user: { kind: 'user'; };\n}"
           },
+          {
+            "name": "CompactionCheckpointSource",
+            "declaration": "export type CompactionCheckpointSource = typeof COMPACT_CHECKPOINT_MARKER & { readonly compactionId: CompactionId; readonly sourceCommandId?: CommandId; };"
+          },
           {
             "name": "CompactionId",
             "declaration": "export type CompactionId = Branded<'CompactionId'>;"
@@ -203,7 +210,7 @@ export const TYPERT = {
           },
           {
             "name": "ContentBlockMap",
-            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
+            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-addition': ToolAdditionBlock;\n    'tool-removal': ToolRemovalBlock;\n}"
           },
           {
             "name": "ContentBlockType",
@@ -221,13 +228,17 @@ export const TYPERT = {
             "name": "ContinuableSubagentDescriptorData",
             "declaration": "export interface ContinuableSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: 'continuable';\n    readonly label: string;\n    readonly agentProvider?: string;\n    readonly agentModel?: string;\n    readonly agentReasoningEffort?: ReasoningEffortId;\n    readonly persona?: string;\n    readonly toolFilter?: ToolRestriction;\n}"
           },
+          {
+            "name": "DeveloperMessage",
+            "declaration": "export interface DeveloperMessage extends MessageBase {\n    readonly role: 'developer';\n}"
+          },
           {
             "name": "EncodedFileUploadRequest",
             "declaration": "export interface EncodedFileUploadRequest {\n    readonly data: string;\n    readonly name?: string;\n}"
           },
           {
             "name": "EpochHeader",
-            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n}"
+            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n    system?: never;\n}"
           },
           {
             "name": "FeedbackCategory",
@@ -329,6 +340,10 @@ export const TYPERT = {
             "name": "JsonValue",
             "declaration": "export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue; };"
           },
+          {
+            "name": "KnownCatalogMode",
+            "declaration": "export type KnownCatalogMode = { readonly mode: 'one-shot'; readonly label?: string; } | { readonly mode: 'continuable'; readonly label: string; };"
+          },
           {
             "name": "LlmCallConfig",
             "declaration": "export interface LlmCallConfig {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}"
@@ -343,7 +358,11 @@ export const TYPERT = {
           },
           {
             "name": "Message",
-            "declaration": "export interface Message {\n    readonly id: MessageId;\n    readonly role: 'system' | 'user' | 'assistant';\n    readonly content: ContentBlock[];\n    readonly source: MessageSource;\n}"
+            "declaration": "export type Message = MessageRoleMap[keyof MessageRoleMap];"
+          },
+          {
+            "name": "MessageBase",
+            "declaration": "export interface MessageBase {\n    readonly id: MessageId;\n    readonly content: readonly ContentBlock[];\n    readonly source: MessageSource;\n}"
           },
           {
             "name": "MessageFeedbackDelete",
@@ -369,13 +388,17 @@ export const TYPERT = {
             "name": "MessageId",
             "declaration": "export type MessageId = Branded<'MessageId'>;"
           },
+          {
+            "name": "MessageRoleMap",
+            "declaration": "export interface MessageRoleMap {\n    system: SystemMessage;\n    developer: DeveloperMessage;\n    user: UserMessage;\n    assistant: AssistantMessage;\n    tool: ToolResultMessage;\n}"
+          },
           {
             "name": "MessageSource",
             "declaration": "export type MessageSource = MessageSourceMap[keyof MessageSourceMap];"
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -435,7 +458,7 @@ export const TYPERT = {
           },
           {
             "name": "Session",
-            "declaration": "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
+            "declaration": "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    readonly firstLifecycleSeq: SessionLogOffset;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent<T>] : []): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
           },
           {
             "name": "SessionEvent",
@@ -443,7 +466,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -503,7 +526,7 @@ export const TYPERT = {
           },
           {
             "name": "SubagentCatalogEvent",
-            "declaration": "export type SubagentCatalogEvent = { readonly version: 0; readonly childId: SessionId; readonly childCreatedAt: number; } & ({ readonly mode: 'one-shot'; readonly label?: string; } | { readonly mode: 'continuable'; readonly label: string; });"
+            "declaration": "export type SubagentCatalogEvent = { readonly childId: SessionId; readonly childCreatedAt: number; } & (({ readonly version: 0; } & KnownCatalogMode) | ({ readonly version: 1; } & (KnownCatalogMode | { readonly mode: 'unknown'; readonly label?: string; })));"
           },
           {
             "name": "SubagentDescriptorBase",
@@ -519,7 +542,7 @@ export const TYPERT = {
           },
           {
             "name": "SurfaceEventType",
-            "declaration": "export type SurfaceEventType = 'system/message' | 'user/message' | 'assistant/message' | 'tool/result';"
+            "declaration": "export type SurfaceEventType = 'system/message' | 'developer/message' | 'user/message' | 'assistant/message' | 'tool/result';"
           },
           {
             "name": "SurfaceIntent",
@@ -531,7 +554,11 @@ export const TYPERT = {
           },
           {
             "name": "SystemMessage",
-            "declaration": "export interface SystemMessage extends Message {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['plugin'];\n}"
+            "declaration": "export interface SystemMessage extends MessageBase {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['system-prompt'];\n}"
+          },
+          {
+            "name": "SystemPromptMessageSource",
+            "declaration": "export interface SystemPromptMessageSource {\n    kind: 'system-prompt';\n}"
           },
           {
             "name": "SystemPromptUpdate",
@@ -585,6 +612,10 @@ export const TYPERT = {
             "name": "TokenUsage",
             "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: number;\n    totalTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    reasoningTokens?: number;\n}"
           },
+          {
+            "name": "ToolAdditionBlock",
+            "declaration": "export interface ToolAdditionBlock {\n    type: 'tool-addition';\n    toolName: string;\n    tool?: never;\n}"
+          },
           {
             "name": "ToolCallBlock",
             "declaration": "export interface ToolCallBlock {\n    type: 'tool-call';\n    id: ToolCallId;\n    name: string;\n    arguments: string;\n}"
@@ -598,20 +629,20 @@ export const TYPERT = {
             "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: ToolCallId;\n}"
           },
           {
-            "name": "ToolRestriction",
-            "declaration": "export interface ToolRestriction {\n    readonly allow?: readonly string[];\n    readonly deny?: readonly string[];\n}"
+            "name": "ToolRemovalBlock",
+            "declaration": "export interface ToolRemovalBlock {\n    type: 'tool-removal';\n    toolName: string;\n}"
           },
           {
-            "name": "ToolResultBlock",
-            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: ToolCallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
+            "name": "ToolRestriction",
+            "declaration": "export interface ToolRestriction {\n    readonly allow?: readonly string[];\n    readonly deny?: readonly string[];\n}"
           },
           {
             "name": "ToolResultMessage",
-            "declaration": "export interface ToolResultMessage extends Message {\n    readonly role: 'user';\n    readonly content: [ToolResultBlock];\n    readonly source: ToolMessageSource;\n}"
+            "declaration": "export interface ToolResultMessage extends MessageBase {\n    readonly role: 'tool';\n    readonly source: ToolMessageSource;\n    readonly toolCallId: ToolCallId;\n    readonly isError?: boolean;\n}"
           },
           {
             "name": "ToolSchema",
-            "declaration": "export interface ToolSchema {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
+            "declaration": "export interface ToolSchema {\n    deferLoading?: true;\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
           },
           {
             "name": "TurnEndCancelCause",
@@ -623,11 +654,11 @@ export const TYPERT = {
           },
           {
             "name": "TurnEndReasonMap",
-            "declaration": "export interface TurnEndReasonMap {\n    completed: { kind: 'completed'; };\n    aborted: { kind: 'aborted'; reason: TurnEndCancelCause; };\n    blocked: { kind: 'blocked'; };\n    error: { kind: 'error'; error: LlmFailure; };\n    'max-tokens': { kind: 'max-tokens'; };\n    interrupted: { kind: 'interrupted'; };\n}"
+            "declaration": "export interface TurnEndReasonMap {\n    completed: { kind: 'completed'; };\n    aborted: { kind: 'aborted'; reason: TurnEndCancelCause; };\n    blocked: { kind: 'blocked'; };\n    error: { kind: 'error'; error: LlmFailure; };\n    'max-tokens': { kind: 'max-tokens'; };\n    interrupted: { kind: 'interrupted'; };\n    forked: { kind: 'forked'; };\n}"
           },
           {
             "name": "UserMessage",
-            "declaration": "export interface UserMessage extends Message {\n    readonly role: 'user';\n}"
+            "declaration": "export interface UserMessage extends MessageBase {\n    readonly role: 'user';\n}"
           }
         ]
       }

package/lib/typert.remote-client.js

@@ -1,19 +1,22 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema = z.object({
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema$value ??= z.object({
   'data': z.string().readonly(),
   'name': z.string().readonly().optional(),
-})
-const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema = z.object({
+}))
+let _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema$value
+const _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema = () => (_deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema$value ??= z.object({
   'receiptId': z.intersection(z.string(), z.unknown()).readonly(),
   'file': z.object({
   'attachmentId': z.intersection(z.string(), z.unknown()),
   'name': z.string(),
   'bytes': z.number(),
 }).readonly(),
-})
+}))
 
 export const TYPERT_REMOTE = {
   package: '@deepseek-ai/dsh-client-file-upload',
@@ -37,7 +40,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema,
+            create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_0$schema,
           },
         },
         {
@@ -47,7 +50,7 @@ export const TYPERT_REMOTE = {
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-client-file-upload/types#EncodedFileUploadRequest',
-            schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema,
+            create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_parameter_1$schema,
           },
         },
       ],
@@ -55,7 +58,7 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-client-file-upload/types#FileUploadValue',
-        schema: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema,
+        create: _deepseek_ai_dsh_client_file_upload_fileUploads_upload_result$schema,
       },
       sourceLocation: {"file":"packages/client/file-upload/src/index.ts","line":106,"column":3},
     },

package/lib/types/client/runtime.d.ts

@@ -5,6 +5,7 @@ import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { FileUploadValue } from '../types.ts';
 import type { FileUploadBody, FileUploadService } from './contract.ts';
 interface FileUploadRequest {
+    /** Document-relative app-owned upload route, query string included. */
     readonly path: string;
     readonly body: FileUploadBody;
     readonly headers?: Readonly<Record<string, string>>;

package/lib/types/client/runtime.js

@@ -2,7 +2,7 @@
 import { Service } from '@deepseek-ai/cordis';
 import { bytesToBase64 } from '@deepseek-ai/dsh-util-crypto';
 import { RemoteError } from '@deepseek-ai/dsh-typert-protocol';
-import { FILE_UPLOAD_PATH } from "../protocol.js";
+import { FILE_UPLOAD_ROUTE } from "../protocol.js";
 /**
  * Self-contained Worker body; its string form becomes the Blob Worker source.
  * @param scope - Worker global used for requests and progress messages.
@@ -112,7 +112,7 @@ export class FileUploadRuntime extends Service {
             if (name !== undefined)
                 query.set('name', name);
             const response = await this.post({
-                path: `${FILE_UPLOAD_PATH}?${query.toString()}`,
+                path: `${FILE_UPLOAD_ROUTE}?${query.toString()}`,
                 body: data,
                 headers: { 'content-type': 'application/octet-stream' },
                 ...(signal === undefined ? {} : { signal }),
@@ -139,7 +139,7 @@ function customTransport(customFetch) {
                 ...(request.body instanceof ReadableStream ? { duplex: 'half' } : {}),
                 ...(request.signal === undefined ? {} : { signal: request.signal }),
             };
-            const response = await customFetch(resolveUrl(request.path), init);
+            const response = await customFetch(request.path, init);
             return { status: response.status, body: await response.text() };
         },
     };
@@ -195,7 +195,8 @@ function workerTransport() {
                 }
                 request.signal?.addEventListener('abort', abort, { once: true });
                 const message = {
-                    url: resolveUrl(request.path).href,
+                    // The Worker's own base is `blob:`, so its request URL must be absolute.
+                    url: new URL(request.path, document.baseURI).href,
                     body: request.body,
                     headers: request.headers ?? {},
                 };
@@ -207,14 +208,6 @@ function workerTransport() {
         },
     };
 }
-function resolveUrl(path) {
-    const pageLocation = Reflect.get(globalThis, 'location');
-    const origin = typeof pageLocation === 'object' && pageLocation !== null
-        && 'origin' in pageLocation && typeof pageLocation.origin === 'string'
-        ? pageLocation.origin
-        : undefined;
-    return new URL(path, origin === undefined || origin === 'null' ? 'http://dsh.internal' : origin);
-}
 function parseFileUploadResult(body) {
     const value = JSON.parse(body);
     if (!isRecord(value) || typeof value.ok !== 'boolean') {

package/lib/types/protocol.d.ts

@@ -1,3 +1,8 @@
 /** Authenticated raw-byte route owned by the file-upload service. */
 export declare const FILE_UPLOAD_PATH = "/api/session/uploadFileBinary";
+/**
+ * Browser-relative form of {@link FILE_UPLOAD_PATH}; see
+ * .agents/notes/implemented/architecture/2026-09-14-web-document-relative-app-routes.md.
+ */
+export declare const FILE_UPLOAD_ROUTE: string;
 //# sourceMappingURL=protocol.d.ts.map

package/lib/types/protocol.js

@@ -1,3 +1,8 @@
 /** Authenticated raw-byte route owned by the file-upload service. */
 export const FILE_UPLOAD_PATH = '/api/session/uploadFileBinary';
+/**
+ * Browser-relative form of {@link FILE_UPLOAD_PATH}; see
+ * .agents/notes/implemented/architecture/2026-09-14-web-document-relative-app-routes.md.
+ */
+export const FILE_UPLOAD_ROUTE = FILE_UPLOAD_PATH.slice(1);
 //# sourceMappingURL=protocol.js.map

package/lib/types/types.d.ts

@@ -18,11 +18,12 @@ export interface FileUploadValue {
 export type FileUploadReceiptId = Branded<'file-upload-receipt-id'>;
 /**
  * Fetch-shaped carrier installed by a page that owns its Host transport.
- * @param input - absolute same-origin upload URL.
+ * @param input - document-relative upload route; a carrier that needs an
+ * absolute URL resolves it against its own base.
  * @param init - raw request body, headers, and cancellation signal.
  * @returns the Host response.
  */
-export type FileUploadFetch = (input: URL, init: RequestInit) => Promise<Response>;
+export type FileUploadFetch = (input: string | URL, init: RequestInit) => Promise<Response>;
 /** Pre-Cordis hook supplied by a page whose Host runs in another execution context. */
 export interface ClientFileUploadHooks {
     readonly fetch: FileUploadFetch;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-file-upload",
   "description": "Agent-scoped browser file upload, streaming intake, and staged receipt service",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -59,23 +59,23 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.1"
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-scope": "^0.1.7-alpha.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.7-alpha.1"
   },
   "scripts": {
     "bundle": "tsdown",