@1claw/mcp 0.59.9 → 0.60.0

package/dist/tools/get_approval.js

@@ -17,16 +17,30 @@ export function getApprovalTool(client) {
                     `Status: ${approval.status}`,
                     `Action: ${approval.action}`,
                 ];
-                if (approval.resource_type)
-                    lines.push(`Resource: ${approval.resource_type}`);
-                if (approval.resource_id)
-                    lines.push(`Resource ID: ${approval.resource_id}`);
+                // These are `target_*`, not `resource_*` — the old names never appeared in
+                // an API response, so this tool showed the action and nothing about what
+                // it was for.
+                if (approval.target_type)
+                    lines.push(`Target: ${approval.target_type}`);
+                if (approval.target_id)
+                    lines.push(`Target ID: ${approval.target_id}`);
+                if (approval.human_summary)
+                    lines.push(`Summary: ${approval.human_summary}`);
+                if (approval.risk_tier)
+                    lines.push(`Risk tier: ${approval.risk_tier}`);
                 if (approval.agent_id)
                     lines.push(`Agent: ${approval.agent_id}`);
                 if (approval.reason)
                     lines.push(`Reason: ${approval.reason}`);
-                if (approval.metadata)
-                    lines.push(`Metadata: ${JSON.stringify(approval.metadata)}`);
+                if (approval.summary && Object.keys(approval.summary).length > 0) {
+                    lines.push(`Details: ${JSON.stringify(approval.summary)}`);
+                }
+                if (approval.payload && Object.keys(approval.payload).length > 0) {
+                    lines.push(`Payload: ${JSON.stringify(approval.payload)}`);
+                }
+                if (approval.decision_reason) {
+                    lines.push(`Decision reason: ${approval.decision_reason}`);
+                }
                 if (approval.decided_by)
                     lines.push(`Decided by: ${approval.decided_by}`);
                 if (approval.decided_at)

package/dist/tools/get_approval.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_approval.js","sourceRoot":"","sources":["../../src/tools/get_approval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,OAAO;QACL,IAAI,EAAE,cAAuB;QAC7B,WAAW,EACT,mDAAmD;QACrD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;SAC7E,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,IAA6B,EAC7B,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC5D,GAAG,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBAE5C,MAAM,KAAK,GAAG;oBACZ,OAAO,QAAQ,CAAC,EAAE,EAAE;oBACpB,WAAW,QAAQ,CAAC,MAAM,EAAE;oBAC5B,WAAW,QAAQ,CAAC,MAAM,EAAE;iBAC7B,CAAC;gBACF,IAAI,QAAQ,CAAC,aAAa;oBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;gBAC9E,IAAI,QAAQ,CAAC,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC7E,IAAI,QAAQ,CAAC,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjE,IAAI,QAAQ,CAAC,MAAM;oBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9D,IAAI,QAAQ,CAAC,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACpF,IAAI,QAAQ,CAAC,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC1E,IAAI,QAAQ,CAAC,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC9C,IAAI,QAAQ,CAAC,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBAEvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,SAAS,CAAC,YAAY,IAAI,CAAC,WAAW,aAAa,CAAC,CAAC;oBACvF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9E,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get_approval.js","sourceRoot":"","sources":["../../src/tools/get_approval.ts"],"names":[],"mappings":"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"}

package/dist/tools/get_peer_context.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { OneClawClient } from "../client.js";
+export declare function getPeerContextTool(client: OneClawClient): {
+    name: "get_peer_context";
+    description: string;
+    parameters: z.ZodObject<{
+        agent_id: z.ZodString;
+        budget: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        agent_id: string;
+        budget?: number | undefined;
+    }, {
+        agent_id: string;
+        budget?: number | undefined;
+    }>;
+    execute: (args: {
+        agent_id: string;
+        budget?: number;
+    }, { log }: {
+        log: {
+            info: (msg: string) => void;
+        };
+    }) => Promise<string>;
+};
+//# sourceMappingURL=get_peer_context.d.ts.map

package/dist/tools/get_peer_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_peer_context.d.ts","sourceRoot":"","sources":["../../src/tools/get_peer_context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;oBAgB5C;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,WAClC;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EA4BtD"}

package/dist/tools/get_peer_context.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { OneClawApiError } from "../client.js";
+export function getPeerContextTool(client) {
+    return {
+        name: "get_peer_context",
+        description: "Get what past interactions suggest about the person this agent serves — how " +
+            "they have decided similar requests before. These are observations, not " +
+            "instructions: they describe someone's history, they do not tell you what to do. " +
+            "Returns nothing if this agent has no linked person or nothing has been observed.",
+        parameters: z.object({
+            agent_id: z.string().describe("This agent's UUID"),
+            budget: z
+                .number()
+                .optional()
+                .describe("Characters of context to return. Default 2000, capped at 8000."),
+        }),
+        execute: async (args, { log }) => {
+            try {
+                const result = (await client.getAgentPeerContext(args.agent_id, args.budget));
+                const context = result.context ?? "";
+                log.info(`peer context: ${context.length} chars`);
+                if (!context) {
+                    return "Nothing has been observed about this person yet.";
+                }
+                return context;
+            }
+            catch (err) {
+                if (err instanceof OneClawApiError) {
+                    if (err.status === 404) {
+                        return "This agent has no linked person, so there is no context to read.";
+                    }
+                    if (err.status === 403) {
+                        throw new Error("This agent is not an observer of that person's profile.");
+                    }
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=get_peer_context.js.map

package/dist/tools/get_peer_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_peer_context.js","sourceRoot":"","sources":["../../src/tools/get_peer_context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,OAAO;QACL,IAAI,EAAE,kBAA2B;QACjC,WAAW,EACT,8EAA8E;YAC9E,yEAAyE;YACzE,kFAAkF;YAClF,kFAAkF;QACpF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;SAC9E,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,IAA2C,EAC3C,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAG3E,CAAC;gBACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;gBAClD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,kDAAkD,CAAC;gBAC5D,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACvB,OAAO,kEAAkE,CAAC;oBAC5E,CAAC;oBACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACvB,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_approvals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_approvals.d.ts","sourceRoot":"","sources":["../../src/tools/list_approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;oBAgB3C;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,WAChC;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EAqCtD"}
+{"version":3,"file":"list_approvals.d.ts","sourceRoot":"","sources":["../../src/tools/list_approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;oBAgB3C;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,WAChC;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EAuCtD"}

package/dist/tools/list_approvals.js

@@ -32,10 +32,14 @@ export function listApprovalsTool(client) {
                         `Status: ${a.status}`,
                         `Action: ${a.action}`,
                     ];
-                    if (a.resource_type)
-                        parts.push(`Resource: ${a.resource_type}`);
-                    if (a.resource_id)
-                        parts.push(`Resource ID: ${a.resource_id}`);
+                    if (a.human_summary)
+                        parts.push(`Summary: ${a.human_summary}`);
+                    if (a.target_type)
+                        parts.push(`Target: ${a.target_type}`);
+                    if (a.target_id)
+                        parts.push(`Target ID: ${a.target_id}`);
+                    if (a.risk_tier)
+                        parts.push(`Risk tier: ${a.risk_tier}`);
                     if (a.agent_id)
                         parts.push(`Agent: ${a.agent_id}`);
                     if (a.reason)

package/dist/tools/list_approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"list_approvals.js","sourceRoot":"","sources":["../../src/tools/list_approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,OAAO;QACL,IAAI,EAAE,gBAAyB;QAC/B,WAAW,EACT,qFAAqF;QACvF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;iBACpD,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;YACvD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,uCAAuC,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,IAAyC,EACzC,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;oBACxC,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,CAAC,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,MAAM,cAAc,CAAC,CAAC;gBAEnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,qBAAqB,CAAC;gBAEzD,OAAO,SAAS;qBACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,KAAK,GAAG;wBACZ,OAAO,CAAC,CAAC,EAAE,EAAE;wBACb,WAAW,CAAC,CAAC,MAAM,EAAE;wBACrB,WAAW,CAAC,CAAC,MAAM,EAAE;qBACtB,CAAC;oBACF,IAAI,CAAC,CAAC,aAAa;wBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;oBAChE,IAAI,CAAC,CAAC,WAAW;wBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;oBAC/D,IAAI,CAAC,CAAC,QAAQ;wBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,MAAM;wBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBAChD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;oBACvC,IAAI,CAAC,CAAC,UAAU;wBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;oBACzD,IAAI,CAAC,CAAC,UAAU;wBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;oBACzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC,CAAC;qBACD,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9E,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list_approvals.js","sourceRoot":"","sources":["../../src/tools/list_approvals.ts"],"names":[],"mappings":"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"}

package/dist/tools/list_connector_presets.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { OneClawClient } from "../client.js";
+export declare function listConnectorPresetsTool(client: OneClawClient): {
+    name: "list_connector_presets";
+    description: string;
+    parameters: z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        category?: string | undefined;
+    }, {
+        category?: string | undefined;
+    }>;
+    execute: (args: {
+        category?: string;
+    }, { log }: {
+        log: {
+            info: (msg: string) => void;
+        };
+    }) => Promise<string>;
+};
+//# sourceMappingURL=list_connector_presets.d.ts.map

package/dist/tools/list_connector_presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_connector_presets.d.ts","sourceRoot":"","sources":["../../src/tools/list_connector_presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAgB9D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;oBAclD;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,WAClB;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EA6CtD"}

package/dist/tools/list_connector_presets.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { OneClawApiError } from "../client.js";
+export function listConnectorPresetsTool(client) {
+    return {
+        name: "list_connector_presets",
+        description: "List the pre-built connectors an agent can be given — Gmail, Slack, GitHub, " +
+            "Notion and others. Each says which scopes it asks for and which hosts the " +
+            "resulting binding may reach. Installing one requires a human.",
+        parameters: z.object({
+            category: z
+                .string()
+                .optional()
+                .describe("Filter by category, e.g. 'communication', 'productivity', 'development'"),
+        }),
+        execute: async (args, { log }) => {
+            try {
+                const result = (await client.listConnectorPresets());
+                let presets = result.presets ?? [];
+                if (args.category) {
+                    presets = presets.filter((p) => p.category === args.category);
+                }
+                log.info(`listed ${presets.length} connector preset(s)`);
+                if (presets.length === 0) {
+                    return args.category
+                        ? `No connectors in category '${args.category}'.`
+                        : "No connectors available.";
+                }
+                return presets
+                    .map((p) => {
+                    const parts = [
+                        `Slug: ${p.slug}`,
+                        `Name: ${p.display_name}`,
+                        `Category: ${p.category}`,
+                        `Description: ${p.description}`,
+                        `Base URL: ${p.base_url}`,
+                    ];
+                    if (p.requires_oauth) {
+                        parts.push(`OAuth provider: ${p.provider_slug}`);
+                        if (p.oauth_scopes.length) {
+                            parts.push(`Scopes: ${p.oauth_scopes.join(", ")}`);
+                        }
+                    }
+                    else {
+                        parts.push("Auth: API key supplied by the user (no OAuth flow)");
+                    }
+                    parts.push(`Docs: ${p.documentation_url}`);
+                    return parts.join("\n");
+                })
+                    .join("\n---\n");
+            }
+            catch (err) {
+                if (err instanceof OneClawApiError && err.status === 403) {
+                    throw new Error(`Access denied: ${err.detail}`);
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=list_connector_presets.js.map

package/dist/tools/list_connector_presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_connector_presets.js","sourceRoot":"","sources":["../../src/tools/list_connector_presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAgB9D,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC5D,OAAO;QACL,IAAI,EAAE,wBAAiC;QACvC,WAAW,EACT,8EAA8E;YAC9E,4EAA4E;YAC5E,+DAA+D;QACjE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;SACvF,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,IAA2B,EAC3B,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,oBAAoB,EAAE,CAA2B,CAAC;gBAC/E,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAChE,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,MAAM,sBAAsB,CAAC,CAAC;gBAEzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,IAAI,CAAC,QAAQ;wBAClB,CAAC,CAAC,8BAA8B,IAAI,CAAC,QAAQ,IAAI;wBACjD,CAAC,CAAC,0BAA0B,CAAC;gBACjC,CAAC;gBAED,OAAO,OAAO;qBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,KAAK,GAAG;wBACZ,SAAS,CAAC,CAAC,IAAI,EAAE;wBACjB,SAAS,CAAC,CAAC,YAAY,EAAE;wBACzB,aAAa,CAAC,CAAC,QAAQ,EAAE;wBACzB,gBAAgB,CAAC,CAAC,WAAW,EAAE;wBAC/B,aAAa,CAAC,CAAC,QAAQ,EAAE;qBAC1B,CAAC;oBACF,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;wBACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;wBACjD,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;4BAC1B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACrD,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;oBACnE,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;oBAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC,CAAC;qBACD,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACzD,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_installed_connectors.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { OneClawClient } from "../client.js";
+export declare function listInstalledConnectorsTool(client: OneClawClient): {
+    name: "list_installed_connectors";
+    description: string;
+    parameters: z.ZodObject<{
+        agent_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agent_id: string;
+    }, {
+        agent_id: string;
+    }>;
+    execute: (args: {
+        agent_id: string;
+    }, { log }: {
+        log: {
+            info: (msg: string) => void;
+        };
+    }) => Promise<string>;
+};
+//# sourceMappingURL=list_installed_connectors.d.ts.map

package/dist/tools/list_installed_connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_installed_connectors.d.ts","sourceRoot":"","sources":["../../src/tools/list_installed_connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAa9D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;oBAWrD;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,WACjB;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EAsCtD"}

package/dist/tools/list_installed_connectors.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { OneClawApiError } from "../client.js";
+export function listInstalledConnectorsTool(client) {
+    return {
+        name: "list_installed_connectors",
+        description: "List the connectors installed on an agent, and whether each is actually usable. " +
+            "An install creates the binding; the binding holds no credential until a human " +
+            "completes the OAuth flow, so 'installed' and 'connected' are different states.",
+        parameters: z.object({
+            agent_id: z.string().describe("Agent UUID"),
+        }),
+        execute: async (args, { log }) => {
+            try {
+                const result = (await client.listInstalledConnectors(args.agent_id));
+                const connectors = result.connectors ?? [];
+                log.info(`listed ${connectors.length} installed connector(s)`);
+                if (connectors.length === 0) {
+                    return "No connectors installed on this agent. Use list_connector_presets to see what is available; a human installs them.";
+                }
+                return connectors
+                    .map((c) => {
+                    const status = c.needs_reauth
+                        ? "needs reconnection — the stored token was rejected"
+                        : c.connected
+                            ? "connected"
+                            : "installed, not yet connected (a human must finish the OAuth flow)";
+                    return [
+                        `Connector: ${c.display_name ?? c.preset_slug}`,
+                        `Binding: ${c.binding_name} (${c.binding_id})`,
+                        `Status: ${status}`,
+                        `Active: ${c.is_active}`,
+                        `Installed: ${c.created_at}`,
+                    ].join("\n");
+                })
+                    .join("\n---\n");
+            }
+            catch (err) {
+                if (err instanceof OneClawApiError) {
+                    if (err.status === 403)
+                        throw new Error(`Access denied: ${err.detail}`);
+                    if (err.status === 404)
+                        throw new Error(`Agent ${args.agent_id} not found.`);
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=list_installed_connectors.js.map

package/dist/tools/list_installed_connectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_installed_connectors.js","sourceRoot":"","sources":["../../src/tools/list_installed_connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAa9D,MAAM,UAAU,2BAA2B,CAAC,MAAqB;IAC/D,OAAO;QACL,IAAI,EAAE,2BAAoC;QAC1C,WAAW,EACT,kFAAkF;YAClF,gFAAgF;YAChF,gFAAgF;QAClF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SAC5C,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,IAA0B,EAC1B,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAElE,CAAC;gBACF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC3C,GAAG,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,MAAM,yBAAyB,CAAC,CAAC;gBAE/D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,OAAO,oHAAoH,CAAC;gBAC9H,CAAC;gBAED,OAAO,UAAU;qBACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY;wBAC3B,CAAC,CAAC,oDAAoD;wBACtD,CAAC,CAAC,CAAC,CAAC,SAAS;4BACX,CAAC,CAAC,WAAW;4BACb,CAAC,CAAC,mEAAmE,CAAC;oBAC1E,OAAO;wBACL,cAAc,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE;wBAC/C,YAAY,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,UAAU,GAAG;wBAC9C,WAAW,MAAM,EAAE;wBACnB,WAAW,CAAC,CAAC,SAAS,EAAE;wBACxB,cAAc,CAAC,CAAC,UAAU,EAAE;qBAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC,CAAC;qBACD,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;oBACxE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAC;gBAC/E,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_notification_targets.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { OneClawClient } from "../client.js";
+export declare function listNotificationTargetsTool(client: OneClawClient): {
+    name: "list_notification_targets";
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: (_args: Record<string, never>, { log }: {
+        log: {
+            info: (msg: string) => void;
+        };
+    }) => Promise<string>;
+};
+//# sourceMappingURL=list_notification_targets.d.ts.map

package/dist/tools/list_notification_targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_notification_targets.d.ts","sourceRoot":"","sources":["../../src/tools/list_notification_targets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAW9D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa;;;;qBAUpD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WACnB;QAAE,GAAG,EAAE;YAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAA;KAAE;EAwCtD"}

package/dist/tools/list_notification_targets.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { OneClawApiError } from "../client.js";
+export function listNotificationTargetsTool(client) {
+    return {
+        name: "list_notification_targets",
+        description: "List where this account's approvals and notifications are delivered — SMS, " +
+            "webhook, email or push. Useful for telling a human why they did not hear " +
+            "about a pending approval. Adding or verifying a target is a human action and " +
+            "has no tool.",
+        parameters: z.object({}),
+        execute: async (_args, { log }) => {
+            try {
+                const result = (await client.listNotificationTargets());
+                const targets = result.targets ?? [];
+                log.info(`listed ${targets.length} notification target(s)`);
+                if (targets.length === 0) {
+                    return "No notification targets configured. Approvals fall back to the account email and any registered mobile devices.";
+                }
+                return targets
+                    .map((t) => {
+                    const c = t.config ?? {};
+                    const destination = c.phone_number ?? c.url ?? c.email ?? c.push_token ?? "(unset)";
+                    const parts = [
+                        `Type: ${t.target_type}`,
+                        `Destination: ${destination}`,
+                        `Events: ${t.events.length === 0 ? "all" : t.events.join(", ")}`,
+                        `Active: ${t.is_active}`,
+                    ];
+                    if (t.target_type === "sms") {
+                        parts.push(t.verified
+                            ? "Verified: yes — can approve tier-1 requests by reply"
+                            : "Verified: no — receives notifications but cannot approve");
+                    }
+                    return parts.join("\n");
+                })
+                    .join("\n---\n");
+            }
+            catch (err) {
+                if (err instanceof OneClawApiError && err.status === 403) {
+                    throw new Error(`Access denied: ${err.detail}`);
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=list_notification_targets.js.map

package/dist/tools/list_notification_targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_notification_targets.js","sourceRoot":"","sources":["../../src/tools/list_notification_targets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAW9D,MAAM,UAAU,2BAA2B,CAAC,MAAqB;IAC/D,OAAO;QACL,IAAI,EAAE,2BAAoC;QAC1C,WAAW,EACT,6EAA6E;YAC7E,2EAA2E;YAC3E,+EAA+E;YAC/E,cAAc;QAChB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EACZ,KAA4B,EAC5B,EAAE,GAAG,EAA4C,EACjD,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAA2B,CAAC;gBAClF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,MAAM,yBAAyB,CAAC,CAAC;gBAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,iHAAiH,CAAC;gBAC3H,CAAC;gBAED,OAAO,OAAO;qBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;oBACzB,MAAM,WAAW,GACf,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC;oBAClE,MAAM,KAAK,GAAG;wBACZ,SAAS,CAAC,CAAC,WAAW,EAAE;wBACxB,gBAAgB,WAAW,EAAE;wBAC7B,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBAChE,WAAW,CAAC,CAAC,SAAS,EAAE;qBACzB,CAAC;oBACF,IAAI,CAAC,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;wBAC5B,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,QAAQ;4BACR,CAAC,CAAC,sDAAsD;4BACxD,CAAC,CAAC,0DAA0D,CAC/D,CAAC;oBACJ,CAAC;oBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC,CAAC;qBACD,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,eAAe,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACzD,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/platform_fleet.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import type { OneClawClient } from "../client.js";
+/**
+ * Read-only and dry-run-only fleet tools.
+ *
+ * A fleet write applies to every agent one template provisioned — a thousand
+ * agents from one call, with no per-agent review. That is a decision for a
+ * human at a terminal (`1claw platform fleet rollout`) or a deliberate SDK
+ * call, not something an agent should be able to do because it seemed like a
+ * good idea mid-conversation. So bulk-patch and pause are deliberately absent
+ * here, and rollout is exposed as a planner: it always sends dry_run, and says
+ * so in its description and its output.
+ */
+export declare function platformGetFleetTool(client: OneClawClient): {
+    name: "platform_get_fleet";
+    description: string;
+    parameters: z.ZodObject<{
+        app_id: z.ZodString;
+        template_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        template_id: string;
+        app_id: string;
+    }, {
+        template_id: string;
+        app_id: string;
+    }>;
+    execute: (args: {
+        app_id: string;
+        template_id: string;
+    }) => Promise<string>;
+};
+export declare function platformListFleetAgentsTool(client: OneClawClient): {
+    name: "platform_list_fleet_agents";
+    description: string;
+    parameters: z.ZodObject<{
+        app_id: z.ZodString;
+        template_id: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        template_id: string;
+        app_id: string;
+        limit?: number | undefined;
+        offset?: number | undefined;
+    }, {
+        template_id: string;
+        app_id: string;
+        limit?: number | undefined;
+        offset?: number | undefined;
+    }>;
+    execute: (args: {
+        app_id: string;
+        template_id: string;
+        limit?: number;
+        offset?: number;
+    }) => Promise<string>;
+};
+export declare function platformPlanFleetRolloutTool(client: OneClawClient): {
+    name: "platform_plan_fleet_rollout";
+    description: string;
+    parameters: z.ZodObject<{
+        app_id: z.ZodString;
+        template_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        template_id: string;
+        app_id: string;
+    }, {
+        template_id: string;
+        app_id: string;
+    }>;
+    execute: (args: {
+        app_id: string;
+        template_id: string;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=platform_fleet.d.ts.map

package/dist/tools/platform_fleet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform_fleet.d.ts","sourceRoot":"","sources":["../../src/tools/platform_fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;;;;GAUG;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;oBAShC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;EAsBhE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;;;;;;;oBAWvC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;EAqBJ;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;oBASxC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;EA2BhE"}

package/dist/tools/platform_fleet.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Read-only and dry-run-only fleet tools.
+ *
+ * A fleet write applies to every agent one template provisioned — a thousand
+ * agents from one call, with no per-agent review. That is a decision for a
+ * human at a terminal (`1claw platform fleet rollout`) or a deliberate SDK
+ * call, not something an agent should be able to do because it seemed like a
+ * good idea mid-conversation. So bulk-patch and pause are deliberately absent
+ * here, and rollout is exposed as a planner: it always sends dry_run, and says
+ * so in its description and its output.
+ */
+export function platformGetFleetTool(client) {
+    return {
+        name: "platform_get_fleet",
+        description: "Fleet summary for a platform template: how many agents it provisioned, how they split across the template versions they were built from, how many are behind, and how many a previous rollout skipped because they were hand-edited. Read-only.",
+        parameters: z.object({
+            app_id: z.string().uuid().describe("The platform app ID"),
+            template_id: z.string().uuid().describe("The template whose fleet to summarise"),
+        }),
+        execute: async (args) => {
+            const f = await client.platformGetFleet(args.app_id, args.template_id);
+            const skew = f.version_skew ?? [];
+            const lines = skew.map((b) => `  v${b.template_version ?? "(unstamped)"}: ${b.agents} agent(s)${b.template_version === f.current_version ? " ← current" : ""}`);
+            return [
+                `Fleet "${f.template_name}" (template ${f.template_id})`,
+                `Current version: ${f.current_version}`,
+                `Agents: ${f.total_agents} — ${f.agents_on_current_version} current, ${f.agents_behind} behind`,
+                `Drifted (hand-edited; a rollout skips these): ${f.drifted_agents}`,
+                skew.length ? `Version skew:\n${lines.join("\n")}` : "",
+                `Bulk-patchable fields: ${(f.bulk_patchable_fields ?? []).join(", ")}`,
+                "Guardrails and capability flags are not bulk-patchable — they stay per-agent.",
+            ]
+                .filter(Boolean)
+                .join("\n");
+        },
+    };
+}
+export function platformListFleetAgentsTool(client) {
+    return {
+        name: "platform_list_fleet_agents",
+        description: "List the agents in a platform template's fleet, with the version each was provisioned from and any fields a rollout skipped. Read-only.",
+        parameters: z.object({
+            app_id: z.string().uuid().describe("The platform app ID"),
+            template_id: z.string().uuid().describe("The template whose fleet to list"),
+            limit: z.number().int().min(1).max(500).optional().describe("Page size (default 50)"),
+            offset: z.number().int().min(0).optional().describe("Offset (default 0)"),
+        }),
+        execute: async (args) => {
+            const res = await client.platformListFleetAgents(args.app_id, args.template_id, args.limit, args.offset);
+            const agents = res.agents ?? [];
+            if (agents.length === 0)
+                return "No agents in this fleet.";
+            const lines = agents.map((a) => {
+                const drift = a.drift_fields ?? [];
+                return `- ${a.name} (${a.agent_id}) v${a.provisioned_from_version ?? "?"}${a.is_current ? " current" : " BEHIND"}${drift.length ? ` drifted: ${drift.join(",")}` : ""}${a.is_active ? "" : " [paused]"}`;
+            });
+            return `${agents.length} agent(s):\n${lines.join("\n")}`;
+        },
+    };
+}
+export function platformPlanFleetRolloutTool(client) {
+    return {
+        name: "platform_plan_fleet_rollout",
+        description: "Plan (dry-run) a fleet rollout: report which agents would be synced to the template's current version and which would be skipped because they were changed outside fleet control. This ALWAYS runs as a dry run and never changes anything. To actually apply a rollout, a human runs `1claw platform fleet rollout`.",
+        parameters: z.object({
+            app_id: z.string().uuid().describe("The platform app ID"),
+            template_id: z.string().uuid().describe("The template to plan a rollout for"),
+        }),
+        execute: async (args) => {
+            // dry_run is set here, not taken from the caller. A tool whose safety
+            // depends on an argument the model chooses is not a safe tool.
+            const r = await client.platformRolloutFleet(args.app_id, args.template_id, {
+                dry_run: true,
+            });
+            const skipped = (r.outcomes ?? []).filter((o) => o.outcome === "skipped_drifted");
+            const detail = skipped
+                .slice(0, 20)
+                .map((s) => `  ${s.agent_id} — ${(s.drift_fields ?? []).join(", ")}`);
+            return [
+                `Dry run — nothing was changed.`,
+                `Would sync ${r.synced} agent(s) to v${r.to_version}.`,
+                `Already current: ${r.already_current}. Would skip ${r.skipped_drifted} hand-edited agent(s).`,
+                skipped.length ? `Skipped:\n${detail.join("\n")}` : "",
+                skipped.length > 20 ? `  … and ${skipped.length - 20} more` : "",
+            ]
+                .filter(Boolean)
+                .join("\n");
+        },
+    };
+}
+//# sourceMappingURL=platform_fleet.js.map

package/dist/tools/platform_fleet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform_fleet.js","sourceRoot":"","sources":["../../src/tools/platform_fleet.ts"],"names":[],"mappings":"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"}

package/dist/tools/proxy_request.d.ts

@@ -19,13 +19,13 @@ export declare function proxyRequestTool(client: LocalDaemonClient): {
         body: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         method: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD";
-        secret_name: string;
         url: string;
+        secret_name: string;
         headers?: Record<string, string> | undefined;
         body?: string | undefined;
     }, {
-        secret_name: string;
         url: string;
+        secret_name: string;
         method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD" | undefined;
         headers?: Record<string, string> | undefined;
         body?: string | undefined;