@integrity-labs/agt-cli 0.10.1 → 0.10.2

package/mcp/index.js

@@ -21624,6 +21624,187 @@ server.tool(
     };
   }
 );
+server.tool(
+  "schedule.update",
+  // Lead with user phrasings the agent should match against, then explain
+  // the two modes. Order matters for tool selection.
+  'Update an existing scheduled task. USE THIS TOOL when the user says: "change the schedule for X", "run the daily report at 10am instead of 9am", "pause the standup schedule", "move the weekly digest to Mondays", "make this report more concise", "add a section about X to the daily summary", "tell the Y schedule to also cover Z". Two modes: (1) DIRECT FIELD UPDATES \u2014 set cron_expression/interval/timezone/channel/enabled/name/prompt to change those values directly. (2) LLM DESCRIPTION REWRITE \u2014 pass description_feedback to have the platform rewrite the task prompt based on natural-language feedback (e.g. "make this more concise" or "add a section about the team backlog"). Default for LLM rewrites is preview-then-apply: call once to get the proposed rewrite, show the diff to the user, call again with auto_apply=true on confirmation. Direct field updates apply immediately. The two modes are mutually exclusive \u2014 one request is EITHER a field update OR a description rewrite.',
+  {
+    task_id: external_exports.string().describe("The task ID to update (from schedule.list)"),
+    // Direct-field mode
+    name: external_exports.string().optional().describe("New task display name"),
+    schedule_kind: external_exports.enum(["cron", "every", "at"]).optional().describe(
+      "Schedule type. If changing, must also provide the matching expression field."
+    ),
+    schedule_expr: external_exports.string().optional().describe(
+      'Cron expression (e.g. "0 9 * * 1-5") when schedule_kind is cron'
+    ),
+    schedule_every: external_exports.string().optional().describe(
+      'Interval string (e.g. "30m", "2h") when schedule_kind is every'
+    ),
+    schedule_at: external_exports.string().optional().describe(
+      "ISO 8601 timestamp when schedule_kind is at (one-off task)"
+    ),
+    timezone: external_exports.string().optional().describe('IANA timezone (e.g. "America/Los_Angeles")'),
+    prompt: external_exports.string().optional().describe(
+      "Raw new prompt text. Use description_feedback instead for LLM-assisted rewrites."
+    ),
+    delivery_channel: external_exports.string().optional().describe(
+      'Where results are delivered (e.g. "slack", "telegram", "email")'
+    ),
+    delivery_to: external_exports.string().optional().describe(
+      "Channel/chat/email identifier for delivery"
+    ),
+    enabled: external_exports.boolean().optional().describe(
+      "Set to false to pause the schedule without deleting it"
+    ),
+    // LLM rewrite mode
+    description_feedback: external_exports.string().optional().describe(
+      'Natural-language feedback about how to rewrite the task prompt. Examples: "make this more concise", "add a section covering the team backlog", "focus on blockers instead of progress". Triggers an LLM rewrite \u2014 mutually exclusive with direct prompt updates.'
+    ),
+    auto_apply: external_exports.boolean().optional().describe(
+      "For description_feedback only. Default false (preview the rewrite, then call again with auto_apply: true to commit)."
+    )
+  },
+  async (params) => {
+    const data = await apiPost("/host/schedules/update", {
+      agent_id: AGT_AGENT_ID,
+      ...params
+    });
+    if (params.description_feedback) {
+      const lines = [];
+      lines.push(data.applied ? "\u2705 Applied schedule prompt rewrite" : "\u{1F4CB} Proposed schedule prompt rewrite (preview)");
+      lines.push("");
+      if (data.proposed) {
+        lines.push(`Rationale: ${data.proposed.rationale}`);
+        lines.push("");
+        lines.push("## Before");
+        lines.push("```");
+        lines.push(data.current?.prompt ?? "(empty)");
+        lines.push("```");
+        lines.push("## After");
+        lines.push("```");
+        lines.push(data.proposed.new_prompt);
+        lines.push("```");
+      }
+      if (!data.applied) {
+        lines.push("");
+        lines.push("---");
+        lines.push("Show this diff to the user. If they confirm, call `schedule.update` again with the same `task_id` and `description_feedback` plus `auto_apply: true` to commit the change.");
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    const updatedFields = [];
+    for (const key of ["name", "schedule_kind", "schedule_expr", "schedule_every", "schedule_at", "timezone", "prompt", "delivery_channel", "delivery_to", "enabled"]) {
+      if (params[key] !== void 0) updatedFields.push(key);
+    }
+    const summary = `Updated scheduled task ${params.task_id} (${updatedFields.join(", ") || "no changes"})`;
+    return { content: [{ type: "text", text: summary }] };
+  }
+);
+server.tool(
+  "plugin.list",
+  `List the plugins currently installed on this agent, with their current typed context values and a preview of any freeform overrides. Use this when the user asks "what plugins do I have?", "show me the plugins", "what is the Coding plugin configured with?", or before calling plugin.improve to see what fields exist and what they're set to.`,
+  {},
+  async () => {
+    const data = await apiPost("/host/list-plugins", {
+      agent_id: AGT_AGENT_ID
+    });
+    if (!data.plugins.length) {
+      return { content: [{ type: "text", text: "No plugins installed on this agent." }] };
+    }
+    const lines = [];
+    lines.push(`## Installed Plugins (${data.plugins.length})
+`);
+    for (const p of data.plugins) {
+      lines.push(`### ${p.plugin_name} \`${p.plugin_slug}\` (v${p.version})`);
+      if (p.description) lines.push(p.description);
+      lines.push(`- Skills: ${p.skill_count}`);
+      if (p.has_schema && p.context_field_count > 0) {
+        lines.push(`- Context values:`);
+        for (const [key, val] of Object.entries(p.current_values)) {
+          lines.push(`  - \`${key}\`: ${JSON.stringify(val)}`);
+        }
+      } else if (p.has_schema) {
+        lines.push(`- Context: schema declared but no values set (all defaults)`);
+      } else {
+        lines.push(`- Context: no typed schema (freeform overrides only)`);
+      }
+      if (p.has_overrides) {
+        lines.push(`- Freeform overrides (preview):`);
+        lines.push(`  > ${p.overrides_preview.replace(/\n/g, "\n  > ")}`);
+      }
+      lines.push("");
+    }
+    lines.push("To update any plugin's behavior, use the `plugin.improve` tool with the user's feedback.");
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+);
+server.tool(
+  "plugin.improve",
+  // Description leads with the user phrasings the agent should match against,
+  // then explains the safety rule. Order matters — Claude\'s tool selection
+  // weights the first line of a description heavily.
+  `Update, edit, or add a rule to an installed plugin (e.g. the Coding plugin, the Knowledge Base plugin, the Slack plugin). USE THIS TOOL when the user says any of: "update the X plugin", "add a rule to plugin Y", "tell the X plugin not to do Z", "change the X plugin so it does Y", "the Coding plugin should always/never...", "remember this for the X plugin". This is the ONLY correct way to modify a plugin's behavior. NEVER edit SKILL.md files under .claude/skills/plugin-* directly \u2014 those files are derived from the platform database and your edits will be silently overwritten on the next manager refresh. The platform calls an LLM to translate the user's request into a structured update of the plugin's typed context fields and/or freeform overrides text, then returns a diff for you to show the user. Default flow is preview-then-apply: call once to get the proposed diff, show it to the user, then call again with auto_apply=true if they confirm. Only works for plugins that are actually installed on this agent.`,
+  {
+    plugin_slug: external_exports.string().optional().describe('Plugin slug to improve (e.g. "claude-code-github"). Either this or plugin_id is required.'),
+    plugin_id: external_exports.string().optional().describe("Plugin UUID. Either this or plugin_slug is required."),
+    feedback: external_exports.string().min(1).describe("The user's feedback in natural language. What should the plugin do differently?"),
+    transcript_snippet: external_exports.string().optional().describe("Optional short transcript snippet showing the behavior the user flagged. Helps the LLM understand context. Max 2000 chars."),
+    auto_apply: external_exports.boolean().optional().describe("If true, apply the proposed update immediately without preview. Default false (preview-then-apply). Only set to true after the user has confirmed the proposed diff.")
+  },
+  async (params) => {
+    if (!params.plugin_slug && !params.plugin_id) {
+      return {
+        content: [{ type: "text", text: "Error: either plugin_slug or plugin_id is required." }]
+      };
+    }
+    const data = await apiPost("/host/improve-plugin", {
+      agent_id: AGT_AGENT_ID,
+      plugin_slug: params.plugin_slug,
+      plugin_id: params.plugin_id,
+      feedback: params.feedback,
+      transcript_snippet: params.transcript_snippet,
+      auto_apply: params.auto_apply ?? false
+    });
+    const lines = [];
+    lines.push(data.applied ? "\u2705 Applied plugin context update" : "\u{1F4CB} Proposed plugin context update (preview)");
+    lines.push("");
+    lines.push(`Rationale: ${data.proposed.rationale}`);
+    if (data.proposed.changed_fields.length > 0) {
+      lines.push("");
+      lines.push("## Typed field changes");
+      for (const field of data.proposed.changed_fields) {
+        const before = JSON.stringify(data.current.values[field] ?? null);
+        const after = JSON.stringify(data.proposed.values[field] ?? null);
+        lines.push(`- \`${field}\`: ${before} \u2192 ${after}`);
+      }
+    }
+    if (data.proposed.appended_to_overrides) {
+      lines.push("");
+      lines.push("## Overrides change");
+      const before = data.current.overrides || "(empty)";
+      const after = data.proposed.overrides || "(empty)";
+      lines.push("Before:");
+      lines.push("```");
+      lines.push(before);
+      lines.push("```");
+      lines.push("After:");
+      lines.push("```");
+      lines.push(after);
+      lines.push("```");
+    }
+    if (!data.applied) {
+      lines.push("");
+      lines.push("---");
+      lines.push("Show this diff to the user. If they confirm, call `plugin.improve` again with `auto_apply: true` and the same arguments to apply.");
+    } else {
+      lines.push("");
+      lines.push("Update applied. The manager will re-render the plugin's SKILL.md files on the next refresh cycle.");
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+);
 function groupByStatus(items) {
   const groups = {};
   for (const item of items) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Augmented CLI — agent provisioning and management",
   "type": "module",
   "bin": {