@markusylisiurunen/tau 0.3.49 → 0.3.51

package/dist/protocol/session_protocol.d.ts

@@ -1,7 +1,15 @@
 import type { AssistantMessage, Message, TextContent, ThinkingContent, Tool, ToolCall } from "@earendil-works/pi-ai";
-export declare const SESSION_PROTOCOL_VERSION: 12;
+export declare const SESSION_PROTOCOL_VERSION: 13;
 export declare const SESSION_PROTOCOL_MAX_EXEC_CAPTURE_BYTES: number;
 export declare const SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_LABEL_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAILS = 1024;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA = 1024;
+export declare const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES: number;
+export declare const SESSION_PROTOCOL_MAX_ATTRIBUTE_VALUE_CHARS = 1024;
 export declare const SESSION_PROTOCOL_MAX_SUBAGENT_ACTIVITIES = 64;
 export declare const SESSION_PROTOCOL_MAX_SUBAGENT_SHORT_TEXT_BYTES = 512;
 export declare const SESSION_PROTOCOL_MAX_SUBAGENT_TOOL_SUBJECT_BYTES: number;
@@ -154,17 +162,30 @@ export type SessionProtocolEphemeralSubmitParams = SessionProtocolSessionIdParam
 export type SessionProtocolEphemeralCloseParams = SessionProtocolSessionIdParams & {
     contextId: string;
 };
+export type SessionProtocolClientToolPresentation = {
+    subject?: string;
+    subjectWrap?: "word" | "character";
+    details?: Array<{
+        text: string;
+        tone?: "added" | "removed";
+        wrap?: "word" | "character";
+    }>;
+    metadata?: string[];
+};
 export type SessionProtocolClientToolAckParams = SessionProtocolSessionIdParams & {
     callId: string;
+    presentation?: SessionProtocolClientToolPresentation;
 };
 export type SessionProtocolClientToolResultParams = SessionProtocolSessionIdParams & {
     callId: string;
 } & ({
     ok: true;
     content: string;
+    presentation?: SessionProtocolClientToolPresentation;
 } | {
     ok: false;
     error: string;
+    presentation?: SessionProtocolClientToolPresentation;
 });
 export type SessionProtocolParamsByMethod = {
     initialize: SessionProtocolInitializeParams;
@@ -889,7 +910,7 @@ export type SessionProtocolClientToolCancelMessage = {
     type: "session.clientTool.cancel";
     sessionId: string;
     callId: string;
-    reason: "aborted" | "timeout" | "client-detached";
+    reason: "aborted" | "timeout" | "client-detached" | "host-failed";
 };
 export type SessionProtocolClientToolMessage = SessionProtocolClientToolCallMessage | SessionProtocolClientToolCancelMessage;
 export type SessionProtocolEphemeralAgentThreadUpdateEvent = {

package/dist/protocol/session_protocol.js

@@ -1,7 +1,15 @@
 import { z } from "zod";
-export const SESSION_PROTOCOL_VERSION = 12;
+export const SESSION_PROTOCOL_VERSION = 13;
 export const SESSION_PROTOCOL_MAX_EXEC_CAPTURE_BYTES = 24 * 1024 * 1024;
 export const SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES = 16 * 1024 * 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES = 1024 * 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_LABEL_BYTES = 16 * 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES = 256 * 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAILS = 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES = 256 * 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA = 1024;
+export const SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES = 16 * 1024;
+export const SESSION_PROTOCOL_MAX_ATTRIBUTE_VALUE_CHARS = 1_024;
 export const SESSION_PROTOCOL_MAX_SUBAGENT_ACTIVITIES = 64;
 export const SESSION_PROTOCOL_MAX_SUBAGENT_SHORT_TEXT_BYTES = 512;
 export const SESSION_PROTOCOL_MAX_SUBAGENT_TOOL_SUBJECT_BYTES = 4 * 1024;
@@ -269,7 +277,7 @@ const environmentVariablesSchema = z
     .record(environmentVariableNameSchema, environmentVariableValueSchema)
     .refine((value) => !("HOME" in value), "HOME is controlled by the execution environment");
 const sessionAttributesSchema = z
-    .record(z.string().min(1).max(64), z.string().max(1_024))
+    .record(z.string().min(1).max(64), z.string().max(SESSION_PROTOCOL_MAX_ATTRIBUTE_VALUE_CHARS))
     .refine((attributes) => Object.keys(attributes).length <= 32, "at most 32 attributes are allowed");
 const processArgumentsSchema = z
     .array(z.string())
@@ -442,7 +450,7 @@ const sessionProtocolClientToolCancelMessageSchema = z
     type: z.literal("session.clientTool.cancel"),
     sessionId: nonEmptyStringSchema,
     callId: nonEmptyStringSchema,
-    reason: z.enum(["aborted", "timeout", "client-detached"]),
+    reason: z.enum(["aborted", "timeout", "client-detached", "host-failed"]),
 })
     .strip();
 const sessionProtocolClientToolMessageSchema = z.discriminatedUnion("type", [
@@ -676,10 +684,43 @@ const sessionProtocolEphemeralCloseParamsSchema = z
     contextId: nonEmptyStringSchema,
 })
     .strip();
+const clientToolPresentationSingleLineSchema = z
+    .string()
+    .refine((value) => !value.includes("\n") && !value.includes("\r"), "must be one line");
+const clientToolPresentationDetailSchema = clientToolPresentationSingleLineSchema.refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES} UTF-8 bytes`);
+const clientToolPresentationMetadataSchema = clientToolPresentationSingleLineSchema.refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES} UTF-8 bytes`);
+const sessionProtocolClientToolPresentationSchema = z
+    .object({
+    subject: z
+        .string()
+        .min(1)
+        .refine((value) => !value.includes("\r"), "must not contain carriage returns")
+        .refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES} UTF-8 bytes`)
+        .optional(),
+    subjectWrap: z.enum(["word", "character"]).optional(),
+    details: z
+        .array(z
+        .object({
+        text: clientToolPresentationDetailSchema,
+        tone: z.enum(["added", "removed"]).optional(),
+        wrap: z.enum(["word", "character"]).optional(),
+    })
+        .strict())
+        .max(SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAILS)
+        .optional(),
+    metadata: z
+        .array(clientToolPresentationMetadataSchema)
+        .max(SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA)
+        .optional(),
+})
+    .strict()
+    .refine((value) => utf8ByteLength(JSON.stringify(value)) <=
+    SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES} UTF-8 bytes`);
 const sessionProtocolClientToolAckParamsSchema = z
     .object({
     sessionId: nonEmptyStringSchema,
     callId: nonEmptyStringSchema,
+    presentation: sessionProtocolClientToolPresentationSchema.optional(),
 })
     .strip();
 const sessionProtocolClientToolResultParamsSchema = z.discriminatedUnion("ok", [
@@ -689,6 +730,7 @@ const sessionProtocolClientToolResultParamsSchema = z.discriminatedUnion("ok", [
         callId: nonEmptyStringSchema,
         ok: z.literal(true),
         content: z.string(),
+        presentation: sessionProtocolClientToolPresentationSchema.optional(),
     })
         .strip(),
     z
@@ -697,6 +739,7 @@ const sessionProtocolClientToolResultParamsSchema = z.discriminatedUnion("ok", [
         callId: nonEmptyStringSchema,
         ok: z.literal(false),
         error: z.string(),
+        presentation: sessionProtocolClientToolPresentationSchema.optional(),
     })
         .strip(),
 ]);
@@ -3247,7 +3290,9 @@ function validateClientToolAckParams(params) {
                 ? "session.clientTool.ack params.sessionId must be a non-empty string"
                 : hasIssue(parsed.error, ["callId"])
                     ? "session.clientTool.ack params.callId must be a non-empty string"
-                    : `session.clientTool.ack params are invalid: ${formatZodError(parsed.error)}`;
+                    : hasIssue(parsed.error, ["presentation"])
+                        ? `session.clientTool.ack params.presentation is invalid: ${formatZodError(parsed.error)}`
+                        : `session.clientTool.ack params are invalid: ${formatZodError(parsed.error)}`;
         return invalidParams(message);
     }
     return { ok: true, value: parsed.data };