showrunner-agent-staging 0.2.5-staging.1295 → 0.2.6-staging.1297

package/dist/src/adapter-runner.js

@@ -44,6 +44,7 @@ export function invocationScope(event) {
         canSearch: event.stream.streamSettings.canSearch,
         canReadFiles: event.stream.streamSettings.canReadFiles,
         canReadNotes: event.stream.streamSettings.canReadNotes,
+        canReadToDos: event.stream.streamSettings.canReadToDos,
         canCreateMessages: event.stream.streamSettings.canCreateMessages,
         canCreateFiles: event.stream.streamSettings.canCreateFiles,
         canCreateToDos: event.stream.streamSettings.canCreateToDos,
@@ -134,6 +135,9 @@ class InvocationAdapterClient {
     listFolderContents(folderId, cursor) {
         return this.#client.listFolderContents(this.#event.invocation.id, folderId, cursor);
     }
+    listTodos(status, cursor) {
+        return this.#client.listTodos(this.#event.invocation.id, status, cursor);
+    }
     listNotes(cursor) {
         return this.#client.listNotes(this.#event.invocation.id, cursor);
     }

package/dist/src/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
+import type { ContextTodos, ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
 import type { ActivityOutcome, ActivityType, AgentEvent, AgentInputResponse, ApprovalDecision, ApprovalRiskLevel, CommandResponse, ContextAsset, ContextPage, FileDownloadLink, OutputMessagePiece, QuestionSelectionType } from "./protocol.js";
 import type { Note, TextAttachment } from "./protocol.js";
 export type ContextPageOptions = {
@@ -118,6 +118,7 @@ export interface AdapterClient {
     readRecentContext(options: ContextPageOptions): Promise<ContextPage>;
     searchContext(query: string, options: ContextPageOptions): Promise<ContextPage>;
     listFolderContents(folderId: string, cursor?: string | null): Promise<ContextFolderContents>;
+    listTodos(status?: number, cursor?: string | null): Promise<ContextTodos>;
     listNotes(cursor?: string | null): Promise<ContextNotes>;
     listFolders(streamId?: string, cursor?: string | null): Promise<ContextFolders>;
     readAsset(assetId: string): Promise<ContextAsset>;
@@ -200,6 +201,7 @@ export type AgentStreamScope = {
     canSearch: boolean;
     canReadFiles: boolean;
     canReadNotes: boolean;
+    canReadToDos: boolean;
     canCreateMessages: boolean;
     canCreateFiles: boolean;
     canCreateToDos: boolean;

package/dist/src/agent-tools.d.ts

@@ -22,6 +22,10 @@ export declare const agentToolSchemas: {
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
+    readonly list_todos: z.ZodObject<{
+        status: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
     readonly list_notes: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
@@ -198,7 +202,7 @@ export declare const agentToolSchemas: {
 };
 export type AgentToolName = keyof typeof agentToolSchemas;
 export declare const agentToolDefinitions: {
-    name: "read_thread" | "read_recent" | "search_workspace" | "list_folder_contents" | "list_notes" | "list_folders" | "read_asset" | "upload_file" | "read_note" | "create_note" | "update_note" | "create_task" | "update_task" | "update_task_schedule" | "complete_task";
+    name: "read_thread" | "read_recent" | "search_workspace" | "list_folder_contents" | "list_todos" | "list_notes" | "list_folders" | "read_asset" | "upload_file" | "read_note" | "create_note" | "update_note" | "create_task" | "update_task" | "update_task_schedule" | "complete_task";
     description: string;
     inputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -213,6 +217,9 @@ export declare const agentToolDefinitions: {
     }, z.core.$strip> | z.ZodObject<{
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip> | z.ZodObject<{
+        status: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip> | z.ZodObject<{
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip> | z.ZodObject<{

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
+import type { ContextTodos, ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import type { AgentEventHandler } from "./handler.js";
 import type { AgentModelOption, HostToolCapability, HostToolGrantKey } from "./adapter.js";
@@ -202,6 +202,7 @@ export declare class ExternalAgentClient {
         cursor?: string | null;
         limit?: number;
     }): Promise<ContextPage>;
+    listTodos(invocationId: string, status?: number, cursor?: string | null): Promise<ContextTodos>;
     listNotes(invocationId: string, cursor?: string | null): Promise<ContextNotes>;
     listFolders(invocationId: string, streamId?: string, cursor?: string | null): Promise<ContextFolders>;
     listFolderContents(invocationId: string, folderId: string, cursor?: string | null): Promise<ContextFolderContents>;

package/dist/src/client.js

@@ -1,4 +1,4 @@
-import { contextNotesSchema, contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
+import { contextTodosSchema, contextNotesSchema, contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import { z } from "zod";
 import { resolveAdapterModels } from "./adapter.js";
@@ -337,6 +337,29 @@ export class ExternalAgentClient {
             q: query,
         });
     }
+    async listTodos(invocationId, status, cursor) {
+        const params = new URLSearchParams();
+        if (status !== undefined) {
+            params.set("status", String(status));
+        }
+        if (cursor != null) {
+            params.set("cursor", cursor);
+        }
+        const token = await this.accessToken();
+        const response = await this.#fetch(`${this.#apiBaseUrl}/api/external-agent-gateway/v1/invocations/${invocationId}/context/todos?${params.toString()}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "X-Showrunner-Connector-Version": this.#connectorVersion,
+                "X-Showrunner-Protocol": "1.0",
+            },
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            throw new ExternalAgentError(`http_${response.status}`, "Connector task request failed.", response.status);
+        }
+        return contextTodosSchema.parse(await response.json());
+    }
     async listNotes(invocationId, cursor) {
         const params = new URLSearchParams();
         if (cursor != null) {

package/dist/src/context-tools.d.ts

@@ -18,6 +18,10 @@ export declare const contextToolSchemas: {
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
+    readonly list_todos: z.ZodObject<{
+        status: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
     readonly list_notes: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
@@ -36,8 +40,8 @@ export declare function contextToolDescription(name: ContextToolName): string;
 export declare function contextToolEffect(name: ContextToolName, input: Record<string, unknown>): string;
 /**
  * Whether a context read stays inside what the owner already granted on this stream.
- * An agent's own home stream is implicitly granted every read: it already receives every message
- * posted there, so asking again cannot reach anything it was not handed.
+ * An agent's home stream grants conversation reads implicitly. Task access needs its own grant
+ * because tasks are not included in the messages the agent receives.
  */
 export declare function contextReadIsWithinGrant(name: ContextToolName, scope: AgentStreamScope): boolean;
 /**

package/dist/src/context-tools.js

@@ -16,6 +16,7 @@ export const contextToolSchemas = {
         folderId: uuidSchema.describe("Folder ID returned by list_folders."),
         cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous contents page."),
     }),
+    list_todos: z.object({ status: z.number().int().min(0).max(3).optional().describe("0 pending, 1 completed, 2 failed, 3 in progress. Omit for all."), cursor: cursorSchema }),
     list_notes: z.object({ cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous notes page.") }),
     list_folders: z.object({
         streamId: uuidSchema.optional().describe("A reachable chat ID. Omit for this conversation."),
@@ -41,6 +42,8 @@ export function contextToolDescription(name) {
                 + "Every result carries a messageId you can cite back as a message_reference pill.";
         case "list_folder_contents":
             return "List direct subfolders, files and links in a reachable folder. itemType: 0 folder, 1 file, 2 link. Use folder IDs to navigate, asset IDs with read_asset. Pass nextCursor to continue. Does not list notes or tasks.";
+        case "list_todos":
+            return "List tasks in this conversation with their current status and content. Pass nextCursor to continue.";
         case "list_notes":
             return "List readable notes referenced in this conversation, plus notes this agent created here. Returns IDs, source chat, title and version; use read_note for bodies. Does not discover unreferenced workspace notes. Pass nextCursor to continue.";
         case "list_folders":
@@ -59,6 +62,7 @@ export function contextToolEffect(name, input) {
             return `Search workspace messages for ${query}`;
         }
         case "list_folder_contents": return "List contents of a reachable folder";
+        case "list_todos": return "List tasks in this conversation";
         case "list_notes": return "List notes readable from this conversation";
         case "list_folders": return "List folders in a reachable chat";
         case "read_asset": {
@@ -69,14 +73,15 @@ export function contextToolEffect(name, input) {
 }
 /**
  * Whether a context read stays inside what the owner already granted on this stream.
- * An agent's own home stream is implicitly granted every read: it already receives every message
- * posted there, so asking again cannot reach anything it was not handed.
+ * An agent's home stream grants conversation reads implicitly. Task access needs its own grant
+ * because tasks are not included in the messages the agent receives.
  */
 export function contextReadIsWithinGrant(name, scope) {
-    if (scope.isAgentChat) {
+    if (scope.isAgentChat && name !== "list_todos") {
         return true;
     }
     switch (name) {
+        case "list_todos": return scope.canReadToDos;
         case "list_notes": return scope.canReadNotes;
         case "read_thread": return scope.canReadThreadHistory;
         case "read_recent": return scope.canReadRecentMessages;
@@ -99,6 +104,7 @@ export function contextToolApprovalBody(name, scope) {
             return `Read messages in ${target}`;
         case "search_workspace":
             return `Search messages in ${target}`;
+        case "list_todos": return `List tasks in ${target}`;
         case "list_notes": return `List readable notes in ${target}`;
         case "list_folder_contents":
         case "list_folders": return `Read folders accessible from ${target}`;
@@ -124,6 +130,10 @@ export async function executeContextTool(context, name, untrusted) {
             const input = contextToolSchemas.list_folder_contents.parse(untrusted);
             return toolSuccess(await context.client.listFolderContents(input.folderId, input.cursor));
         }
+        if (name === "list_todos") {
+            const input = contextToolSchemas.list_todos.parse(untrusted);
+            return toolSuccess(await context.client.listTodos(input.status, input.cursor));
+        }
         if (name === "list_notes") {
             const input = contextToolSchemas.list_notes.parse(untrusted);
             return toolSuccess(await context.client.listNotes(input.cursor));

package/dist/src/protocol.d.ts

@@ -148,6 +148,7 @@ export declare const agentEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodObject<{
             canSearch: z.ZodDefault<z.ZodBoolean>;
             canReadFiles: z.ZodDefault<z.ZodBoolean>;
             canReadNotes: z.ZodDefault<z.ZodBoolean>;
+            canReadToDos: z.ZodDefault<z.ZodBoolean>;
             canCreateMessages: z.ZodDefault<z.ZodBoolean>;
             canCreateFiles: z.ZodDefault<z.ZodBoolean>;
             canCreateToDos: z.ZodDefault<z.ZodBoolean>;
@@ -687,4 +688,16 @@ export declare const contextNotesSchema: z.ZodObject<{
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type ContextNotes = z.infer<typeof contextNotesSchema>;
+export declare const contextTodosSchema: z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        todoId: z.ZodString;
+        streamId: z.ZodString;
+        pieces: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        status: z.ZodNumber;
+        instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+export type ContextTodos = z.infer<typeof contextTodosSchema>;
 export {};

package/dist/src/protocol.js

@@ -153,6 +153,7 @@ const eventEnvelopeSchema = z.object({
             canSearch: z.boolean().default(false),
             canReadFiles: z.boolean().default(false),
             canReadNotes: z.boolean().default(false),
+            canReadToDos: z.boolean().default(false),
             canCreateMessages: z.boolean().default(false),
             canCreateFiles: z.boolean().default(false),
             canCreateToDos: z.boolean().default(false),
@@ -167,6 +168,7 @@ const eventEnvelopeSchema = z.object({
             canSearch: false,
             canReadFiles: false,
             canReadNotes: false,
+            canReadToDos: false,
             canCreateMessages: false,
             canCreateFiles: false,
             canCreateToDos: false,
@@ -384,3 +386,12 @@ export const contextNotesSchema = z.object({
     notes: z.array(z.object({ noteId: z.string().uuid(), streamId: z.string().uuid(), title: z.string().nullable(), version: z.number().int() })),
     nextCursor: z.string().uuid().nullable(),
 });
+export const contextTodosSchema = z.object({
+    todos: z.array(z.object({
+        todoId: z.string().uuid(), streamId: z.string().uuid(),
+        pieces: z.array(z.record(z.string(), z.unknown())),
+        status: z.number().int().min(0).max(3),
+        instruction: z.string().nullable().optional(),
+    }).passthrough()).max(75),
+    nextCursor: z.string().nullable(), hasMore: z.boolean(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "showrunner-agent-staging",
-  "version": "0.2.5-staging.1295",
+  "version": "0.2.6-staging.1297",
   "description": "Provider-neutral connector SDK for Showrunner agents",
   "type": "module",
   "main": "dist/src/index.js",