@jami-studio/dispatch 0.13.14

package/src/actions/get-dream.ts

@@ -0,0 +1,15 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { getDream } from "../server/lib/dreams-store.js";
+
+export default defineAction({
+  description:
+    "Get one Dispatch dream report and its evidence-backed proposals.",
+  schema: z.object({
+    id: z.string().min(1).describe("Dream id."),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async ({ id }) => getDream(id),
+});

package/src/actions/get-vault-access-settings.ts

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { getVaultAccessSettings } from "../server/lib/vault-store.js";
+
+export default defineAction({
+  description:
+    "Get the Dispatch vault access mode. Defaults to all-apps, where every workspace app can use every vault key.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => getVaultAccessSettings(),
+});

package/src/actions/get-workspace-info.ts

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { getWorkspaceInfo } from "../server/lib/app-creation-store.js";
+
+export default defineAction({
+  description:
+    "Get the current workspace's identity (name and app count) from the workspace root package.json. Surfaced in the Dispatch UI so users can see which workspace their apps belong to.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => getWorkspaceInfo(),
+});

package/src/actions/get-workspace-resource-effective-context.ts

@@ -0,0 +1,35 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { getWorkspaceResourceEffectiveContext } from "../server/lib/workspace-resources-store.js";
+
+export default defineAction({
+  description:
+    "Preview how a Dispatch workspace resource resolves for an app/user at runtime: workspace default, organization/app override, and personal override, plus whether the resource is all-app or selected-only.",
+  schema: z.object({
+    resourceId: z
+      .string()
+      .optional()
+      .describe("Workspace resource id to inspect."),
+    path: z
+      .string()
+      .optional()
+      .describe(
+        "Resource path to inspect, such as context/brand.md. Optional when resourceId is provided.",
+      ),
+    appId: z
+      .string()
+      .optional()
+      .describe(
+        "Workspace app id to preview. All-app resources are inherited by every app; selected-only resources require a grant.",
+      ),
+    userEmail: z
+      .string()
+      .optional()
+      .describe(
+        "User email for personal overrides. Defaults to the current Dispatch user.",
+      ),
+  }),
+  http: { method: "GET" },
+  run: async (args) => getWorkspaceResourceEffectiveContext(args),
+});

package/src/actions/grant-vault-secrets-to-app.ts

@@ -0,0 +1,21 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { grantSecretsToApp } from "../server/lib/vault-store.js";
+
+export default defineAction({
+  description:
+    "Grant multiple Dispatch vault secrets to a workspace app in manual vault access mode. Existing active grants are skipped.",
+  http: { method: "POST" },
+  schema: z.object({
+    appId: z
+      .string()
+      .regex(/^[a-z][a-z0-9-]{0,63}$/)
+      .describe("Workspace app id/path, e.g. customer-health"),
+    secretIds: z
+      .array(z.string())
+      .max(100)
+      .describe("Vault secret IDs to grant to the app"),
+  }),
+  run: async (args) => grantSecretsToApp(args.secretIds, args.appId),
+});

package/src/actions/grant-workspace-resources-to-app.ts

@@ -0,0 +1,17 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { grantWorkspaceResourcesToApp } from "../server/lib/workspace-resources-store.js";
+
+export default defineAction({
+  description:
+    "Grant several selected workspace resources, knowledge packs, or MCP servers to an app, skipping existing active grants.",
+  schema: z.object({
+    appId: z.string().describe("App ID receiving the resources"),
+    resourceIds: z
+      .array(z.string())
+      .max(100)
+      .describe("Workspace resource IDs to grant"),
+  }),
+  run: async (args) => grantWorkspaceResourcesToApp(args),
+});

package/src/actions/index.spec.ts

@@ -0,0 +1,32 @@
+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("list-mcp-app-access");
+    expect(dispatchActions).toHaveProperty("set-mcp-app-access");
+    expect(dispatchActions).toHaveProperty("list_apps");
+    expect(dispatchActions).toHaveProperty("ask_app");
+    expect(dispatchActions).toHaveProperty("open_app");
+    expect(dispatchActions).toHaveProperty("create_embed_session");
+    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([]);
+  });
+});

package/src/actions/index.ts

@@ -0,0 +1,186 @@
+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 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 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 listAgentThreadSources from "./list-agent-thread-sources.js";
+import listAvailableWorkspaceTemplates from "./list-available-workspace-templates.js";
+import listConnectedAgents from "./list-connected-agents.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 rejectDispatchChange from "./reject-dispatch-change.js";
+import rejectDreamProposal from "./reject-dream-proposal.js";
+import removePendingWorkspaceApp from "./remove-pending-workspace-app.js";
+import requestVaultSecret from "./request-vault-secret.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,
+  "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_embed_session: createEmbedSession,
+  "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-available-workspace-templates": listAvailableWorkspaceTemplates,
+  "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,
+  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,
+  "reject-dispatch-change": rejectDispatchChange,
+  "reject-dream-proposal": rejectDreamProposal,
+  "remove-pending-workspace-app": removePendingWorkspaceApp,
+  "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-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(),
+});

package/src/actions/list-connected-agents.ts

@@ -0,0 +1,103 @@
+import { defineAction } from "@agent-native/core";
+import {
+  REMOTE_AGENT_RESOURCE_PREFIXES,
+  parseRemoteAgentManifest,
+} from "@agent-native/core/resources/metadata";
+import {
+  resourceGet,
+  resourceListAccessible,
+  SHARED_OWNER,
+} from "@agent-native/core/resources/store";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import {
+  discoverAgents,
+  getBuiltinAgents,
+  shouldIncludeRemoteAgentManifest,
+} from "@agent-native/core/server/agent-discovery";
+import { z } from "zod";
+
+export default defineAction({
+  description:
+    "List agents available to dispatch for A2A delegation, including built-in apps and connected remote agents.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => {
+    const { hiddenAgentIds = [] } = await import("../server/index.js").then(
+      (m) => m.getDispatchConfig(),
+    );
+    const discovered = await discoverAgents("dispatch");
+    const builtinIds = new Set(
+      getBuiltinAgents("dispatch").map((agent) => agent.id),
+    );
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("no authenticated user");
+    const resources: Array<{ id: string; path: string; owner: string }> = [];
+    for (const prefix of [...REMOTE_AGENT_RESOURCE_PREFIXES].reverse()) {
+      resources.push(...(await resourceListAccessible(ownerEmail, prefix)));
+    }
+    const customById = new Map<
+      string,
+      {
+        resourceId: string;
+        path: string;
+        scope: "shared" | "personal";
+        name: string;
+        description: string;
+        url: string;
+        color: string;
+      }
+    >();
+
+    // Only treat a resource as a "custom" agent if its id is not a builtin.
+    // Built-in agents may also be seeded as shared resources so the agent-chat
+    // plugin can overlay them — those should still be reported as builtin.
+    for (const resource of resources) {
+      if (!resource.path.endsWith(".json")) continue;
+      const full = await resourceGet(resource.id);
+      if (!full) continue;
+      const manifest = parseRemoteAgentManifest(full.content, resource.path);
+      if (!manifest) continue;
+      if (!shouldIncludeRemoteAgentManifest(manifest, "dispatch")) continue;
+      if (builtinIds.has(manifest.id)) continue;
+      customById.set(manifest.id, {
+        resourceId: resource.id,
+        path: resource.path,
+        scope: resource.owner === SHARED_OWNER ? "shared" : "personal",
+        name: manifest.name,
+        description: manifest.description || "",
+        url: manifest.url,
+        color: manifest.color || "#6B7280",
+      });
+    }
+
+    const connected = discovered.map((agent) => {
+      const custom = customById.get(agent.id);
+      const isBuiltin = builtinIds.has(agent.id);
+      return {
+        ...agent,
+        source: isBuiltin ? "builtin" : custom ? "custom" : "workspace",
+        resourceId: custom?.resourceId,
+        path: custom?.path,
+        scope: custom?.scope,
+      };
+    });
+
+    const discoveredIds = new Set(connected.map((agent) => agent.id));
+    for (const [id, custom] of customById) {
+      if (discoveredIds.has(id)) continue;
+      connected.push({
+        id,
+        name: custom.name,
+        description: custom.description,
+        url: custom.url,
+        color: custom.color,
+        source: "custom",
+        resourceId: custom.resourceId,
+        path: custom.path,
+        scope: custom.scope,
+      });
+    }
+
+    return connected.filter((a) => !hiddenAgentIds.includes(a.id));
+  },
+});

package/src/actions/list-destinations.ts

@@ -0,0 +1,11 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listDestinations } from "../server/lib/dispatch-store.js";
+
+export default defineAction({
+  description: "List saved Slack and Telegram destinations for the dispatch.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => listDestinations(),
+});

package/src/actions/list-dispatch-approvals.ts

@@ -0,0 +1,11 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listApprovalRequests } from "../server/lib/dispatch-store.js";
+
+export default defineAction({
+  description: "List pending and historical dispatch approval requests.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => listApprovalRequests(),
+});

package/src/actions/list-dispatch-audit.ts

@@ -0,0 +1,13 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listAuditEvents } from "../server/lib/dispatch-store.js";
+
+export default defineAction({
+  description: "List recent dispatch audit events.",
+  schema: z.object({
+    limit: z.coerce.number().int().min(1).max(200).optional(),
+  }),
+  http: { method: "GET" },
+  run: async ({ limit }) => listAuditEvents(limit || 50),
+});

package/src/actions/list-dispatch-overview.ts

@@ -0,0 +1,19 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listOverview } from "../server/lib/dispatch-store.js";
+import { listVaultOverview } from "../server/lib/vault-store.js";
+
+export default defineAction({
+  description:
+    "Get the dispatch overview metrics, recent activity, approval settings, and vault health.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => {
+    const [overview, vault] = await Promise.all([
+      listOverview(),
+      listVaultOverview(),
+    ]);
+    return { ...overview, vault };
+  },
+});

package/src/actions/list-dispatch-usage-metrics.ts

@@ -0,0 +1,20 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listDispatchUsageMetrics } from "../server/lib/usage-metrics-store.js";
+
+export default defineAction({
+  description:
+    "Get workspace-level LLM usage, spend or Builder.io credit spend, users, app access, and recent activity metrics for Dispatch admins.",
+  schema: z.object({
+    sinceDays: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(365)
+      .default(30)
+      .describe("Lookback window in days. Defaults to 30."),
+  }),
+  http: { method: "GET" },
+  run: async (args) => listDispatchUsageMetrics(args),
+});

package/src/actions/list-dream-candidates.ts

@@ -0,0 +1,78 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listDreamCandidates } from "../server/lib/dreams-store.js";
+
+export default defineAction({
+  description:
+    "List recent agent threads worth reviewing in a Dispatch dream pass, scored from grounded signals like corrections, failures, tool errors, feedback, evals, and satisfaction.",
+  schema: z.object({
+    sourceId: z
+      .string()
+      .default("current")
+      .describe(
+        "Thread debug source id from list-agent-thread-sources. Use 'all' to scan every connected source.",
+      ),
+    sourceIds: z
+      .array(z.string().min(1))
+      .optional()
+      .describe(
+        "Optional explicit source ids to scan together. When provided, sourceId is treated as aggregate.",
+      ),
+    allSources: z.coerce
+      .boolean()
+      .default(false)
+      .describe(
+        "Scan every connected thread-debug source with partial results.",
+      ),
+    query: z
+      .string()
+      .optional()
+      .describe("Optional search term to focus candidate discovery."),
+    ownerEmail: z
+      .string()
+      .optional()
+      .describe(
+        "Optional owner email filter. Admins may pass '*' or omit to use their admin-visible scope.",
+      ),
+    limit: z.coerce.number().int().min(1).max(50).default(20),
+    sourceTimeoutMs: z.coerce
+      .number()
+      .int()
+      .min(1000)
+      .max(60000)
+      .default(15000)
+      .describe("Per-source timeout in milliseconds for partial scans."),
+    sourceConcurrency: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(8)
+      .default(2)
+      .describe("How many thread-debug sources to scan at once."),
+    sourceStartStaggerMs: z.coerce
+      .number()
+      .int()
+      .min(0)
+      .max(5000)
+      .default(250)
+      .describe("Delay between source starts within a scan batch."),
+    threadConcurrency: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(10)
+      .default(3)
+      .describe("How many threads to inspect at once within each source."),
+    threadTimeoutMs: z.coerce
+      .number()
+      .int()
+      .min(1000)
+      .max(30000)
+      .default(8000)
+      .describe("Per-thread debug timeout in milliseconds."),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (input) => listDreamCandidates(input),
+});

package/src/actions/list-dreams.ts

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listDreams } from "../server/lib/dreams-store.js";
+
+export default defineAction({
+  description: "List Dispatch dream reports with proposal status counts.",
+  schema: z.object({
+    limit: z.coerce.number().int().min(1).max(100).default(25),
+    status: z
+      .enum(["running", "completed", "failed", "all"])
+      .default("all")
+      .describe("Optional dream status filter."),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (input) => listDreams(input),
+});

package/src/actions/list-integrations-catalog.ts

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listIntegrationsCatalog } from "../server/lib/vault-store.js";
+
+export default defineAction({
+  description:
+    "List all workspace apps and their credential/integration requirements. Shows configured credentials and effective Dispatch vault access.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => listIntegrationsCatalog(),
+});