agent-devkit 0.6.0 → 0.8.2

package/src/modules/schedules/surface/knowledge.json

@@ -0,0 +1,10 @@
+{
+  "moduleId": "schedules",
+  "summary": "Schedules describe proactive work: a title, the task prompt to run and a cadence (interval in minutes, daily HH:MM or a one-shot timestamp). The agent daemon polls the agenda and dispatches due schedules as task runs.",
+  "facts": [
+    "Schedules are stored as one JSON file per id under ~/.agent-devkit/data/schedules/.",
+    "The cadence kinds are interval (everyMinutes), daily (local HH:MM) and once (ISO timestamp, fires a single time).",
+    "The due action is a pure computation over lastRunAt and the cadence; disabled schedules are never due.",
+    "The daemon records lastRunAt and lastRunId after dispatching a schedule, which drives the next-run math."
+  ]
+}

package/src/modules/schedules/surface/loop.json

@@ -0,0 +1,17 @@
+{
+  "moduleId": "schedules",
+  "mode": "agenda-management",
+  "allowedActions": [
+    "List the persisted schedules with their cadence and next execution.",
+    "Create a schedule on explicit request.",
+    "Update a schedule's title, task, cadence or enabled state on explicit request.",
+    "Remove a schedule on explicit request.",
+    "Compute which schedules are due at a given moment."
+  ],
+  "forbiddenActions": [
+    "Create or change a schedule without an explicit user request.",
+    "Execute the scheduled task directly from this capability.",
+    "Change last-run bookkeeping outside a real daemon dispatch."
+  ],
+  "approvalRequired": true
+}

package/src/modules/schedules/surface/prompt.json

@@ -0,0 +1,10 @@
+{
+  "moduleId": "schedules",
+  "templates": [
+    {
+      "id": "schedules.manage",
+      "template": "Summarize this Agent DevKit schedule operation for the user, highlighting the cadence and the next execution: {{operation}}",
+      "variables": ["operation"]
+    }
+  ]
+}

package/src/modules/schedules/surface/skill.json

@@ -0,0 +1,14 @@
+{
+  "moduleId": "schedules",
+  "purpose": "Manage the persisted agenda: list schedules, create interval/daily/one-shot entries, pause, resume or remove them.",
+  "whenToUse": [
+    "The user wants a task to run automatically at an interval, daily time or specific moment.",
+    "The user wants to see, pause, resume or delete existing schedules.",
+    "The daemon needs to know which schedules are due to run right now."
+  ],
+  "whenNotToUse": [
+    "The user wants to run a task immediately (use the task loop instead).",
+    "The user wants to inspect past runs or goals.",
+    "The user wants to change brain providers or model preferences."
+  ]
+}

package/src/modules/self/surface/knowledge.json

@@ -1,7 +1,11 @@
 {
   "moduleId": "self",
-  "summary": "Self maintenance uses npm metadata and plans global package installation. It must avoid accidental downgrades.",
+  "summary": "Self maintenance uses npm metadata, plans global package installation and can execute Agent DevKit's own CLI commands through a controlled capability.",
   "facts": [
+    "self.cli lists and runs Agent DevKit CLI commands through the capability runtime.",
+    "self.cli executes the current package entrypoint with structured args, not a shell string.",
+    "Read-only CLI commands such as tools, runs, logs and doctor do not require approval.",
+    "Mutating CLI commands require capability approval.",
     "agent update --latest should not downgrade below the running version.",
     "agent update <version> targets an explicit npm version.",
     "update execution requires --yes.",

package/src/modules/self/surface/loop.json

@@ -1,7 +1,18 @@
 {
   "moduleId": "self",
   "mode": "package-maintenance",
-  "allowedActions": ["read-npm-registry", "install-selected-version-after-confirmation"],
-  "forbiddenActions": ["downgrade-on-latest", "install-without-confirmation"],
+  "allowedActions": [
+    "list-agent-devkit-cli-commands",
+    "run-read-only-agent-devkit-cli-commands",
+    "run-mutating-agent-devkit-cli-commands-after-approval",
+    "read-npm-registry",
+    "install-selected-version-after-confirmation"
+  ],
+  "forbiddenActions": [
+    "recursive-self-cli-invocation",
+    "bypass-self-cli-approval-through-shell",
+    "downgrade-on-latest",
+    "install-without-confirmation"
+  ],
   "approvalRequired": true
 }

package/src/modules/self/surface/prompt.json

@@ -5,6 +5,11 @@
       "id": "self.update",
       "template": "Explain this Agent DevKit update plan and whether it will execute: {{plan}}",
       "variables": ["plan"]
+    },
+    {
+      "id": "self.cli",
+      "template": "Summarize this Agent DevKit CLI execution result. Include command, exit code, stdout and stderr when relevant: {{result}}",
+      "variables": ["result"]
     }
   ]
 }

package/src/modules/self/surface/skill.json

@@ -2,10 +2,14 @@
   "moduleId": "self",
   "purpose": "Maintain the Agent DevKit package itself.",
   "whenToUse": [
+    "The user asks the agent to execute one of Agent DevKit's own CLI commands.",
+    "The agent needs to list available Agent DevKit CLI commands.",
     "The user wants to see available npm versions.",
     "The user wants to update Agent DevKit to a selected version."
   ],
   "whenNotToUse": [
+    "The command is not part of the Agent DevKit CLI.",
+    "A mutating CLI command has not been approved.",
     "The user wants to initialize or reset project-local state.",
     "The user wants to run a capability unrelated to package maintenance."
   ]

package/src/assets/design/kit.json

@@ -1,78 +0,0 @@
-{
-  "schema": "agent-devkit.kit/v1",
-  "size": { "rows": 16, "cols": 16 },
-  "palette": {
-    ".": "transparent",
-    "B": "#8B7AE6",
-    "D": "#6354C4",
-    "W": "#F4F3FB",
-    "E": "#211D33",
-    "M": "#2E2742",
-    "C": "#E7A6CB",
-    "A": "#5FD0C8"
-  },
-  "base": [
-    ".....A....A.....",
-    ".....B....B.....",
-    "....BBB..BBB....",
-    "...BBBBBBBBBB...",
-    "..BBBBBBBBBBBB..",
-    ".BBBBBBBBBBBBBB.",
-    ".BBWWWBBBBWWWBB.",
-    ".BBWEWBBBBWEWBB.",
-    ".BBWWWBBBBWWWBB.",
-    ".BBBBBBBBBBBBBB.",
-    ".BBBCBBBBBBCBBB.",
-    ".BBBBBBMMBBBBBB.",
-    "..BBBBBBBBBBBB..",
-    "...BBBBBBBBBB...",
-    "....DD....DD....",
-    "................"
-  ],
-  "blink": {
-    "overrides": [
-      [6, 3, "B"], [6, 4, "B"], [6, 5, "B"], [6, 10, "B"], [6, 11, "B"], [6, 12, "B"],
-      [7, 3, "M"], [7, 4, "M"], [7, 5, "M"], [7, 10, "M"], [7, 11, "M"], [7, 12, "M"],
-      [8, 3, "B"], [8, 4, "B"], [8, 5, "B"], [8, 10, "B"], [8, 11, "B"], [8, 12, "B"]
-    ]
-  },
-  "moods": {
-    "idle": { "overrides": [] },
-    "happy": {
-      "overrides": [
-        [11, 7, "B"], [11, 8, "B"], [11, 6, "M"], [11, 9, "M"], [12, 7, "M"], [12, 8, "M"]
-      ],
-      "badge": "✦"
-    },
-    "thinking": {
-      "overrides": [
-        [6, 3, "W"], [6, 4, "E"], [6, 5, "W"], [6, 10, "W"], [6, 11, "E"], [6, 12, "W"],
-        [7, 3, "W"], [7, 4, "W"], [7, 5, "W"], [7, 10, "W"], [7, 11, "W"], [7, 12, "W"],
-        [8, 3, "W"], [8, 4, "W"], [8, 5, "W"], [8, 10, "W"], [8, 11, "W"], [8, 12, "W"]
-      ],
-      "badge": "?"
-    },
-    "working": { "overrides": [], "badge": "spinner" },
-    "concerned": {
-      "overrides": [
-        [6, 3, "W"], [6, 4, "E"], [6, 5, "W"], [6, 10, "W"], [6, 11, "E"], [6, 12, "W"],
-        [7, 3, "W"], [7, 4, "E"], [7, 5, "W"], [7, 10, "W"], [7, 11, "E"], [7, 12, "W"],
-        [8, 3, "W"], [8, 4, "W"], [8, 5, "W"], [8, 10, "W"], [8, 11, "W"], [8, 12, "W"],
-        [11, 6, "M"], [11, 9, "M"], [10, 4, "B"], [10, 11, "B"]
-      ],
-      "body": "#A88AE8",
-      "badge": "!"
-    },
-    "sleeping": {
-      "overrides": [
-        [6, 3, "B"], [6, 4, "B"], [6, 5, "B"], [6, 10, "B"], [6, 11, "B"], [6, 12, "B"],
-        [7, 3, "M"], [7, 4, "M"], [7, 5, "M"], [7, 10, "M"], [7, 11, "M"], [7, 12, "M"],
-        [8, 3, "B"], [8, 4, "B"], [8, 5, "B"], [8, 10, "B"], [8, 11, "B"], [8, 12, "B"],
-        [11, 7, "B"], [11, 8, "M"], [10, 4, "B"], [10, 11, "B"]
-      ],
-      "body": "#7C77A6",
-      "dark": "#5B567E",
-      "badge": "z"
-    }
-  }
-}