@11agents/cli 0.1.40 → 0.1.42

package/mobile-runtime/skills/android-collect-tiktok-metrics/SKILL.md

@@ -55,6 +55,82 @@ If device, logged-in account, target video, or measurement window is missing, as
 11agents mobile add-metrics --record-id pub_123 --platform tiktok --metric views=0 --json --task-id TASK_123
 ```
 
+6. When a project swarm token is available, map collected TikTok data into `swarm.telemetry.v1` instead of returning only a markdown summary:
+   - Use `platform: "tiktok_public"`.
+   - Account overview rows are `artifact_type: "account_period"`; create one artifact per account/period/date range and put `period`, `period_days`, `date_range`, account id, device id, and evidence paths in payload fields.
+   - Single-video rows are `artifact_type: "video"`; create one artifact per video/profile order/post id and put `profile_order`, `posted_time`, caption/title, account id, device id, and evidence paths in artifact or observation payload fields.
+   - Put numeric analytics in `observations[].metrics`.
+   - Include `dashboard_spec.metric_schema` and set recovered account/video metrics to `aggregation: "snapshot"` so Agent Performance does not sum values that already include a time window.
+   - Include `observation_table` widgets with explicit columns for account period rows and video rows so both account-level and single-video fields are visible.
+
+## Swarm Dashboard Contract
+
+Use explicit snapshot tables for TikTok metrics:
+
+```json
+{
+  "schema_version": "swarm.dashboard.v1",
+  "title": "TikTok Data Collection",
+  "metric_schema": {
+    "post_views": { "label": "Post views", "aggregation": "snapshot" },
+    "profile_views": { "label": "Profile views", "aggregation": "snapshot" },
+    "views": { "label": "Views", "aggregation": "snapshot" },
+    "likes": { "label": "Likes", "aggregation": "snapshot" },
+    "comments": { "label": "Comments", "aggregation": "snapshot" },
+    "shares": { "label": "Shares", "aggregation": "snapshot" },
+    "saves": { "label": "Saves", "aggregation": "snapshot" },
+    "avg_watch_seconds": { "label": "Avg watch", "aggregation": "snapshot", "unit": "seconds" },
+    "watched_full_rate": { "label": "Watched full", "aggregation": "snapshot", "format": "percent" },
+    "new_followers": { "label": "New followers", "aggregation": "snapshot" }
+  },
+  "widgets": [
+    {
+      "id": "account_periods",
+      "title": "Account Period Snapshots",
+      "type": "table",
+      "query": {
+        "kind": "observation_table",
+        "platform": "tiktok_public",
+        "artifact_type": "account_period",
+        "latest_per_artifact": true,
+        "columns": [
+          { "key": "period", "label": "Period", "source": "payload" },
+          { "key": "date_range", "label": "Date range", "source": "payload" },
+          { "key": "post_views", "label": "Post views", "source": "metric" },
+          { "key": "profile_views", "label": "Profile views", "source": "metric" },
+          { "key": "likes", "label": "Likes", "source": "metric" },
+          { "key": "comments", "label": "Comments", "source": "metric" },
+          { "key": "shares", "label": "Shares", "source": "metric" }
+        ]
+      }
+    },
+    {
+      "id": "video_snapshots",
+      "title": "Video Snapshots",
+      "type": "table",
+      "query": {
+        "kind": "observation_table",
+        "platform": "tiktok_public",
+        "artifact_type": "video",
+        "latest_per_artifact": true,
+        "columns": [
+          { "key": "profile_order", "label": "Profile order", "source": "payload" },
+          { "key": "posted_time", "label": "Posted time", "source": "payload" },
+          { "key": "views", "label": "Views", "source": "metric" },
+          { "key": "likes", "label": "Likes", "source": "metric" },
+          { "key": "comments", "label": "Comments", "source": "metric" },
+          { "key": "shares", "label": "Shares", "source": "metric" },
+          { "key": "saves", "label": "Saves", "source": "metric" },
+          { "key": "avg_watch_seconds", "label": "Avg watch", "source": "metric" },
+          { "key": "watched_full_rate", "label": "Watched full", "source": "metric" },
+          { "key": "new_followers", "label": "New followers", "source": "metric" }
+        ]
+      }
+    }
+  ]
+}
+```
+
 ## Output
 
 Return metric status, snapshot ids, account/video target, data freshness, screenshot paths when created, run log path, missing access, and `agent_memory_delta` with reusable creative or account learning.

package/mobile-runtime/skills/mobile-publish-data-collection/SKILL.md

@@ -41,9 +41,85 @@ If records, platform post id/permalink, or analytics access is missing, ask the
 ```
 
 5. Treat X, Facebook, and unsupported platform collectors that return `missing_access` as a valid recovery status. Ask for the relevant API token, analytics export, or manual values, then append with `11agents mobile add-metrics`.
-6. If platform metrics are unavailable, record the missing access and ask for the relevant token/export instead of inventing numbers.
-7. Summarize metrics by platform, account, device, content type, creative pattern, and issue/task id.
-8. Write reusable learning as `agent_memory_delta` for channel agents.
+6. For TikTok account/video recovery, map the data into `swarm.telemetry.v1` when the project swarm token is available:
+   - Use `platform: "tiktok_public"`.
+   - Use `artifact_type: "account_period"` for account overview period/date-range rows.
+   - Use `artifact_type: "video"` for single-video/profile-order rows.
+   - Put period/date range, posted time, profile order, account id, device id, and evidence paths in payload/artifact fields.
+   - Put numeric analytics in `observations[].metrics`.
+   - In `dashboard_spec.metric_schema`, mark windowed/snapshot metrics as `aggregation: "snapshot"` so Agent Performance does not sum them again.
+   - Include `observation_table` widgets for account period snapshots and video snapshots, with explicit columns for every recovered field.
+7. If platform metrics are unavailable, record the missing access and ask for the relevant token/export instead of inventing numbers.
+8. Summarize metrics by platform, account, device, content type, creative pattern, and issue/task id.
+9. Write reusable learning as `agent_memory_delta` for channel agents.
+
+## TikTok Dashboard Contract
+
+TikTok recovery should include account-level and video-level tables in `dashboard_spec`:
+
+```json
+{
+  "schema_version": "swarm.dashboard.v1",
+  "title": "TikTok Data Collection",
+  "metric_schema": {
+    "post_views": { "label": "Post views", "aggregation": "snapshot" },
+    "profile_views": { "label": "Profile views", "aggregation": "snapshot" },
+    "views": { "label": "Views", "aggregation": "snapshot" },
+    "likes": { "label": "Likes", "aggregation": "snapshot" },
+    "comments": { "label": "Comments", "aggregation": "snapshot" },
+    "shares": { "label": "Shares", "aggregation": "snapshot" },
+    "saves": { "label": "Saves", "aggregation": "snapshot" },
+    "avg_watch_seconds": { "label": "Avg watch", "aggregation": "snapshot", "unit": "seconds" },
+    "watched_full_rate": { "label": "Watched full", "aggregation": "snapshot", "format": "percent" },
+    "new_followers": { "label": "New followers", "aggregation": "snapshot" }
+  },
+  "widgets": [
+    {
+      "id": "account_periods",
+      "title": "Account Period Snapshots",
+      "type": "table",
+      "query": {
+        "kind": "observation_table",
+        "platform": "tiktok_public",
+        "artifact_type": "account_period",
+        "latest_per_artifact": true,
+        "columns": [
+          { "key": "period", "label": "Period", "source": "payload" },
+          { "key": "date_range", "label": "Date range", "source": "payload" },
+          { "key": "post_views", "label": "Post views", "source": "metric" },
+          { "key": "profile_views", "label": "Profile views", "source": "metric" },
+          { "key": "likes", "label": "Likes", "source": "metric" },
+          { "key": "comments", "label": "Comments", "source": "metric" },
+          { "key": "shares", "label": "Shares", "source": "metric" }
+        ]
+      }
+    },
+    {
+      "id": "video_snapshots",
+      "title": "Video Snapshots",
+      "type": "table",
+      "query": {
+        "kind": "observation_table",
+        "platform": "tiktok_public",
+        "artifact_type": "video",
+        "latest_per_artifact": true,
+        "columns": [
+          { "key": "profile_order", "label": "Profile order", "source": "payload" },
+          { "key": "posted_time", "label": "Posted time", "source": "payload" },
+          { "key": "views", "label": "Views", "source": "metric" },
+          { "key": "likes", "label": "Likes", "source": "metric" },
+          { "key": "comments", "label": "Comments", "source": "metric" },
+          { "key": "shares", "label": "Shares", "source": "metric" },
+          { "key": "saves", "label": "Saves", "source": "metric" },
+          { "key": "avg_watch_seconds", "label": "Avg watch", "source": "metric" },
+          { "key": "watched_full_rate", "label": "Watched full", "source": "metric" },
+          { "key": "new_followers", "label": "New followers", "source": "metric" }
+        ]
+      }
+    }
+  ]
+}
+```
 
 ## Output
 Return recovered links/metrics, missing analytics access, record ids covered, data freshness, run log path, notable performance patterns, and follow-up tasks for planning.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@11agents/cli",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "11agents local runtime and telemetry CLI",
   "type": "module",
   "bin": {

package/src/commands/runtime.js

@@ -83,7 +83,6 @@ function runtimeDeps(overrides = {}) {
     sleep: overrides.sleep || sleep,
     syncKnowledge: overrides.syncKnowledge || syncKnowledge,
     mcpKnowledgeSync: overrides.mcpKnowledgeSync || mcpKnowledgeSync,
-    cpuCount: overrides.cpuCount ?? os.cpus().length,
   }
 }
 
@@ -248,7 +247,7 @@ export async function scanRuntime(flags = {}) {
   return scan
 }
 
-export async function registerRuntime(flags = {}, deps = {}) {
+export async function registerRuntime(flags = {}, deps = {}, { maxConcurrent } = {}) {
   const { buildRuntimeScan: scanBuilder, log, requestJson: request } = runtimeDeps(deps)
   const config = configFromFlags(flags)
   if (!config.token) throw new Error('GTM_WRITES_TOKEN or --token is required')
@@ -256,9 +255,13 @@ export async function registerRuntime(flags = {}, deps = {}) {
   const scan = await scanBuilder({ env: scanEnvWithOverrides(flags), cliVersion: CLI_VERSION })
   if (!scan.runtimes.length) throw new Error('no local AI runtimes detected on PATH')
 
+  const body = maxConcurrent
+    ? { ...scan, runtimes: scan.runtimes.map(r => ({ ...r, max_concurrent: maxConcurrent })) }
+    : scan
+
   const result = await request('/api/runtime/machines/register', {
     method: 'POST',
-    body: scan,
+    body,
     config,
   })
   log(JSON.stringify(result, null, 2))
@@ -1641,11 +1644,7 @@ async function claimAndRunRuntimeTasks(registration, flags, deps, handlerModule,
   const config = configFromFlags(flags)
   const machineKey = registration?.machine?.machine_key || machineOverride(flags) || ''
 
-  // Each runtime gets (vCPUs - 1) slots so the host stays responsive.
-  // maxConcurrent is honoured when it exceeds the CPU-derived default.
-  const perRuntime = Math.max(1, (deps.cpuCount ?? os.cpus().length) - 1)
-  const effectiveConcurrent = Math.max(maxConcurrent, runtimes.length * perRuntime)
-  const slots = Array.from({ length: effectiveConcurrent }, (_, i) => runtimes[i % runtimes.length])
+  const slots = Array.from({ length: maxConcurrent }, (_, i) => runtimes[i % runtimes.length])
   const results = await Promise.allSettled(
     slots.map(runtime => runOneRuntimeTaskSlot(runtime, config, machineKey, registration, flags, deps, handlerModule, retryState, heartbeatIntervalMs))
   )
@@ -1659,14 +1658,11 @@ async function drainRuntimeTasks(registration, flags, deps, handlerModule, retry
   const config = configFromFlags(flags)
   const machineKey = registration?.machine?.machine_key || machineOverride(flags) || ''
 
-  const perRuntime = Math.max(1, (deps.cpuCount ?? os.cpus().length) - 1)
-  const effectiveConcurrent = Math.max(maxConcurrent, runtimes.length * perRuntime)
-
   let completed = 0
   // Worker pool: each worker loops claiming tasks until the queue is empty,
   // so a fast worker immediately picks up the next task without waiting for
   // slow workers to finish (unlike the old batched Promise.allSettled approach).
-  const workers = Array.from({ length: effectiveConcurrent }, (_, i) => {
+  const workers = Array.from({ length: maxConcurrent }, (_, i) => {
     const runtime = runtimes[i % runtimes.length]
     return (async () => {
       while (true) {
@@ -1686,11 +1682,9 @@ export async function startRuntimeDaemon(flags = {}, deps = {}) {
   const scanIntervalMs = Number(flag(flags, 'scan-interval', '60')) * 1000
   const taskIntervalMs = Number(flag(flags, 'task-interval', flag(flags, 'heartbeat-interval', '15'))) * 1000
   const projectRefreshIntervalMs = Number(flag(flags, 'project-refresh-interval', '1800')) * 1000
-  const cpuCount = resolvedDeps.cpuCount ?? os.cpus().length
-  const cpuDefault = Math.max(1, cpuCount - 1)
   const envMax = Number(process.env.DAEMON_MAX_CONCURRENCY)
-  const envConcurrency = Number.isInteger(envMax) && envMax > 0 && envMax <= cpuCount - 1 ? envMax : null
-  const maxConcurrent = envConcurrency ?? Math.max(1, Number(flag(flags, 'concurrency', String(cpuDefault))) || cpuDefault)
+  const envConcurrency = Number.isInteger(envMax) && envMax > 0 ? envMax : null
+  const maxConcurrent = envConcurrency ?? Math.max(1, Number(flag(flags, 'concurrency', '10')) || 10)
   const once = Boolean(flags.once)
   const handlerPath = flag(flags, 'handler')
 
@@ -1711,7 +1705,7 @@ export async function startRuntimeDaemon(flags = {}, deps = {}) {
   const retryState = createRetryState()
   const uninstallExitHandlers = installCurrentClaimExitHandlers(flags, resolvedDeps)
   try {
-    let registration = await runWithDaemonRetry('register runtime', () => registerRuntime(flags, resolvedDeps), resolvedDeps, retryState)
+    let registration = await runWithDaemonRetry('register runtime', () => registerRuntime(flags, resolvedDeps, { maxConcurrent }), resolvedDeps, retryState)
     await runWithDaemonRetry('recover current claimed task', () => failAllPersistedClaims(
       flags,
       resolvedDeps,

package/src/schema.js

@@ -26,7 +26,9 @@ export function validateTelemetryBatch(input) {
   }
   const artifacts = Array.isArray(input.artifacts) ? input.artifacts : []
   const observations = Array.isArray(input.observations) ? input.observations : []
-  if (!artifacts.length && !observations.length) return fail('artifacts or observations are required')
+  if (!artifacts.length && !observations.length && !isObject(input.dashboard_spec)) {
+    return fail('artifacts, observations, or dashboard_spec are required')
+  }
   for (let i = 0; i < artifacts.length; i += 1) {
     const item = artifacts[i]
     for (const field of ['platform', 'artifact_type', 'external_id', 'created_at']) {
@@ -48,7 +50,7 @@ export function validateTelemetryBatch(input) {
   return { ok: true, batch: { ...input, agent_id: agentId.trim() } }
 }
 
-export function buildTelemetryBatch({ workspace, agent_id, agent_key, node_id, artifacts = [], observations = [] }) {
+export function buildTelemetryBatch({ workspace, agent_id, agent_key, node_id, artifacts = [], observations = [], dashboard_spec = null }) {
   return {
     schema_version: TELEMETRY_SCHEMA_VERSION,
     workspace,
@@ -58,5 +60,6 @@ export function buildTelemetryBatch({ workspace, agent_id, agent_key, node_id, a
     sent_at: new Date().toISOString(),
     artifacts,
     observations,
+    ...(dashboard_spec ? { dashboard_spec } : {}),
   }
 }