archal 0.9.19 → 0.9.20

package/agents/replay-capsule-harness/replay-capsule-e2e.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { randomBytes } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+
+const repo = process.env.ARCHAL_REPLAY_E2E_REPO || 'vercel/next.js';
+const outputPath = resolve(
+  process.env.ARCHAL_REPLAY_E2E_OUT || '/tmp/archal-replay-capsule-otlp.json',
+);
+
+function nowNanos(offsetMs = 0) {
+  return String((Date.now() + offsetMs) * 1_000_000);
+}
+
+function attr(key, value) {
+  return { key, value: { stringValue: typeof value === 'string' ? value : JSON.stringify(value) } };
+}
+
+async function fetchRepoSnapshot() {
+  const response = await fetch(`https://api.github.com/repos/${repo}`, {
+    headers: {
+      accept: 'application/vnd.github+json',
+      'user-agent': 'archal-replay-capsule-e2e',
+    },
+  });
+  if (!response.ok) {
+    throw new Error(`GitHub repo snapshot failed: ${response.status} ${response.statusText}`);
+  }
+  const body = await response.json();
+  return {
+    id: body.id,
+    fullName: body.full_name,
+    private: body.private,
+    archived: body.archived,
+    defaultBranch: body.default_branch,
+    pushedAt: body.pushed_at,
+    openIssuesCount: body.open_issues_count,
+  };
+}
+
+const beforeRepo = await fetchRepoSnapshot();
+const afterRepo = { ...beforeRepo };
+const traceId = randomBytes(16).toString('hex');
+const spanId = randomBytes(8).toString('hex');
+const prompt = `Report whether ${repo} is archived.`;
+// Deliberately wrong when the repository is not archived, so the generated
+// trace is a reproducible failed behavior with a real service snapshot.
+const completion = `${repo} is archived: ${String(!beforeRepo.archived)}`;
+
+const replayCapsule = {
+  schema: 'archal.trace.replay-capsule',
+  version: 1,
+  stateBefore: { github: { repositories: [beforeRepo] } },
+  stateAfter: { github: { repositories: [afterRepo] } },
+  stateDiff: { github: {} },
+  serviceReadSet: [{ service: 'github', type: 'repository', id: beforeRepo.fullName }],
+  resourceRefs: [{ service: 'github', type: 'repository', id: beforeRepo.fullName }],
+  serviceOperations: [{
+    service: 'github',
+    operation: 'repos.get',
+    resourceRefs: [{ service: 'github', type: 'repository', id: beforeRepo.fullName }],
+    response: beforeRepo,
+  }],
+  authPrincipal: { kind: 'anonymous', scopes: [] },
+  modelConfig: { provider: 'local-harness', model: 'deterministic-fixture' },
+  promptBundle: { task: prompt },
+};
+
+const otlpPayload = {
+  resourceSpans: [{
+    resource: {
+      attributes: [
+        attr('service.name', 'archal-replay-capsule-e2e'),
+      ],
+    },
+    scopeSpans: [{
+      scope: { attributes: [] },
+      spans: [{
+        traceId,
+        spanId,
+        name: 'github.repos.get',
+        startTimeUnixNano: nowNanos(-250),
+        endTimeUnixNano: nowNanos(),
+        attributes: [
+          attr('gen_ai.prompt', prompt),
+          attr('gen_ai.completion', completion),
+          attr('archal.replay.capsule', replayCapsule),
+        ],
+      }],
+    }],
+  }],
+};
+
+await mkdir(dirname(outputPath), { recursive: true });
+await writeFile(outputPath, `${JSON.stringify(otlpPayload, null, 2)}\n`);
+
+process.stdout.write(JSON.stringify({
+  ok: true,
+  outputPath,
+  traceId,
+  repo: beforeRepo.fullName,
+  archived: beforeRepo.archived,
+}, null, 2));
+process.stdout.write('\n');

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": {},