ap-apps

ap-apps

When to use

• An app bundle (.agentproto/APP.md — agents + WORKFLOW.md files) needs installing, applying to a scope, or running.
• You must run an app's agents one-at-a-time (scout → tailor pipelines) or all at once.
• You need to read/write an app's scoped data or fetch its artifact/skill content.

Install → apply → run

// 1. Install from the emitted app directory (validates ALL WORKFLOW.md tool ids up front)
app_install({ "dir": "/path/to/app" })
// → { "appId": "@agentproto/code-team", ... }

// 2. Apply to a scope (default 'root') — makes its capabilities available there
app_apply({ "appId": "@agentproto/code-team" })

// 3. Run: all agents concurrently (default)
app_run({ "appId": "@agentproto/code-team", "prompt": "Review the auth module" })

//    ...or one-at-a-time in order — each waits for the previous to finish
app_run({ "appId": "@agentproto/scout-tailor",
  "sequence": ["scout", "tailor"] })

// 4. Poll / stop
app_status({ "appRunId": "run_..." })   // live session descriptors + workflow runs
app_stop({ "appRunId": "run_..." })     // kills every session in the run, marks ended

app_install validates every WORKFLOW.md tool id against the daemon's dispatchable tools all at once — you get the full missing-id list, not one failure at a time. Re-installing the same appId upserts. The mastra-agent adapter must resolve for agent steps.

Catalog, artifacts, data

app_catalog({})                                        // browsable apps merged with install status
app_list({})                                           // installed apps + run history
app_artifact_get({ "appId": "..." })                   // artifact HTML (daemon exposes it, host writes it)
app_skill_get({ "appId": "..." })                      // skill files (utf-8; binaries skipped with a warning)

app_data_list({ "appId": "...", "dir": "data/jobs" })  // entries under the app dir
app_data_read({ "appId": "...", "path": "data/state.json" })
app_data_write({ "appId": "...", "path": "data/state.json", "content": { "ok": true } })