@agent-native/core 0.198.3-nightly-20260930154911 → 0.198.4

package/dist/a2a/types.d.ts

@@ -49,6 +49,11 @@ export interface A2AConnectionRequestMetadata {
     reason: "connect" | "grant" | "reauthorize" | "admin_required";
     appId?: string;
     detail?: string;
+    source?: {
+        id: string;
+        kind: "workspace_connection";
+        label?: string;
+    };
 }
 export interface AgentSkill {
     id: string;

package/dist/agent/production-agent.js

@@ -1656,7 +1656,11 @@ export async function callConnectedAgentReference(input) {
                 ...(connectionRequest.appId
                     ? { appId: connectionRequest.appId }
                     : {}),
-                source: { id: input.agent, kind: "agent", label: input.agent },
+                source: connectionRequest.source ?? {
+                    id: input.agent,
+                    kind: "agent",
+                    label: input.agent,
+                },
             });
         }
         relay.finish("error");
@@ -1684,12 +1688,28 @@ function parseA2AConnectionRequest(error) {
     }
     const appId = typeof request.appId === "string" ? request.appId.trim() : "";
     const detail = typeof request.detail === "string" ? request.detail.trim() : "";
+    const sourceValue = request.source && typeof request.source === "object"
+        ? request.source
+        : null;
+    const sourceId = typeof sourceValue?.id === "string" ? sourceValue.id.trim() : "";
+    const sourceLabel = typeof sourceValue?.label === "string" ? sourceValue.label.trim() : "";
     return {
         version: 1,
         provider,
         reason,
         ...(appId && appId.length <= 120 ? { appId } : {}),
         ...(detail && detail.length <= 1_000 ? { detail } : {}),
+        ...(sourceValue?.kind === "workspace_connection" &&
+            sourceId === provider &&
+            sourceId.length <= 120
+            ? {
+                source: {
+                    id: sourceId,
+                    kind: "workspace_connection",
+                    ...(sourceLabel ? { label: sourceLabel.slice(0, 120) } : {}),
+                },
+            }
+            : {}),
     };
 }
 const MAX_CONNECTED_AGENT_PROGRESS_DETAIL_CHARS = 200;
@@ -2648,6 +2668,11 @@ export function permanentPreconditionReason(toolName, message) {
         .trim()
         // The headline appends its own sentence punctuation.
         .replace(/[.。]+$/, "");
+    const nestedPrecondition = reason
+        .match(/\bI stopped because [\w-]+ can't run yet:\s*(.+?)\. That needs to be fixed outside this chat\b/i)?.[1]
+        ?.trim();
+    if (nestedPrecondition)
+        return nestedPrecondition;
     if (!reason)
         return null;
     if (/\bI stopped because\b/i.test(reason) ||

package/dist/automation/index.d.ts

@@ -139,8 +139,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
-    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
+    error?: undefined;
 }>;

package/dist/catalog.json

@@ -51,6 +51,7 @@
   "playwright": "1.63.0",
   "react": "^19.2.7",
   "react-dom": "^19.2.7",
+  "react-router": "8.1.0",
   "recharts": "^3.9.2",
   "sonner": "^2.0.7",
   "tailwind-merge": "^3.5.0",

package/dist/cli/create.js

@@ -7,6 +7,7 @@ import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import { DISPATCH_WORKSPACE_ROOT_REDIRECTS, getWorkspaceAppIdValidationError, } from "../shared/workspace-app-id.js";
 import { setupAgentSymlinks } from "./setup-agents.js";
 import { coreTemplates, getTemplate, allTemplateNames, } from "./templates-meta.js";
+import { addConfiguredMigrationDependencies } from "./upgrade.js";
 import { ensureNodePtyBuildDependency, parseWorkspaceScope, workspacifyApp, } from "./workspacify.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -553,6 +554,7 @@ async function createWorkspaceInteractive(name, opts, clack) {
                 ...resolution,
                 shape: "workspace",
             });
+            addConfiguredFeatureDependencies(appDir, targetDir);
             ensureGuardedScaffold(appDir);
             fixWebManifestName(appDir, appName, templateName, resolution.sourceIdentity);
             rewriteNetlifyToml(appDir, appName, "workspace");
@@ -795,6 +797,7 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
             ...resolution,
             shape: "workspace",
         });
+        addConfiguredFeatureDependencies(appDir, workspace.workspaceRoot);
         ensureScaffoldEmailBrandingConfig(appDir, appName, templateName);
         ensureGuardedScaffold(appDir);
         fixWebManifestName(appDir, appName, templateName, resolution.sourceIdentity);
@@ -1630,6 +1633,7 @@ function postProcessStandalone(name, targetDir, templateName, resolution) {
                 pkg.optionalDependencies,
             ].some((deps) => Boolean(deps?.["node-pty"]));
             fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+            addConfiguredFeatureDependencies(targetDir);
         }
         catch (error) {
             const detail = error instanceof Error ? error.message : String(error);
@@ -1686,6 +1690,16 @@ function postProcessStandalone(name, targetDir, templateName, resolution) {
     fixStandaloneTsconfig(targetDir, templateName);
     setupAgentSymlinks(targetDir);
 }
+function addConfiguredFeatureDependencies(appDir, workspaceRoot = appDir) {
+    const packageFile = path.join(appDir, "package.json");
+    if (!fs.existsSync(packageFile))
+        return;
+    addConfiguredMigrationDependencies({
+        root: workspaceRoot,
+        kind: workspaceRoot === appDir ? "standalone" : "workspace",
+        packageFiles: [packageFile],
+    });
+}
 function ensureReactRouterBuildDependencies(pkg) {
     const allDeps = {
         ...pkg.dependencies,

package/dist/cli/migration-codemod.js

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
-import { Node, Project, QuoteKind, SyntaxKind, } from "ts-morph";
+import { Node, Project, QuoteKind, StructureKind, SyntaxKind, } from "ts-morph";
 import { bundledCorePackageVersion, isMigrationManifestActive, loadMigrationManifestsForProject, migrationMoveStatus, resolveMigrationSymbolMove, } from "../package-lifecycle/migration-manifest.js";
 const SOURCE_EXTENSIONS = new Set([".ts", ".tsx"]);
 const CSS_EXTENSIONS = new Set([".css"]);
@@ -180,6 +180,7 @@ function recordIntroducedDependency(pending, sourceFile, root, from, to) {
 }
 function importedNameStructure(importedName, localName, nextName, typeOnly) {
     return {
+        kind: StructureKind.ImportSpecifier,
         name: nextName,
         alias: localName !== nextName
             ? localName

package/dist/cli/skills.js

@@ -546,6 +546,9 @@ const SKILL_INSTRUCTION_CLIENT_LABELS = {
     "claude-code-cli": "Claude Code",
     codex: "Shared .agents skills",
     cowork: "MCP only",
+    cursor: "Cursor",
+    opencode: "OpenCode",
+    "github-copilot": "GitHub Copilot",
     pi: "Pi",
 };
 const SKILL_INSTRUCTION_CLIENT_HINTS = {
@@ -553,12 +556,16 @@ const SKILL_INSTRUCTION_CLIENT_HINTS = {
     "claude-code-cli": "Also write Claude Code's native .claude/skills and commands files.",
     codex: "Project scope writes .agents skills/commands for Codex, Pi, Cursor, OpenCode, Copilot, and similar agents; user scope writes Codex's ~/.codex skills/commands.",
     cowork: "MCP only",
+    cursor: "Uses shared project .agents skills and commands.",
+    opencode: "Uses shared project .agents skills and commands.",
+    "github-copilot": "Uses shared project .agents skills and commands.",
     pi: "Project scope writes .agents/skills plus .pi/prompts; user scope writes ~/.agents/skills plus ~/.pi/agent/prompts.",
 };
 function normalizeKnownSkillTarget(value) {
     const key = value?.trim().toLowerCase();
-    if (!key)
+    if (!key || !Object.hasOwn(BUILT_IN_APP_SKILL_ALIASES, key)) {
         return undefined;
+    }
     return BUILT_IN_APP_SKILL_ALIASES[key];
 }
 function isKnownSkill(value) {
@@ -894,10 +901,10 @@ function mergeContentLocalFilesManifest(existing, baseDir) {
     const apps = isJsonRecord(manifest.apps) ? { ...manifest.apps } : {};
     const contentApp = isJsonRecord(apps.content) ? { ...apps.content } : {};
     const defaults = defaultContentLocalFilesAppConfig();
-    if (!Array.isArray(contentApp.roots) || contentApp.roots.length === 0) {
-        contentApp.roots = defaults.roots;
-    }
-    contentApp.roots = contentApp.roots.map((root) => {
+    const roots = Array.isArray(contentApp.roots) && contentApp.roots.length > 0
+        ? contentApp.roots
+        : defaults.roots;
+    contentApp.roots = roots.map((root) => {
         if (!isJsonRecord(root) || typeof root.path !== "string")
             return root;
         const source = isJsonRecord(root.source) ? root.source : {};
@@ -1094,7 +1101,7 @@ function removeEmptyParents(start, boundary) {
     }
 }
 function restoreInstallPaths(snapshots, boundary) {
-    for (const snapshot of snapshots.toReversed()) {
+    for (const snapshot of snapshots.slice().reverse()) {
         fs.rmSync(snapshot.target, { recursive: true, force: true });
         if (snapshot.existed) {
             fs.mkdirSync(path.dirname(snapshot.target), { recursive: true });
@@ -1609,25 +1616,6 @@ function updateSkillInstallStates(states, dryRun) {
     }
     return updated;
 }
-function normalizeClientIds(values) {
-    if (!Array.isArray(values))
-        return [];
-    const seen = new Set();
-    const out = [];
-    for (const value of values) {
-        if (typeof value !== "string")
-            continue;
-        const id = value.toLowerCase();
-        if (!CLIENTS.includes(id))
-            continue;
-        const client = id;
-        if (seen.has(client))
-            continue;
-        seen.add(client);
-        out.push(client);
-    }
-    return out;
-}
 function isMcpClientId(value) {
     return CLIENTS.includes(value);
 }
@@ -1949,7 +1937,7 @@ async function promptForPlanMcpUrl() {
         placeholder: "https://my-plan-app.example.com",
         validate(value) {
             try {
-                resolveMcpUrlOverride(value);
+                resolveMcpUrlOverride(value ?? "");
                 return undefined;
             }
             catch (err) {
@@ -2678,7 +2666,7 @@ async function connectAfterEnsure(installTarget, clients, parsed, options) {
     const clearSpinner = () => {
         if (!spinnerActive)
             return;
-        spinner.clear();
+        spinner?.clear();
         spinnerActive = false;
     };
     const writeAuthMessage = () => {
@@ -3627,11 +3615,6 @@ export async function runSkills(argv, options = {}) {
                 .map((result) => result.connectCommand)
                 .filter((command) => Boolean(command))),
         ];
-        const authLine = authConnected
-            ? "Authentication: completed."
-            : pendingConnectCommands.length
-                ? `Authentication: pending — run ${pendingConnectCommands.join(" && ")}`
-                : "";
         const githubActions = [
             ...new Set(results
                 .map((result) => result.githubActionPath)

package/dist/cli/upgrade.d.ts

@@ -1,5 +1,5 @@
 import { type SpawnSyncReturns } from "node:child_process";
-import { type MigrationManifest, type MigrationDependency } from "../package-lifecycle/migration-manifest.js";
+import { type MigrationDependency } from "../package-lifecycle/migration-manifest.js";
 declare const PINNABLE_SECTIONS: readonly ["dependencies", "devDependencies", "optionalDependencies"];
 export type UpgradeCommand = "run" | "check" | "help";
 export interface UpgradeCliOptions {
@@ -114,8 +114,9 @@ export declare function isPinnedOrLocalVersion(version: string): boolean;
 export declare function shouldBumpAgentNativeVersion(version: string): boolean;
 export declare function selectMigrationDependencies(dependencies: MigrationDependency[], environment: NodeJS.ProcessEnv): MigrationDependency[];
 export declare function readUpgradeEnvironment(projectRoot: string, packageDir: string, shellEnvironment: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function loadActiveMigrationDependencies(projectRoot: string, packageVersion: string | null, manifests?: MigrationManifest[]): MigrationDependency[];
+export declare function loadActiveMigrationDependencies(projectRoot: string, packageVersion: string | null, manifests?: import("../package-lifecycle/migration-manifest.js").MigrationManifest[]): MigrationDependency[];
 export declare function planMigrationDependencyAdditions(project: UpgradeProject, shellEnvironment?: NodeJS.ProcessEnv): UpgradeDependencyAddition[];
+export declare function addConfiguredMigrationDependencies(project: UpgradeProject, shellEnvironment?: NodeJS.ProcessEnv): void;
 export declare function pinResolvedAgentNativeVersions(project: UpgradeProject): AgentNativePinResult;
 export declare function detectUpgradeProject(cwd: string): UpgradeProject | null;
 export declare function resolveInstalledPackageVersion(projectRoot: string, packageName: string): string | null;

package/dist/cli/upgrade.js

@@ -384,6 +384,9 @@ function applyMigrationDependencyAdditions(additions) {
         writeJsonFile(file, read.value);
     }
 }
+export function addConfiguredMigrationDependencies(project, shellEnvironment = process.env) {
+    applyMigrationDependencyAdditions(planMigrationDependencyAdditions(project, shellEnvironment));
+}
 export function pinResolvedAgentNativeVersions(project) {
     const pins = [];
     const unresolved = [];

package/dist/cli/workspacify.js

@@ -44,7 +44,7 @@ export function ensureNodePtyBuildDependency(workspaceRoot) {
         "dependencies",
         "node-gyp",
     ], NODE_PTY_BUILD_DEPENDENCY);
-    const updated = document.toString();
+    const updated = document.toString({ lineWidth: 0 });
     if (updated !== current)
         fs.writeFileSync(workspacePath, updated);
 }

package/dist/client/chat/agentkit-agent-native.js

@@ -1,12 +1,13 @@
+import { AgentKitRunSlotBusyError } from "@agent-native/agentkit/client";
 import { isAgentKitProtocolVersion, parseAgentThreadSnapshot, } from "@agent-native/agentkit/protocol";
 import { agentNativePath } from "../api-path.js";
 import { dispatchAgentChatRunning } from "../use-agent-chat-running-threads.js";
 import { appendChatThreadScopeParams, } from "../use-chat-threads.js";
 import { AGENT_NATIVE_PROTOCOL_METADATA_KEY, createAgentKitProtocolAdapter, } from "./agentkit-protocol.js";
 import { createAgentNativeChatRuntime, } from "./runtime.js";
-const RUN_SLOT_TIMEOUT_MS = 5_000;
 const RUN_SLOT_POLL_INTERVAL_MS = 150;
 const RUN_SLOT_STABLE_POLLS = 2;
+const RUN_SLOT_MAX_POLLS = RUN_SLOT_STABLE_POLLS * 2;
 function asRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
         ? value
@@ -954,9 +955,8 @@ export function createAgentNativeAgentKitTransport(options = {}) {
         };
     }
     async function waitForRunSlot(threadId) {
-        const deadline = Date.now() + RUN_SLOT_TIMEOUT_MS;
         let consecutiveClearPolls = 0;
-        while (Date.now() < deadline) {
+        for (let poll = 0; poll < RUN_SLOT_MAX_POLLS; poll += 1) {
             const response = await fetcher(`${apiUrl}/runs/active?threadId=${encodeURIComponent(threadId)}`, { headers: await headers({ sessionId: threadId }) });
             if (!response.ok)
                 throw await responseError(response);
@@ -964,22 +964,22 @@ export function createAgentNativeAgentKitTransport(options = {}) {
             if (!status) {
                 throw new TypeError("Agent chat active-run response must be an object.");
             }
-            if (status.awaitingRedispatch === true) {
-                throw new Error("The agent runtime owns a continuation for this thread; the queued message remains pending.");
-            }
-            const clear = status.active !== true ||
-                status.status === "completed" ||
-                status.status === "complete" ||
-                status.status === "failed" ||
-                status.status === "cancelled" ||
-                status.status === "errored" ||
-                status.status === "aborted";
+            const clear = status.awaitingRedispatch !== true &&
+                (status.active !== true ||
+                    status.status === "completed" ||
+                    status.status === "complete" ||
+                    status.status === "failed" ||
+                    status.status === "cancelled" ||
+                    status.status === "errored" ||
+                    status.status === "aborted");
             consecutiveClearPolls = clear ? consecutiveClearPolls + 1 : 0;
             if (consecutiveClearPolls >= RUN_SLOT_STABLE_POLLS)
                 return;
-            await new Promise((resolve) => setTimeout(resolve, RUN_SLOT_POLL_INTERVAL_MS));
+            if (poll + 1 < RUN_SLOT_MAX_POLLS) {
+                await new Promise((resolve) => setTimeout(resolve, RUN_SLOT_POLL_INTERVAL_MS));
+            }
         }
-        throw new Error("The current agent run did not release the thread; the queued message remains pending.");
+        throw new AgentKitRunSlotBusyError();
     }
     async function readQueue(threadId) {
         const thread = await snapshot(threadId);

package/dist/client/chat/runtime.js

@@ -967,9 +967,11 @@ function mapAgentNativeEvent(raw, input) {
                 reason: ev.connectionReason ?? "connect",
                 appId: ev.appId,
                 detail: ev.detail,
-                source: ev.agent
-                    ? { id: ev.agent, kind: "agent", label: ev.agent }
-                    : undefined,
+                source: ev.source
+                    ? { ...ev.source, kind: ev.source.kind ?? "connection" }
+                    : ev.agent
+                        ? { id: ev.agent, kind: "agent", label: ev.agent }
+                        : undefined,
             },
         ];
     }

package/dist/client/feature-flags/types.d.ts

@@ -4,6 +4,8 @@ export interface FeatureFlagActor {
 }
 export interface FeatureFlagMetadata {
     key: string;
+    canManage?: boolean;
+    movedToLab?: string;
     displayName?: string | null;
     description?: string | null;
     defaultValue: boolean;

package/dist/client/i18n.d.ts

@@ -67,7 +67,9 @@ export declare function useIconPickerLabels(): {
     allCategories: string;
     loadError: string;
     saveError: string;
+    uploadFailed: string;
     uploadTooLarge: string;
+    uploadUnsupportedType: string;
     retry: string;
     uploadHint: string;
     colorNames: {

package/dist/client/i18n.js

@@ -488,7 +488,9 @@ export function useIconPickerLabels() {
         allCategories: t("iconPicker.allCategories"),
         loadError: t("iconPicker.loadError"),
         saveError: t("iconPicker.saveError"),
+        uploadFailed: t("iconPicker.uploadFailed"),
         uploadTooLarge: t("iconPicker.uploadTooLarge"),
+        uploadUnsupportedType: t("iconPicker.uploadUnsupportedType"),
         retry: t("iconPicker.retry"),
         uploadHint: t("iconPicker.uploadHint"),
         colorNames: Object.fromEntries(Object.keys(defaultEnglishMessages.iconPicker.colorNames).map((color) => [

package/dist/client/integrations/index.d.ts

@@ -1,4 +1,5 @@
 export { startWorkspaceProviderOAuth, workspaceProviderOAuthUrl, type WorkspaceProviderOAuthOptions, type WorkspaceProviderOAuthScope, } from "./workspace-provider-oauth.js";
+export { getWorkspaceConnectionProvider } from "../../connections/catalog.js";
 export { channelConnectionState, hasMissingRequiredCredentials, listChannelsForSettings, type ChannelConnectionState, type ChannelCredential, } from "./channel-setup.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
 export type { IntegrationStatus } from "./useIntegrationStatus.js";

package/dist/client/integrations/index.js

@@ -1,4 +1,5 @@
 export { startWorkspaceProviderOAuth, workspaceProviderOAuthUrl, } from "./workspace-provider-oauth.js";
+export { getWorkspaceConnectionProvider } from "../../connections/catalog.js";
 export { channelConnectionState, hasMissingRequiredCredentials, listChannelsForSettings, } from "./channel-setup.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
 export { listIntegrationEnvStatuses, listIntegrationStatuses, saveIntegrationEnvVars, setIntegrationEnabled, setupIntegration, disconnectManagedIntegrationInstallation, listManagedIntegrationInstallations, managedIntegrationOAuthUrl, managedSlackAgentManifestUrl, listManagedIntegrationScopes, saveManagedIntegrationScope, listManagedIntegrationBudgets, listManagedIntegrationMemory, forgetManagedIntegrationMemory, saveManagedIntegrationBudget, testManagedIntegrationInstallation, IntegrationClientError, } from "./api.js";

package/dist/client/labs/index.d.ts

@@ -1 +1 @@
-export { useLab, useLabState, useLabs, type LabReference, type LabValues, } from "./use-lab.js";
+export { useLab, useLabState, useLabs, type LabReference, type LabValues, type LabStates, } from "./use-lab.js";

package/dist/client/labs/use-lab.d.ts

@@ -1,5 +1,7 @@
 import type { LabDefinition } from "../../labs/registry.js";
+import type { UserLabState } from "../../labs/store.js";
 export type LabValues = Record<string, boolean>;
+export type LabStates = Record<string, UserLabState>;
 /**
  * A lab by key, or by its definition. Pass the definition so the lab reads as
  * its `defaultEnabled` until the server answers (and when it can't); a bare
@@ -8,6 +10,9 @@ export type LabValues = Record<string, boolean>;
 export type LabReference = string | Pick<LabDefinition, "key" | "defaultEnabled">;
 export declare function useLabState(lab: LabReference): {
     enabled: boolean;
+    source: UserLabState["source"] | null;
+    mixed: boolean;
+    legacyValues?: Record<string, boolean>;
     isLoading: boolean;
     isError: boolean;
     isSuccess: boolean;

package/dist/client/labs/use-lab.js

@@ -6,13 +6,17 @@ function labKey(lab) {
 export function useLabState(lab) {
     const key = labKey(lab);
     const { status } = useSession();
-    const query = useActionQuery("get-labs", undefined, {
+    const query = useActionQuery("get-lab-states", undefined, {
         enabled: status === "authenticated",
     });
+    const state = query.data?.[key];
     return {
-        enabled: query.data
-            ? query.data[key] === true
+        enabled: state
+            ? state.enabled
             : typeof lab !== "string" && lab.defaultEnabled === true,
+        source: state?.source ?? null,
+        mixed: state?.mixed ?? false,
+        legacyValues: state?.legacyValues,
         isLoading: query.isLoading || (status === "loading" && query.data === undefined),
         isError: query.isError,
         isSuccess: query.isSuccess,

package/dist/client/resources/mcp-connection-resume.d.ts

@@ -2,14 +2,16 @@ export interface McpConnectionResumeRequest {
     message: string;
     returnUrl: string;
     createdAt: number;
+    completionId?: string;
     agentKit?: {
         threadId: string;
         runId: string;
         requestId: string;
     };
 }
-export declare function saveMcpConnectionResume(message: string, agentKit?: McpConnectionResumeRequest["agentKit"]): boolean;
-export declare function clearMcpConnectionResume(): void;
+export declare function saveMcpConnectionResume(message: string, agentKit?: McpConnectionResumeRequest["agentKit"], completionId?: string): boolean;
+export declare function getPendingMcpConnectionResume(returnUrl?: string): McpConnectionResumeRequest | null;
+export declare function clearMcpConnectionResume(expected?: McpConnectionResumeRequest | string): void;
 export declare function consumeMcpConnectionResume(returnUrl?: string): McpConnectionResumeRequest | null;
-export declare function notifyMcpConnectionComplete(): void;
+export declare function notifyMcpConnectionComplete(completionId?: string): void;
 export declare function addMcpConnectionCompleteListener(listener: () => void): () => void;