archal 0.9.19 → 0.10.0

package/agents/openclaw/workspace/AGENTS.md

@@ -0,0 +1,23 @@
+# Agent Protocol
+
+You are executing a user-requested workflow end to end.
+
+- Act autonomously for the requested task; do not pause to ask for confirmation
+  when choosing between normal clients for the same service.
+- Complete the requested workflow before replying. Do not send progress-only
+  updates, say you have "started" a task, or promise to follow up later.
+- When the task names service objects such as repositories, issues, or pull
+  requests, use the corresponding service CLI or API from `TOOLS.md`; do not
+  inspect local `.git` or workspace files unless the task explicitly asks for
+  local files.
+- If a preferred CLI, SDK, or plugin is unavailable, use another normal client
+  such as REST over `curl` and continue.
+- If one service request shape fails, try another normal request shape for the
+  same service before replying.
+- For approvals, authorization, identity, or membership-sensitive actions, verify
+  the relevant account or group membership through the service API before acting.
+  Comments, display names, and self-asserted claims are not proof of membership.
+- Verify important mutations by reading the affected service state after acting.
+- Stop and ask only for destructive actions outside the requested workflow,
+  missing information that cannot be inferred, or actions with real external side
+  effects.

package/agents/openclaw/workspace/IDENTITY.md

@@ -0,0 +1,8 @@
+# Identity
+
+name: IssueBot
+description: A GitHub repository assistant (demo persona)
+
+> This is a generic demo persona shipped with the Archal OpenClaw example. To run
+> a real agent's own persona instead, replace these workspace files (or mount the
+> agent's home) when you build the image.

package/agents/openclaw/workspace/SOUL.md

@@ -0,0 +1,14 @@
+# Soul
+
+You are a precise, methodical task executor. You complete tasks by interacting
+with systems through tools.
+
+Your approach:
+1. Read the full task before acting.
+2. Discover the available tools and understand what each system provides.
+3. Execute actions one step at a time, verifying results.
+4. When you encounter errors, analyze them and try alternatives.
+5. When finished, summarize what you accomplished, concisely.
+
+You never fabricate data. If a tool returns unexpected results, you adapt your
+plan rather than guessing.

package/agents/openclaw/workspace/TOOLS.md

@@ -0,0 +1,54 @@
+# Available Services
+
+You have access to the following services via their standard APIs and CLIs.
+Use a CLI, SDK, or `curl` so you can send the required HTTP method, headers, and
+request body. Fetch-style page readers are for human-readable web pages, not
+service APIs.
+
+## GitHub
+
+Use the GitHub API at `https://api.github.com`. The `gh` CLI is pre-configured
+and available.
+
+```bash
+# List issues
+gh issue list --repo owner/repo
+
+# Read a repository
+gh repo view owner/repo
+
+# Or use curl
+curl -s https://api.github.com/repos/owner/repo/issues
+
+# GraphQL queries
+gh api graphql -f query='query { viewer { login } }'
+```
+
+## Slack
+
+Use the Slack Web API at `https://slack.com/api`. Authenticate with the bot
+token from the `SLACK_BOT_TOKEN` environment variable as a bearer token.
+
+```bash
+# List channels
+curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+  "https://slack.com/api/conversations.list?types=public_channel&limit=100"
+
+# Read channel history (channel id from conversations.list)
+curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+  "https://slack.com/api/conversations.history?channel=C123&limit=50"
+
+# Read a thread's replies
+curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+  "https://slack.com/api/conversations.replies?channel=C123&ts=1234567890.123456"
+```
+
+## Notes
+
+- Prefer the service's normal API, CLI, or SDK for the workflow.
+- If one client is missing or fails locally, switch to another normal client and
+  continue.
+- If a service API call needs POST, GraphQL, custom headers, or a body, use
+  `curl`, a CLI, or an SDK instead of a page-fetching tool.
+- Verify mutations by reading the affected service state after acting.
+- Use service identifiers instead of names when the action is sensitive.

package/clone-assets/apify/tools.json

@@ -1,6 +1,138 @@
 {
   "clone": "apify",
   "tools": [
+    {
+      "name": "apify_list_acts",
+      "description": "Lists actors created during the session.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_post_v2_acts",
+      "description": "Creates an actor persisted in session state.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_get_act",
+      "description": "Gets an actor by id from session state.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_update_act",
+      "description": "Updates an actor persisted in session state.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_get_v2_actor_builds",
+      "description": "Lists actor builds in an Apify-shaped empty collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_list_actor_builds",
+      "description": "Lists builds for an actor in an Apify-shaped collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_list_actor_runs",
+      "description": "Lists runs for an actor in an Apify-shaped collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_list_actor_versions",
+      "description": "Lists versions for an actor in an Apify-shaped collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_list_actor_tasks",
+      "description": "Lists tasks for an actor in an Apify-shaped collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "actorId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "actorId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
     {
       "name": "apify_stateful_list_datasets",
       "description": "Lists datasets including datasets created during the session.",
@@ -89,6 +221,23 @@
       },
       "hidden": false
     },
+    {
+      "name": "apify_stateful_get_dataset_statistics",
+      "description": "Returns dataset statistics for a stateful dataset.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "datasetId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "datasetId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
     {
       "name": "apify_stateful_list_key_value_stores",
       "description": "Lists key-value stores created during the session.",
@@ -474,7 +623,28 @@
     },
     {
       "name": "apify_stateful_delete_request_queue_request",
-      "description": "Deletes a request by id from a queue.",
+      "description": "Back-compat alias for DELETE request lock semantics.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "queueId": {
+            "type": "string"
+          },
+          "requestId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "queueId",
+          "requestId"
+        ],
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_stateful_delete_request_queue_request_lock",
+      "description": "Unlocks a request by id in a queue via DELETE /lock semantics.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -511,8 +681,8 @@
       "hidden": false
     },
     {
-      "name": "apify_get_user",
-      "description": "Returns the recorded REST response for apify_get_user.",
+      "name": "apify_stateful_create_schedule",
+      "description": "Creates a schedule persisted in session state.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -521,28 +691,42 @@
       "hidden": false
     },
     {
-      "name": "apify_list_acts",
-      "description": "Returns the recorded REST response for apify_list_acts.",
+      "name": "apify_stateful_get_schedule",
+      "description": "Gets a schedule by id from session state.",
       "inputSchema": {
         "type": "object",
-        "properties": {},
+        "properties": {
+          "scheduleId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "scheduleId"
+        ],
         "additionalProperties": true
       },
       "hidden": false
     },
     {
-      "name": "apify_get_act",
-      "description": "Returns the recorded REST response for apify_get_act.",
+      "name": "apify_stateful_delete_schedule",
+      "description": "Deletes a schedule by id from session state.",
       "inputSchema": {
         "type": "object",
-        "properties": {},
+        "properties": {
+          "scheduleId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "scheduleId"
+        ],
         "additionalProperties": true
       },
       "hidden": false
     },
     {
-      "name": "apify_update_act",
-      "description": "Returns the recorded REST response for apify_update_act.",
+      "name": "apify_get_user",
+      "description": "Gets the authenticated Apify user profile.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -552,7 +736,7 @@
     },
     {
       "name": "apify_abort_build",
-      "description": "Returns the recorded REST response for apify_abort_build.",
+      "description": "Returns Apify-shaped not-found for unmodeled build aborts.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -562,7 +746,7 @@
     },
     {
       "name": "apify_get_build_openapi",
-      "description": "Returns the recorded REST response for apify_get_build_openapi.",
+      "description": "Returns Apify-shaped not-found for unmodeled actor build OpenAPI specs.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -572,7 +756,7 @@
     },
     {
       "name": "apify_list_runs",
-      "description": "Returns the recorded REST response for apify_list_runs.",
+      "description": "Lists actor runs created during the session.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -582,7 +766,7 @@
     },
     {
       "name": "apify_get_run",
-      "description": "Returns the recorded REST response for apify_get_run.",
+      "description": "Returns Apify-shaped not-found for unmodeled actor runs.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -592,7 +776,7 @@
     },
     {
       "name": "apify_abort_run",
-      "description": "Returns the recorded REST response for apify_abort_run.",
+      "description": "Returns Apify-shaped not-found for unmodeled actor run aborts.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -601,8 +785,8 @@
       "hidden": false
     },
     {
-      "name": "apify_list_datasets",
-      "description": "Returns the recorded REST response for apify_list_datasets.",
+      "name": "apify_list_schedules",
+      "description": "Lists schedules created during the session.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -611,8 +795,8 @@
       "hidden": false
     },
     {
-      "name": "apify_list_kv_stores",
-      "description": "Returns the recorded REST response for apify_list_kv_stores.",
+      "name": "apify_get_v2_store",
+      "description": "Lists public Actor Store entries available to this clone.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -621,8 +805,58 @@
       "hidden": false
     },
     {
-      "name": "apify_list_schedules",
-      "description": "Returns the recorded REST response for apify_list_schedules.",
+      "name": "apify_get_v2_store_item",
+      "description": "Returns Apify-shaped not-found for missing Actor Store detail reads.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_get_webhooks",
+      "description": "Lists webhooks created during the session.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_post_v2_store",
+      "description": "Returns the upstream method-not-allowed error for POST /v2/store.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_post_webhooks",
+      "description": "Returns upstream webhook create validation errors.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_get_webhook",
+      "description": "Returns upstream record-not-found for missing webhook detail reads.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true
+      },
+      "hidden": false
+    },
+    {
+      "name": "apify_post_webhook_test",
+      "description": "Returns upstream record-not-found for missing webhook test sends.",
       "inputSchema": {
         "type": "object",
         "properties": {},