@agent-native/dispatch 0.0.0-beta-20260819155526

package/src/actions/import-agent-pack.ts

@@ -0,0 +1,146 @@
+import crypto from "node:crypto";
+
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  AGENT_PACK_MAX_FILE_BYTES,
+  AGENT_PACK_MAX_FILES,
+  agentPackProfileContent,
+  agentPackRoot,
+  normalizeAgentPack,
+  type AgentPackFileInput,
+} from "../lib/agent-pack.js";
+import { validateImportedAgentTools } from "../lib/simple-agent-profile.js";
+import { applyAgentPackCreate } from "../server/lib/agent-pack-store.js";
+import {
+  createApprovalRequest,
+  getApprovalPolicy,
+} from "../server/lib/dispatch-store.js";
+import {
+  listWorkspaceResources,
+  type WorkspaceResourceInput,
+} from "../server/lib/workspace-resources-store.js";
+
+const packFileSchema = z.object({
+  path: z.string().trim().min(1).max(240),
+  content: z.string().max(AGENT_PACK_MAX_FILE_BYTES),
+});
+
+const schema = z.object({
+  files: z
+    .array(packFileSchema)
+    .min(1)
+    .max(AGENT_PACK_MAX_FILES)
+    .describe("Text files from an agent folder, including its profile"),
+  scope: z
+    .enum(["all", "selected"])
+    .default("all")
+    .describe("Make the pack available to all apps or selected apps"),
+});
+
+function availableToolNames(dispatchToolNames: string[]): Set<string> {
+  return new Set([
+    ...dispatchToolNames,
+    "agent-teams",
+    "bash",
+    "call-agent",
+    "db-query",
+    "db-schema",
+    "refresh-screen",
+    "resources",
+    "set-search-params",
+    "set-url-path",
+    "tool-search",
+    "web-request",
+    "web-search",
+  ]);
+}
+
+export default defineAction({
+  description:
+    "Import a folder-backed agent pack from Claude, Cowork, or another agent tool. The pack can include a Markdown/JSON profile, context, references, and skills. Credentials, hooks, shell commands, and local environment settings are never imported.",
+  schema,
+  run: async ({ files, scope }) => {
+    const normalized = normalizeAgentPack(files as AgentPackFileInput[]);
+    const { dispatchActions } = await import("./index.js");
+    const toolValidation = validateImportedAgentTools(
+      normalized.profile.tools,
+      availableToolNames(Object.keys(dispatchActions)),
+    );
+    const warnings = [...normalized.warnings, ...toolValidation.warnings];
+    const sourceHash = crypto
+      .createHash("sha256")
+      .update(JSON.stringify(files))
+      .digest("hex");
+    const profileContent = agentPackProfileContent({
+      profile: normalized.profile,
+      tools: toolValidation.tools,
+      sourceHash,
+      importedAt: new Date().toISOString(),
+    });
+    const root = agentPackRoot(normalized.profile.slug);
+    const inputs: WorkspaceResourceInput[] = [
+      {
+        kind: "agent",
+        name: normalized.profile.name,
+        description: normalized.profile.description,
+        path: `${root}.md`,
+        content: profileContent,
+        scope,
+      },
+      ...normalized.files.map((file) => ({
+        kind: file.kind,
+        name: file.name,
+        description: file.description,
+        path: `${root}/${file.path}`,
+        content: file.content,
+        scope,
+      })),
+    ];
+    const existing = await listWorkspaceResources();
+    const existingProfile = existing.find(
+      (resource) => resource.path === `${root}.md`,
+    );
+    if (existingProfile?.content.includes(`source-hash: ${sourceHash}`)) {
+      return {
+        status: "unchanged" as const,
+        resource: existingProfile,
+        files: existing.filter((resource) =>
+          resource.path.startsWith(`${root}/`),
+        ),
+        warnings,
+      };
+    }
+    if (existingProfile) {
+      throw new Error(
+        `An agent already exists at ${root}. Rename the source before importing it.`,
+      );
+    }
+
+    const policy = await getApprovalPolicy();
+    if (scope === "all" && policy.enabled) {
+      const approval = await createApprovalRequest({
+        changeType: "workspace-agent-pack.create",
+        targetType: "workspace-agent-pack",
+        summary: `Import All-app agent pack "${normalized.profile.name}"`,
+        payload: { inputs },
+        beforeValue: null,
+        afterValue: {
+          name: normalized.profile.name,
+          path: `${root}.md`,
+          fileCount: inputs.length,
+        },
+      });
+      return { status: "pending-approval" as const, approval, warnings };
+    }
+
+    const created = await applyAgentPackCreate(inputs);
+    return {
+      status: "created" as const,
+      resource: created[0] ?? null,
+      files: created.slice(1),
+      warnings,
+    };
+  },
+});

package/src/actions/import-agent.ts

@@ -0,0 +1,102 @@
+import crypto from "node:crypto";
+
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  buildSimpleAgentContent,
+  normalizeImportedAgent,
+  validateImportedAgentTools,
+} from "../lib/simple-agent-profile.js";
+import {
+  createWorkspaceResource,
+  listWorkspaceResources,
+} from "../server/lib/workspace-resources-store.js";
+
+export default defineAction({
+  description:
+    "Import a Claude-style Markdown agent or a generic JSON agent definition into a reusable Dispatch agent profile. Credentials, shell commands, hooks, and local environment settings are never imported. Use connect-external-agent for an HTTP/A2A endpoint.",
+  schema: z.object({
+    source: z
+      .string()
+      .min(1)
+      .max(200_000)
+      .describe("Pasted Markdown or JSON agent definition"),
+    fileName: z
+      .string()
+      .max(512)
+      .optional()
+      .describe("Original file name, such as .claude/agents/research.md"),
+    scope: z
+      .enum(["all", "selected"])
+      .default("all")
+      .describe("Make the profile available to all apps or selected apps"),
+  }),
+  run: async ({ source, fileName, scope }) => {
+    const normalized = normalizeImportedAgent(source, fileName);
+    const { dispatchActions } = await import("./index.js");
+    const availableToolNames = new Set([
+      ...Object.keys(dispatchActions),
+      "agent-teams",
+      "bash",
+      "call-agent",
+      "db-query",
+      "db-schema",
+      "refresh-screen",
+      "resources",
+      "set-search-params",
+      "set-url-path",
+      "tool-search",
+      "web-request",
+      "web-search",
+    ]);
+    const toolValidation = validateImportedAgentTools(
+      normalized.tools,
+      availableToolNames,
+    );
+    const warnings = [...normalized.warnings, ...toolValidation.warnings];
+    const sourceHash = crypto.createHash("sha256").update(source).digest("hex");
+    const content = buildSimpleAgentContent({
+      ...normalized,
+      tools: toolValidation.tools,
+      source: normalized.source,
+      sourcePath: normalized.sourcePath,
+      sourceHash,
+      importedAt: new Date().toISOString(),
+    });
+    const path = `agents/${normalized.slug}.md`;
+    const existing = (await listWorkspaceResources({ kind: "agent" })).find(
+      (resource) => resource.path === path,
+    );
+
+    if (existing) {
+      if (existing.content.includes(`source-hash: ${sourceHash}`)) {
+        return {
+          status: "unchanged" as const,
+          resource: existing,
+          source: normalized.source,
+          warnings,
+        };
+      }
+      throw new Error(
+        `An agent already exists at ${path}. Rename the source before importing it.`,
+      );
+    }
+
+    const resource = await createWorkspaceResource({
+      kind: "agent",
+      name: normalized.name,
+      description: normalized.description,
+      path,
+      content,
+      scope,
+    });
+
+    return {
+      status: "created" as const,
+      resource,
+      source: normalized.source,
+      warnings,
+    };
+  },
+});

package/src/actions/index.spec.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from "vitest";
+
+import { dispatchActions } from "./index.js";
+
+describe("dispatch action registry", () => {
+  it("keeps workspace resources runtime-inherited instead of exposing sync actions", () => {
+    expect(dispatchActions).toHaveProperty("list-workspace-resources-for-app");
+    expect(dispatchActions).toHaveProperty("connect-external-agent");
+    expect(dispatchActions).toHaveProperty("import-agent");
+    expect(dispatchActions).toHaveProperty("list-mcp-app-access");
+    expect(dispatchActions).toHaveProperty("set-mcp-app-access");
+    expect(dispatchActions).toHaveProperty("list_apps");
+    expect(dispatchActions).toHaveProperty("ask_app");
+    expect(dispatchActions).toHaveProperty("ask_app_status");
+    expect(dispatchActions).toHaveProperty("open_app");
+    expect(dispatchActions).toHaveProperty("create_embed_session");
+    expect(dispatchActions).toHaveProperty(
+      "create-workspace-app-embed-session",
+    );
+    expect(dispatchActions).toHaveProperty("read-slack-thread-context");
+    expect(dispatchActions).toHaveProperty(
+      "get-workspace-resource-effective-context",
+    );
+    expect(dispatchActions).toHaveProperty("grant-workspace-resources-to-app");
+    expect(dispatchActions).toHaveProperty("sync-vault-to-app");
+
+    expect(dispatchActions).not.toHaveProperty(
+      "sync-workspace-resources-to-app",
+    );
+    expect(dispatchActions).not.toHaveProperty(
+      "sync-workspace-resources-to-all",
+    );
+    expect(
+      Object.keys(dispatchActions).filter((name) =>
+        name.startsWith("sync-workspace-resources"),
+      ),
+    ).toEqual([]);
+  });
+
+  it("exposes folder-backed agent pack actions", () => {
+    expect(dispatchActions).toHaveProperty("import-agent-pack");
+    expect(dispatchActions).toHaveProperty("list-agent-pack");
+    expect(dispatchActions["import-agent-pack"].tool.description).toContain(
+      "folder-backed agent pack",
+    );
+  });
+
+  it("distinguishes mounted workspace apps from connected A2A agents", () => {
+    expect(dispatchActions["list-workspace-apps"].tool.description).toContain(
+      "not the hosted/connected A2A agent registry",
+    );
+    expect(dispatchActions["list-workspace-apps"].tool.description).toContain(
+      "list-connected-agents",
+    );
+    expect(dispatchActions["list-connected-agents"].tool.description).toContain(
+      "A2A delegation",
+    );
+  });
+});

package/src/actions/index.ts

@@ -0,0 +1,210 @@
+import type { ActionEntry } from "@agent-native/core/server";
+
+import applyDreamProposal from "./apply-dream-proposal.js";
+import approveDispatchChange from "./approve-dispatch-change.js";
+import approveVaultRequest from "./approve-vault-request.js";
+import archiveWorkspaceApp from "./archive-workspace-app.js";
+import askApp from "./ask_app.js";
+import askAppStatus from "./ask_app_status.js";
+import connectExternalAgent from "./connect-external-agent.js";
+import createBrowserChatSession from "./create-browser-chat-session.js";
+import createDreamReport from "./create-dream-report.js";
+import createLinkToken from "./create-link-token.js";
+import createPylonTicket from "./create-pylon-ticket.js";
+import createVaultGrant from "./create-vault-grant.js";
+import createVaultSecret from "./create-vault-secret.js";
+import createWorkspaceResourceGrant from "./create-workspace-resource-grant.js";
+import createWorkspaceResource from "./create-workspace-resource.js";
+import createEmbedSession from "./create_embed_session.js";
+import createWorkspaceAppEmbedSession from "./create_workspace_app_embed_session.js";
+import deleteDestination from "./delete-destination.js";
+import deleteStagedDataset from "./delete-staged-dataset.js";
+import deleteVaultSecret from "./delete-vault-secret.js";
+import deleteWorkspaceResource from "./delete-workspace-resource.js";
+import denyVaultRequest from "./deny-vault-request.js";
+import ensureDreamJob from "./ensure-dream-job.js";
+import getAgentThreadDebug from "./get-agent-thread-debug.js";
+import getAppCreationSettings from "./get-app-creation-settings.js";
+import getDispatchSettings from "./get-dispatch-settings.js";
+import getDreamSettings from "./get-dream-settings.js";
+import getDream from "./get-dream.js";
+import getVaultAccessSettings from "./get-vault-access-settings.js";
+import getWorkspaceInfo from "./get-workspace-info.js";
+import getWorkspaceResourceEffectiveContext from "./get-workspace-resource-effective-context.js";
+import grantVaultSecretsToApp from "./grant-vault-secrets-to-app.js";
+import grantWorkspaceResourcesToApp from "./grant-workspace-resources-to-app.js";
+import importAgentPack from "./import-agent-pack.js";
+import importAgent from "./import-agent.js";
+import listAgentPack from "./list-agent-pack.js";
+import listAgentRunFailures from "./list-agent-run-failures.js";
+import listAgentThreadSources from "./list-agent-thread-sources.js";
+import listAvailableWorkspaceTemplates from "./list-available-workspace-templates.js";
+import listConnectedAgents from "./list-connected-agents.js";
+import listCuratedWorkspaceTemplates from "./list-curated-workspace-templates.js";
+import listDestinations from "./list-destinations.js";
+import listDispatchApprovals from "./list-dispatch-approvals.js";
+import listDispatchAudit from "./list-dispatch-audit.js";
+import listDispatchOverview from "./list-dispatch-overview.js";
+import listDispatchUsageMetrics from "./list-dispatch-usage-metrics.js";
+import listDreamCandidates from "./list-dream-candidates.js";
+import listDreams from "./list-dreams.js";
+import listIntegrationsCatalog from "./list-integrations-catalog.js";
+import listLinkedIdentities from "./list-linked-identities.js";
+import listMcpAppAccess from "./list-mcp-app-access.js";
+import listStagedDatasets from "./list-staged-datasets.js";
+import listVaultAudit from "./list-vault-audit.js";
+import listVaultGrants from "./list-vault-grants.js";
+import listVaultRequests from "./list-vault-requests.js";
+import listVaultSecretOptions from "./list-vault-secret-options.js";
+import listVaultSecrets from "./list-vault-secrets.js";
+import listWorkspaceApps from "./list-workspace-apps.js";
+import listWorkspaceResourceGrants from "./list-workspace-resource-grants.js";
+import listWorkspaceResourceOptions from "./list-workspace-resource-options.js";
+import listWorkspaceResourcesForApp from "./list-workspace-resources-for-app.js";
+import listWorkspaceResources from "./list-workspace-resources.js";
+import listApps from "./list_apps.js";
+import navigate from "./navigate.js";
+import openApp from "./open_app.js";
+import previewDreamProposal from "./preview-dream-proposal.js";
+import previewWorkspaceResourceChange from "./preview-workspace-resource-change.js";
+import providerApiCatalog from "./provider-api-catalog.js";
+import providerApiDocs from "./provider-api-docs.js";
+import providerApiRegister from "./provider-api-register.js";
+import providerApiRequest from "./provider-api-request.js";
+import queryStagedDataset from "./query-staged-dataset.js";
+import readSlackThreadContext from "./read-slack-thread-context.js";
+import rejectDispatchChange from "./reject-dispatch-change.js";
+import rejectDreamProposal from "./reject-dream-proposal.js";
+import remixWorkspaceTemplate from "./remix-workspace-template.js";
+import removePendingWorkspaceApp from "./remove-pending-workspace-app.js";
+import requestVaultSecret from "./request-vault-secret.js";
+import resolveIntegrationSourceContext from "./resolve-integration-source-context.js";
+import restoreStarterWorkspaceResources from "./restore-starter-workspace-resources.js";
+import revokeVaultGrant from "./revoke-vault-grant.js";
+import revokeWorkspaceResourceGrant from "./revoke-workspace-resource-grant.js";
+import scaffoldWorkspaceApp from "./scaffold-workspace-app.js";
+import searchAgentThreads from "./search-agent-threads.js";
+import sendCodeAgentRemoteCommand from "./send-code-agent-remote-command.js";
+import sendPlatformMessage from "./send-platform-message.js";
+import setAppCreationSettings from "./set-app-creation-settings.js";
+import setDispatchApprovalPolicy from "./set-dispatch-approval-policy.js";
+import setDreamSettings from "./set-dream-settings.js";
+import setMcpAppAccess from "./set-mcp-app-access.js";
+import setVaultAccessSettings from "./set-vault-access-settings.js";
+import startWorkspaceAppCreation from "./start-workspace-app-creation.js";
+import syncVaultToApp from "./sync-vault-to-app.js";
+import unarchiveWorkspaceApp from "./unarchive-workspace-app.js";
+import updateVaultSecret from "./update-vault-secret.js";
+import updateWorkspaceAppMetadata from "./update-workspace-app-metadata.js";
+import updateWorkspaceResource from "./update-workspace-resource.js";
+import upsertDestination from "./upsert-destination.js";
+import viewScreen from "./view-screen.js";
+
+/**
+ * Dispatch's actions registered as a flat name→entry map. Imported by
+ * `@agent-native/dispatch/server`'s side-effect block, which calls
+ * `registerPackageActions(dispatchActions)` so the framework's action
+ * loader picks them up.
+ */
+export const dispatchActions: Record<string, ActionEntry> = {
+  "approve-dispatch-change": approveDispatchChange,
+  "approve-vault-request": approveVaultRequest,
+  "archive-workspace-app": archiveWorkspaceApp,
+  ask_app: askApp,
+  ask_app_status: askAppStatus,
+  "connect-external-agent": connectExternalAgent,
+  "create-link-token": createLinkToken,
+  "create-pylon-ticket": createPylonTicket,
+  "create-vault-grant": createVaultGrant,
+  "create-vault-secret": createVaultSecret,
+  "create-workspace-resource-grant": createWorkspaceResourceGrant,
+  "create-workspace-resource": createWorkspaceResource,
+  "create-dream-report": createDreamReport,
+  "create-browser-chat-session": createBrowserChatSession,
+  create_embed_session: createEmbedSession,
+  "create-workspace-app-embed-session": createWorkspaceAppEmbedSession,
+  "delete-staged-dataset": deleteStagedDataset,
+  "delete-destination": deleteDestination,
+  "delete-vault-secret": deleteVaultSecret,
+  "delete-workspace-resource": deleteWorkspaceResource,
+  "deny-vault-request": denyVaultRequest,
+  "ensure-dream-job": ensureDreamJob,
+  "get-app-creation-settings": getAppCreationSettings,
+  "get-agent-thread-debug": getAgentThreadDebug,
+  "get-dream": getDream,
+  "get-dream-settings": getDreamSettings,
+  "get-dispatch-settings": getDispatchSettings,
+  "get-vault-access-settings": getVaultAccessSettings,
+  "get-workspace-resource-effective-context":
+    getWorkspaceResourceEffectiveContext,
+  "get-workspace-info": getWorkspaceInfo,
+  "grant-workspace-resources-to-app": grantWorkspaceResourcesToApp,
+  "grant-vault-secrets-to-app": grantVaultSecretsToApp,
+  "list-agent-thread-sources": listAgentThreadSources,
+  "list-agent-run-failures": listAgentRunFailures,
+  "list-available-workspace-templates": listAvailableWorkspaceTemplates,
+  "list-curated-workspace-templates": listCuratedWorkspaceTemplates,
+  "list-connected-agents": listConnectedAgents,
+  "list-destinations": listDestinations,
+  "list-dispatch-approvals": listDispatchApprovals,
+  "list-dispatch-audit": listDispatchAudit,
+  "list-dispatch-overview": listDispatchOverview,
+  "list-dispatch-usage-metrics": listDispatchUsageMetrics,
+  "list-dream-candidates": listDreamCandidates,
+  "list-dreams": listDreams,
+  "list-integrations-catalog": listIntegrationsCatalog,
+  "list-linked-identities": listLinkedIdentities,
+  "list-mcp-app-access": listMcpAppAccess,
+  list_apps: listApps,
+  "list-staged-datasets": listStagedDatasets,
+  "list-vault-audit": listVaultAudit,
+  "list-vault-grants": listVaultGrants,
+  "list-vault-requests": listVaultRequests,
+  "list-vault-secret-options": listVaultSecretOptions,
+  "list-vault-secrets": listVaultSecrets,
+  "list-workspace-apps": listWorkspaceApps,
+  "list-workspace-resource-options": listWorkspaceResourceOptions,
+  "list-workspace-resource-grants": listWorkspaceResourceGrants,
+  "list-workspace-resources-for-app": listWorkspaceResourcesForApp,
+  "list-workspace-resources": listWorkspaceResources,
+  "import-agent": importAgent,
+  "import-agent-pack": importAgentPack,
+  "list-agent-pack": listAgentPack,
+  navigate: navigate,
+  open_app: openApp,
+  "apply-dream-proposal": applyDreamProposal,
+  "preview-dream-proposal": previewDreamProposal,
+  "preview-workspace-resource-change": previewWorkspaceResourceChange,
+  "provider-api-catalog": providerApiCatalog,
+  "provider-api-docs": providerApiDocs,
+  "provider-api-register": providerApiRegister,
+  "provider-api-request": providerApiRequest,
+  "query-staged-dataset": queryStagedDataset,
+  "read-slack-thread-context": readSlackThreadContext,
+  "reject-dispatch-change": rejectDispatchChange,
+  "reject-dream-proposal": rejectDreamProposal,
+  "remove-pending-workspace-app": removePendingWorkspaceApp,
+  "resolve-integration-source-context": resolveIntegrationSourceContext,
+  "remix-workspace-template": remixWorkspaceTemplate,
+  "request-vault-secret": requestVaultSecret,
+  "revoke-vault-grant": revokeVaultGrant,
+  "revoke-workspace-resource-grant": revokeWorkspaceResourceGrant,
+  "restore-starter-workspace-resources": restoreStarterWorkspaceResources,
+  "scaffold-workspace-app": scaffoldWorkspaceApp,
+  "search-agent-threads": searchAgentThreads,
+  "send-code-agent-remote-command": sendCodeAgentRemoteCommand,
+  "send-platform-message": sendPlatformMessage,
+  "set-app-creation-settings": setAppCreationSettings,
+  "set-dispatch-approval-policy": setDispatchApprovalPolicy,
+  "set-dream-settings": setDreamSettings,
+  "set-mcp-app-access": setMcpAppAccess,
+  "set-vault-access-settings": setVaultAccessSettings,
+  "start-workspace-app-creation": startWorkspaceAppCreation,
+  "sync-vault-to-app": syncVaultToApp,
+  "unarchive-workspace-app": unarchiveWorkspaceApp,
+  "update-workspace-app-metadata": updateWorkspaceAppMetadata,
+  "update-vault-secret": updateVaultSecret,
+  "update-workspace-resource": updateWorkspaceResource,
+  "upsert-destination": upsertDestination,
+  "view-screen": viewScreen,
+};

package/src/actions/list-agent-pack.ts

@@ -0,0 +1,43 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { agentPackRoot } from "../lib/agent-pack.js";
+import { listWorkspaceResources } from "../server/lib/workspace-resources-store.js";
+
+const schema = z
+  .object({
+    agentId: z.string().trim().min(1).optional(),
+    path: z.string().trim().min(1).optional(),
+  })
+  .refine((input) => Boolean(input.agentId || input.path), {
+    message: "Provide an agentId or path.",
+  });
+
+export default defineAction({
+  description:
+    "List the files in a reusable agent pack, including its profile, reference files, context files, and agent-owned skills.",
+  schema,
+  http: { method: "GET" },
+  run: async ({ agentId, path }) => {
+    const resources = await listWorkspaceResources();
+    const profile = resources.find(
+      (resource) =>
+        resource.kind === "agent" &&
+        (agentId ? resource.id === agentId : resource.path === path),
+    );
+    if (!profile) throw new Error("Agent profile not found");
+
+    const root = agentPackRoot(
+      profile.path.replace(/^agents\//, "").replace(/\.md$/i, ""),
+    );
+    const files = resources.filter(
+      (resource) =>
+        resource.id !== profile.id && resource.path.startsWith(`${root}/`),
+    );
+    return {
+      profile,
+      root,
+      files,
+    };
+  },
+});

package/src/actions/list-agent-run-failures.ts

@@ -0,0 +1,50 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listAgentRunFailures } from "../server/lib/thread-debug-store.js";
+
+export default defineAction({
+  description:
+    "List recent failed, aborted, or truncated agent runs across the connected thread-debug sources the caller may inspect. Filter interactive and scheduled job runs separately with regime, and use failureTaxonomy to cluster the measured transport, model-configuration, overload, and authentication causes. Use get-agent-thread-debug with a returned source and run ID for the full transcript and event history.",
+  schema: z.object({
+    sourceId: z
+      .string()
+      .default("all")
+      .describe(
+        "Thread debug source id from list-agent-thread-sources, or 'all' to merge every connected source available to the caller.",
+      ),
+    ownerEmail: z
+      .string()
+      .optional()
+      .describe(
+        "Optional owner email filter. Organization admins may only select members of their current organization.",
+      ),
+    status: z
+      .enum(["all", "errored", "aborted", "truncated"])
+      .default("all")
+      .describe("Unsuccessful run status to include."),
+    regime: z
+      .enum(["all", "interactive", "scheduled"])
+      .default("all")
+      .describe(
+        "Run population to inspect. Use interactive for ids not starting with job-, scheduled for ids starting with job-, and call both when measuring reliability.",
+      ),
+    lookbackHours: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(720)
+      .default(168)
+      .describe("Lookback window in hours."),
+    limit: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(100)
+      .default(25)
+      .describe("Maximum failures returned after merging and sorting sources."),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (input) => listAgentRunFailures(input),
+});

package/src/actions/list-agent-thread-sources.ts

@@ -0,0 +1,13 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listThreadDebugSources } from "../server/lib/thread-debug-store.js";
+
+export default defineAction({
+  description:
+    "List read-only agent thread debug database sources available to Dispatch. Admins can use configured app-prefixed prod DB sources.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async () => listThreadDebugSources(),
+});

package/src/actions/list-available-workspace-templates.ts

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listAvailableWorkspaceTemplates } from "../server/lib/app-creation-store.js";
+
+export default defineAction({
+  description:
+    "List first-party templates that can be scaffolded into this workspace via the Apps page. Excludes templates already installed under apps/. The agent should usually call start-workspace-app-creation for natural-language requests; this list is for the static 'Add a template' tiles.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => listAvailableWorkspaceTemplates(),
+});