agent-devkit 0.5.6 → 0.6.0

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

@@ -0,0 +1,30 @@
+{
+  "moduleId": "memory",
+  "templates": [
+    {
+      "id": "memory.learn",
+      "template": "Store this as global memory only if it is useful beyond the current session. Use active for explicit user instructions and candidate for agent inference: {{content}}",
+      "variables": ["content"]
+    },
+    {
+      "id": "memory.search",
+      "template": "Search global memory for records relevant to: {{query}}",
+      "variables": ["query"]
+    },
+    {
+      "id": "memory.retrieve",
+      "template": "Retrieve ranked global memory for prompt context relevant to: {{query}}",
+      "variables": ["query"]
+    },
+    {
+      "id": "memory.update",
+      "template": "Update the selected memory record with the requested status or metadata change: {{memory}}",
+      "variables": ["memory"]
+    },
+    {
+      "id": "memory.forget",
+      "template": "Forget this memory record by marking it forgotten and preserving the audit trail: {{memoryId}}",
+      "variables": ["memoryId"]
+    }
+  ]
+}

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

@@ -0,0 +1,18 @@
+{
+  "moduleId": "memory",
+  "purpose": "Manage durable global memory that the agent can reuse independently of sessions and projects.",
+  "whenToUse": [
+    "The user explicitly asks the agent to remember something.",
+    "The agent has an inferred learning candidate that should be reviewed later.",
+    "The user wants to approve or reject a knowledge candidate extracted from context.",
+    "The agent needs relevant durable memory before answering or planning.",
+    "The user asks what the agent remembers.",
+    "The user asks to change, reject or forget a stored memory."
+  ],
+  "whenNotToUse": [
+    "The user only wants to inspect raw runtime events.",
+    "The information is a secret or credential.",
+    "The information is only relevant inside the current chat session.",
+    "The user asks for project-specific knowledge promotion."
+  ]
+}

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "runtime",
+  "summary": "Runtime stores persisted agentic runs, goals, events and plans under ~/.agent-devkit/data/runtime.",
+  "facts": [
+    "Each agent chat or task run should create a run.json file.",
+    "Runtime events are append-only JSON Lines entries in events.jsonl.",
+    "Runtime runs audit what the agent did; they are separate from chat session memory.",
+    "Runtime goals group related runs but do not imply autonomous background execution yet."
+  ]
+}

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

@@ -0,0 +1,16 @@
+{
+  "moduleId": "runtime",
+  "mode": "agentic-audit",
+  "allowedActions": [
+    "List and inspect persisted runtime runs.",
+    "List and inspect runtime events.",
+    "Create and update explicit runtime goals.",
+    "Cancel a run when explicitly requested."
+  ],
+  "forbiddenActions": [
+    "Treat a runtime run as durable user knowledge.",
+    "Resume a run by re-executing tools without explicit user command.",
+    "Expose redacted secrets from runtime event payloads."
+  ],
+  "approvalRequired": true
+}

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

@@ -0,0 +1,15 @@
+{
+  "moduleId": "runtime",
+  "templates": [
+    {
+      "id": "runtime.runs",
+      "template": "Explain this Agent DevKit runtime run and highlight tool calls, observations, errors and approval requirements: {{run}}",
+      "variables": ["run"]
+    },
+    {
+      "id": "runtime.goals",
+      "template": "Explain this Agent DevKit runtime goal and its related runs: {{goal}}",
+      "variables": ["goal"]
+    }
+  ]
+}

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

@@ -0,0 +1,14 @@
+{
+  "moduleId": "runtime",
+  "purpose": "Inspect and control persisted Agent DevKit agentic executions and goals.",
+  "whenToUse": [
+    "The user wants to know what the agent did.",
+    "The user wants to inspect tool calls, observations or failures from a run.",
+    "The user wants to create, complete or cancel an explicit agentic goal."
+  ],
+  "whenNotToUse": [
+    "The user wants to search conversation messages.",
+    "The user wants durable learned memory or project knowledge.",
+    "The user wants to execute a capability directly."
+  ]
+}