@agent-native/core 0.149.1 → 0.149.3

package/dist/integrations/pending-tasks-store.js

@@ -110,27 +110,6 @@ async function ensureDispatchColumns(client) {
         }
     }
 }
-/**
- * Whether a provider thread currently has queued or executing work.
- *
- * Messaging adapters use this to accept unmentioned replies only while an
- * agent task is active. This prevents broad message subscriptions from turning
- * every channel message into an agent invocation.
- */
-export async function hasActivePendingTask(platform, externalThreadId) {
-    await ensureTable();
-    const client = getDbExec();
-    const { rows } = await client.execute({
-        sql: `SELECT 1 AS active
-      FROM integration_pending_tasks
-      WHERE platform = ?
-        AND external_thread_id = ?
-        AND status IN ('pending', 'processing')
-      LIMIT 1`,
-        args: [platform, externalThreadId],
-    });
-    return rows.length > 0;
-}
 function rowToTask(row) {
     return {
         id: row.id,

package/dist/integrations/slack-manifest.d.ts

@@ -1,4 +1,4 @@
-export declare const SLACK_AGENT_BOT_EVENTS: readonly ["app_home_opened", "app_context_changed", "app_mention", "message.channels", "message.groups", "message.im", "message.mpim"];
+export declare const SLACK_AGENT_BOT_EVENTS: readonly ["app_home_opened", "app_context_changed", "app_mention", "message.im"];
 export interface SlackAgentManifestUrls {
     oauthRedirectUrl: string;
     eventsRequestUrl: string;
@@ -52,7 +52,7 @@ export declare function buildSlackAgentManifest(urls: SlackAgentManifestUrls): {
     readonly settings: {
         readonly event_subscriptions: {
             readonly request_url: string;
-            readonly bot_events: readonly ["app_home_opened", "app_context_changed", "app_mention", "message.channels", "message.groups", "message.im", "message.mpim"];
+            readonly bot_events: readonly ["app_home_opened", "app_context_changed", "app_mention", "message.im"];
         };
         readonly interactivity: {
             readonly is_enabled: true;

package/dist/integrations/slack-manifest.js

@@ -3,10 +3,7 @@ export const SLACK_AGENT_BOT_EVENTS = [
     "app_home_opened",
     "app_context_changed",
     "app_mention",
-    "message.channels",
-    "message.groups",
     "message.im",
-    "message.mpim",
 ];
 /**
  * Build the canonical Slack app manifest for Agent Native.

package/dist/integrations/webhook-handler.js

@@ -928,7 +928,7 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                     // leave a user-facing Slack reply empty.
                     maxOutputTokens: resolveMainChatMaxOutputTokens(resolvedModel),
                     // Explicitly resolve the normal chat default so an empty-final
-                    // retry can step its reasoning effort down rather than
+                    // retry can step its effort down rather than
                     // repeatedly letting the engine choose Medium.
                     reasoningEffort: normalizeReasoningEffortForRequest(resolvedModel, undefined),
                 }, undefined, {

package/dist/mcp/screen-memory-stdio.d.ts

@@ -137,13 +137,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
+            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -159,6 +159,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
+            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -174,7 +175,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -190,6 +190,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
+            count?: undefined;
             minutes: {
                 type: string;
                 description: string;
@@ -199,7 +200,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -216,6 +216,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
+            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -234,7 +235,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             };
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -250,6 +250,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
+            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
@@ -263,7 +264,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
                 description: string;
             };
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             includeMicrophone?: undefined;
@@ -314,13 +314,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
+            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt: {
                 type: string;
                 description: string;
@@ -349,13 +349,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
+            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
-            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;

package/dist/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,9 +59,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
-    error?: undefined;
     ok: boolean;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -76,8 +76,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     }>>;
 }, z.core.$strip>>, {
     id?: undefined;
-    provider?: undefined;
     deleted?: undefined;
+    provider?: undefined;
     providers: {
         id: string;
         label: string;
@@ -93,9 +93,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
-    count?: undefined;
     id?: undefined;
     deleted?: undefined;
+    count?: undefined;
     providers?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
@@ -103,9 +103,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    deleted?: undefined;
     count?: undefined;
     provider?: undefined;
-    deleted?: undefined;
     providers?: undefined;
     found: boolean;
     id: string;
@@ -123,9 +123,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    deleted?: undefined;
     count?: undefined;
     provider?: undefined;
-    deleted?: undefined;
     providers?: undefined;
     found?: undefined;
     registered: boolean;

package/dist/provider-api/actions/provider-api.d.ts

@@ -311,8 +311,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
-        deleted?: undefined;
+        message?: undefined;
         id?: undefined;
+        deleted?: undefined;
         providers: {
             id: string;
             label: string;
@@ -327,28 +328,28 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         found?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        deleted?: undefined;
+        message?: undefined;
         count?: undefined;
         id?: undefined;
+        deleted?: undefined;
         providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        deleted?: undefined;
+        message?: undefined;
         count?: undefined;
+        deleted?: undefined;
         providers?: undefined;
         provider?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        message?: undefined;
         count?: undefined;
         providers?: undefined;
         provider?: undefined;
@@ -357,10 +358,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        deleted?: undefined;
         count?: undefined;
+        deleted?: undefined;
         providers?: undefined;
         provider?: undefined;
         found?: undefined;

package/dist/scripts/docs/source-search.js

@@ -15,7 +15,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { parseSkillFrontmatter } from "../../server/agents-bundle.js";
+import { isRuntimeVisibleScope, parseSkillFrontmatter, } from "../../server/agents-bundle.js";
 import { isValidPath, parseArgs } from "../utils.js";
 const MAX_FILE_BYTES = 1_000_000;
 const MAX_READ_CHARS = 40_000;
@@ -155,7 +155,7 @@ function isRuntimeVisibleCorpusPath(corpusRoot, absolutePath) {
         return true;
     try {
         const raw = fs.readFileSync(skillEntryPath, "utf-8");
-        return parseSkillFrontmatter(raw).scope !== "dev";
+        return isRuntimeVisibleScope(parseSkillFrontmatter(raw).scope);
     }
     catch {
         return true;

package/dist/server/agent-chat/framework-prompts.js

@@ -22,6 +22,11 @@ import { lazyFs } from "./lazy-fs.js";
 export function buildFrameworkPrompts(examples, options) {
     const FRAMEWORK_CORE = buildFrameworkCore(examples, options);
     const FRAMEWORK_CORE_COMPACT = buildFrameworkCoreCompact(examples, options);
+    // Dev agents edit source directly, so their copy of the core drops the
+    // production-only "hand code changes to Builder" sentence.
+    const devCoreOptions = { ...options, canEditSource: true };
+    const DEV_FRAMEWORK_CORE = buildFrameworkCore(examples, devCoreOptions);
+    const DEV_FRAMEWORK_CORE_COMPACT = buildFrameworkCoreCompact(examples, devCoreOptions);
     const extensionToolsEnabled = options?.extensionTools === true;
     const planModeArtifactList = extensionToolsEnabled
         ? "source-code handoffs and app-created artifacts such as extensions, widgets, dashboards, calculators, mini-apps, documents, designs, slides, or videos"
@@ -107,7 +112,7 @@ When editing code, follow the agent-native architecture:
 - All SQL must be dialect-agnostic (works on SQLite and Postgres)
 - No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)
 - Use shadcn/ui components and Tabler Icons for all UI work
-${FRAMEWORK_CORE}`;
+${DEV_FRAMEWORK_CORE}`;
     const PROD_FRAMEWORK_PROMPT_COMPACT = `## Agent-Native Framework — Production Mode
 
 You are an AI agent in an agent-native application, running in **production mode**.
@@ -141,7 +146,7 @@ When editing code, follow the agent-native architecture:
 - All SQL must be dialect-agnostic (works on SQLite and Postgres)
 - No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)
 - Use shadcn/ui components and Tabler Icons for all UI work
-${FRAMEWORK_CORE_COMPACT}`;
+${DEV_FRAMEWORK_CORE_COMPACT}`;
     return {
         FRAMEWORK_CORE,
         FRAMEWORK_CORE_COMPACT,

package/dist/server/agent-chat/prompt-resources.js

@@ -3,7 +3,7 @@ import { getFrontmatterValue, getSkillNameFromPath, parseFrontmatter, } from "..
 import { ensurePersonalDefaults, organizationIdFromResourceOwner, resourceGet, resourceGetByPath, resourceList, resourceListAccessible, SHARED_OWNER, sharedResourceOwner, WORKSPACE_OWNER, } from "../../resources/store.js";
 import { discoverAgents } from "../agent-discovery.js";
 import { getRequestOrgId } from "../request-context.js";
-import { parseSkillFrontmatter } from "./skill-frontmatter.js";
+import { isRuntimeVisibleScope, parseSkillFrontmatter, } from "./skill-frontmatter.js";
 // ---------------------------------------------------------------------------
 // System-prompt resource loading: AGENTS.md, instructions/*.md, skills
 // summaries, and the shared/workspace resource index. Assembled by
@@ -523,7 +523,7 @@ async function loadResourceSkillsPromptBlock(owner, orgId) {
             const meta = parseSkillFrontmatter(full.content);
             if (meta.userInvocable === false)
                 continue;
-            if (meta.scope === "dev")
+            if (!isRuntimeVisibleScope(meta.scope))
                 continue;
             const name = meta.name || getSkillNameFromPath(resource.path);
             if (!name || seen.has(name))

package/dist/server/agent-chat/skill-frontmatter.d.ts

@@ -1,6 +1,35 @@
-export declare function parseSkillFrontmatter(content: string): {
+/**
+ * Where a skill is meant to be used:
+ *   - `runtime` — only the in-app agent at runtime.
+ *   - `dev`     — only the human's development/coding agent (e.g. Claude Code).
+ *                 Hidden from the runtime agent everywhere.
+ *   - `both`    — loaded everywhere. The default when `scope` is absent.
+ *   - `invalid` — never written by hand: the parse result for a `scope:` nobody
+ *                 recognizes. See `normalizeSkillScope`.
+ */
+export type SkillScope = "runtime" | "dev" | "both" | "invalid";
+export declare const DEFAULT_SKILL_SCOPE: SkillScope;
+/**
+ * An unrecognized `scope:` can neither throw nor fall back to `both`.
+ * Throwing would be swallowed: every caller parses inside a `catch` that skips
+ * the skill (`readSkillsDir`) or falls back to a permissive default, so at
+ * production cold start the skill would vanish with no log — the same
+ * invisible failure pointed the other way. Falling back to `both` ships a
+ * dev-only skill's body to the deployed agent, which is the bug this sentinel
+ * exists to prevent. So `invalid` stays distinguishable from an absent scope,
+ * is loud once per file+value, and is excluded from the runtime agent's view
+ * while the development agent still sees the skill and the mistake.
+ */
+export declare function normalizeSkillScope(raw: string | undefined, sourceLabel?: string): SkillScope;
+/**
+ * The one runtime-visibility gate. A skill whose scope could not be read is
+ * withheld alongside `dev`, so a typo fails closed instead of leaking the body
+ * into the deployed agent's prompt and docs-search.
+ */
+export declare function isRuntimeVisibleScope(scope: SkillScope | undefined): boolean;
+export declare function parseSkillFrontmatter(content: string, sourceLabel?: string): {
     name?: string;
     description?: string;
     userInvocable?: boolean;
-    scope?: "runtime" | "dev" | "both";
+    scope?: SkillScope;
 };

package/dist/server/agent-chat/skill-frontmatter.js

@@ -1,25 +1,51 @@
 import { getFrontmatterValue, parseFrontmatter, } from "../../resources/metadata.js";
-export function parseSkillFrontmatter(content) {
+export const DEFAULT_SKILL_SCOPE = "both";
+const warnedBadScopes = new Set();
+/**
+ * An unrecognized `scope:` can neither throw nor fall back to `both`.
+ * Throwing would be swallowed: every caller parses inside a `catch` that skips
+ * the skill (`readSkillsDir`) or falls back to a permissive default, so at
+ * production cold start the skill would vanish with no log — the same
+ * invisible failure pointed the other way. Falling back to `both` ships a
+ * dev-only skill's body to the deployed agent, which is the bug this sentinel
+ * exists to prevent. So `invalid` stays distinguishable from an absent scope,
+ * is loud once per file+value, and is excluded from the runtime agent's view
+ * while the development agent still sees the skill and the mistake.
+ */
+export function normalizeSkillScope(raw, sourceLabel) {
+    if (!raw?.trim())
+        return DEFAULT_SKILL_SCOPE;
+    const value = raw.trim().toLowerCase();
+    if (value === "runtime" || value === "dev" || value === "both")
+        return value;
+    const warnKey = `${sourceLabel ?? ""}\u0000${value}`;
+    if (!warnedBadScopes.has(warnKey)) {
+        warnedBadScopes.add(warnKey);
+        console.error(`[skill-frontmatter] Invalid scope "${raw.trim()}" in ${sourceLabel ?? "an unidentified SKILL.md"} — valid values are runtime, dev, both. Hiding this skill from the runtime agent until it is fixed.`);
+    }
+    return "invalid";
+}
+/**
+ * The one runtime-visibility gate. A skill whose scope could not be read is
+ * withheld alongside `dev`, so a typo fails closed instead of leaking the body
+ * into the deployed agent's prompt and docs-search.
+ */
+export function isRuntimeVisibleScope(scope) {
+    return scope !== "dev" && scope !== "invalid";
+}
+export function parseSkillFrontmatter(content, sourceLabel) {
     const frontmatter = parseFrontmatter(content);
     const userInvocable = getFrontmatterValue(frontmatter, "user-invocable");
-    const scope = normalizeSkillFrontmatterScope(getFrontmatterValue(frontmatter, "scope"));
+    const rawScope = getFrontmatterValue(frontmatter, "scope");
+    const name = getFrontmatterValue(frontmatter, "name");
     return {
-        name: getFrontmatterValue(frontmatter, "name"),
+        name,
         description: getFrontmatterValue(frontmatter, "description"),
-        scope,
+        scope: rawScope
+            ? normalizeSkillScope(rawScope, sourceLabel ?? name)
+            : undefined,
         userInvocable: userInvocable === undefined
             ? undefined
             : userInvocable.toLowerCase() === "true",
     };
 }
-function normalizeSkillFrontmatterScope(value) {
-    if (!value)
-        return undefined;
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "runtime" ||
-        normalized === "dev" ||
-        normalized === "both") {
-        return normalized;
-    }
-    return "both";
-}

package/dist/server/agent-chat-plugin.js

@@ -118,7 +118,7 @@ import { isNetlifyRecurringJobsRuntime, shouldDisableRecurringJobsRuntime, } fro
 import { isLocalhost, shouldBlockInProductCodeEditingSurface, } from "./agent-chat/request-surface.js";
 import { loadRunCodeToolEntries } from "./agent-chat/run-code-tools.js";
 import { createAgentEngineScriptEntries, createAgentLoopSettingsScriptEntries, createCallAgentScriptEntry, createChatScriptEntries, createDbScriptEntries, createDocsScriptEntries, createResourceScriptEntries, } from "./agent-chat/script-entries.js";
-import { parseSkillFrontmatter } from "./agent-chat/skill-frontmatter.js";
+import { isRuntimeVisibleScope, parseSkillFrontmatter, } from "./agent-chat/skill-frontmatter.js";
 import { shouldDisableInProcessSweeps } from "./sweep-runtime.js";
 export { loadResourcesForPrompt };
 export { _agentChatPromptSectionsForTests };
@@ -3373,7 +3373,7 @@ Non-code requests are still fine on this surface: read data, navigate the UI, su
                                     const fm = parseSkillFrontmatter(content);
                                     if (fm.userInvocable === false)
                                         continue;
-                                    if (fm.scope === "dev")
+                                    if (!isRuntimeVisibleScope(fm.scope))
                                         continue;
                                     const skillName = fm.name || entry.name.replace(/\.md$/, "");
                                     if (!seenNames.has(skillName)) {
@@ -3455,7 +3455,7 @@ Non-code requests are still fine on this surface: read data, navigate the UI, su
                                 : undefined);
                             if (full) {
                                 const fm = parseSkillFrontmatter(full.content);
-                                if (fm.scope === "dev")
+                                if (!isRuntimeVisibleScope(fm.scope))
                                     continue;
                                 if (fm.name)
                                     skillName = fm.name;

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,10 +27,10 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};

package/dist/server/agents-bundle.d.ts

@@ -20,23 +20,16 @@
  *
  * Result is cached in module scope so it's only computed once per cold start.
  */
-/**
- * Where a skill is meant to be used:
- *   - `runtime` — only the in-app agent at runtime (not the human's coding agent).
- *   - `dev`     — only the human's development/coding agent (e.g. Claude Code).
- *                 EXCLUDED from the runtime agent's prompt block and docs-search.
- *   - `both`    — loaded everywhere. This is the default when `scope` is absent
- *                 or set to an unrecognized value (fully backward compatible).
- */
-export type SkillScope = "runtime" | "dev" | "both";
-export declare const DEFAULT_SKILL_SCOPE: SkillScope;
+import { DEFAULT_SKILL_SCOPE, isRuntimeVisibleScope, normalizeSkillScope, type SkillScope } from "./agent-chat/skill-frontmatter.js";
+export { DEFAULT_SKILL_SCOPE, isRuntimeVisibleScope, normalizeSkillScope, type SkillScope, };
 export interface SkillMeta {
     name: string;
     description: string;
     /**
      * Audience for the skill. Defaults to `both` when the SKILL.md frontmatter
-     * omits `scope` or specifies an unknown value. `dev`-scoped skills are hidden
-     * from the runtime agent everywhere (prompt block + docs-search).
+     * omits `scope`. An unrecognized value parses to `invalid`, which is hidden
+     * from the runtime agent everywhere (prompt block + docs-search) exactly
+     * like `dev`. `dev`-scoped skills are likewise hidden from the runtime agent.
      */
     scope: SkillScope;
 }
@@ -104,7 +97,6 @@ export interface AgentInstructionPaths {
     development: string;
 }
 export declare function resolveAgentInstructionPaths(instructions?: AgentNativeInstructionsConfig): AgentInstructionPaths;
-export declare function normalizeSkillScope(raw: string | undefined): SkillScope;
 /**
  * Parse the YAML frontmatter at the top of a skill file.
  * Only pulls out `name`, `description`, and `scope` — deliberately simple, no
@@ -113,8 +105,11 @@ export declare function normalizeSkillScope(raw: string | undefined): SkillScope
  *   - Inline: `description: Some text`
  *   - Folded scalar: `description: >-\n  multi\n  line` → "multi line"
  *   - Literal scalar: `description: |\n  multi\n  line` → "multi\nline"
+ *
+ * `sourceLabel` only names the file in the invalid-scope log; pass it wherever
+ * a path is known so a typo is traceable to the SKILL.md that carries it.
  */
-export declare function parseSkillFrontmatter(content: string): Partial<SkillMeta>;
+export declare function parseSkillFrontmatter(content: string, sourceLabel?: string): Partial<SkillMeta>;
 import type { AgentNativeInstructionsConfig } from "../config.js";
 /**
  * Paths to a workspace-core's agent resources, for merging into a template's
@@ -160,15 +155,17 @@ export declare function loadAgentsBundle(): Promise<AgentsBundle>;
  */
 /**
  * Skills visible to the agent-native RUNTIME agent. Excludes `scope: dev`
- * skills (those are for the human's coding agent only). Skills with no scope,
- * `scope: runtime`, or `scope: both` are all included. Use this anywhere the
- * runtime agent's view of skills is built (prompt block + docs-search) so a
- * dev-scoped skill is invisible to the runtime agent everywhere.
+ * skills (those are for the human's coding agent only) and skills whose scope
+ * could not be read. Skills with no scope, `scope: runtime`, or `scope: both`
+ * are all included. Use this anywhere the runtime agent's view of skills is
+ * built (prompt block + docs-search) so a dev-scoped skill is invisible to the
+ * runtime agent everywhere.
  */
 export declare function getRuntimeSkills(bundle: AgentsBundle): Skill[];
 /**
  * Skills visible to development/coding agents. Excludes `scope: runtime`
- * skills that are intended only for the deployed in-app agent.
+ * skills that are intended only for the deployed in-app agent. An `invalid`
+ * scope stays visible here on purpose — this is the audience that can fix it.
  */
 export declare function getDevelopmentSkills(bundle: AgentsBundle): Skill[];
 export declare function skillDocsSlug(name: string): string;