@builder.io/ai-utils 0.74.4 → 0.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.74.4",
+  "version": "0.75.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 import type { Options as PrettierOptions } from "prettier";
-import type { Attachment, ContentMessageItemToolResult } from "./messages";
+import { type Attachment, type ContentMessageItemToolResult } from "./messages";
 import type { BuilderContent } from "./completion";
 import { type EnvironmentVariable, type SetupDependency } from "./common-schemas";
-import type { ForcedBackup, GitDiagnostics } from "./projects";
+import type { ForcedBackup, GitDiagnostics, ProjectSkill } from "./projects";
 import type { Feature } from "./features";
 import type { CpuKind, BranchType } from "./projects";
 export declare const GitSnapshotSchema: z.ZodString;
@@ -3789,7 +3789,7 @@ export type MCPRegistrationSource = "local-configured" | "remote-registered" | "
 export interface MCPClientStatus {
     status: "ok" | "error" | "disabled" | "auth_required" | "auth_error" | "shadowed";
     message?: string;
-    protocol?: "streamable-http" | "sse" | "stdio";
+    protocol: "streamable-http" | "sse" | "stdio" | undefined;
     connectionDurationMs: number;
     resolutionDurationMs: number;
     authorizationUrl?: string;
@@ -3823,7 +3823,7 @@ export interface MCPClientStatus {
      * group servers and gate per-source actions (e.g. server-managed MCPs
      * can't be reconnected from the CLI).
      */
-    source?: "local" | "plugin" | "builtin" | "server";
+    source: "local" | "plugin" | "builtin" | "server" | undefined;
     /** Precedence scope from MCPServerDefinition (local/plugin only). */
     scope?: "project" | "user" | "plugin";
     /** Plugin that contributed this server, if any. */
@@ -3839,12 +3839,12 @@ export interface MCPClientStatus {
     url?: string;
     command?: string;
     /** Number of real (non-synthetic) tools currently exposed. */
-    toolCount?: number;
+    toolCount: number | undefined;
     /** Lightweight tool catalog for the "View tools" sub-view. */
-    tools?: {
+    tools: {
         name: string;
         description?: string;
-    }[];
+    }[] | undefined;
     /** Capability flags reported by the server during initialize. */
     capabilities?: {
         tools?: boolean;
@@ -4109,6 +4109,11 @@ export interface FusionConfig {
     proxyOrigin?: string;
     proxyDefaultOrigin?: string;
     setupDependencies?: SetupDependency[];
+    /**
+     * Project-level skills to install during initialization.
+     * Each skill is resolved to a `skills add` source and installed before setup runs.
+     */
+    skills?: ProjectSkill[];
     projectId?: string;
     /** Human-readable project name (e.g. "My App") */
     projectName?: string;

package/src/codegen.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { AttachmentSchema, ContentMessageItemToolResultSchema, } from "./messages";
-import { UserContextSchema } from "./mapping";
 import { EnvironmentVariableSchema, SetupDependencySchema, } from "./common-schemas";
+import { UserContextSchema } from "./mapping";
 export const GitSnapshotSchema = z.string().meta({
     title: "GitSnapshot",
     description: "Multi-repo git snapshot. Format: 'folder:hash,folder:hash' " +

package/src/projects.d.ts

@@ -330,6 +330,51 @@ export type ShutdownResponse = {
 export type ShutdownResponseSerialized = Omit<ShutdownResponse, "error"> & {
     error?: string;
 };
+interface ProjectSkillBase {
+    /** Stable identifier for the entry (used for logs/dedup, not by the CLI). */
+    key: string;
+    /** Specific skill names to install (--skill). Omit to install all. */
+    skills?: string[];
+    /** Target agents (--agent). Defaults to ["claude-code"]. */
+    agents?: string[];
+}
+/**
+ * A skill source passed directly to `skills add`.
+ * Supports GitHub shorthand, Git/GitHub URLs, local paths, npm: sources, etc.
+ */
+export interface ProjectSkillSource extends ProjectSkillBase {
+    source: string;
+}
+/**
+ * A skill sourced from an npm package.
+ * The package must contain a SKILL.md at its root (or a skills/<name>/SKILL.md).
+ */
+export interface ProjectSkillNpm extends ProjectSkillBase {
+    type: "npm";
+    package: string;
+    version?: string;
+}
+/**
+ * A skill sourced from a GitHub repository that follows the Claude Code plugin layout
+ * (skills/<name>/SKILL.md) or contains a SKILL.md at root.
+ * ref can be a branch, tag, or commit SHA.
+ */
+export interface ProjectSkillGithub extends ProjectSkillBase {
+    type: "github";
+    repo: string;
+    ref?: string;
+    /** Sub-path inside the repo to treat as the plugin root (default: repo root) */
+    path?: string;
+}
+/**
+ * A skill sourced from a URL supported by `skills add`, such as a GitHub/GitLab
+ * tree URL, a direct git URL, or a well-known skills index URL.
+ */
+export interface ProjectSkillUrl extends ProjectSkillBase {
+    type: "url";
+    url: string;
+}
+export type ProjectSkill = ProjectSkillSource | ProjectSkillNpm | ProjectSkillGithub | ProjectSkillUrl;
 export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
 export type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator" | "design-system-indexer" | "builder-publish-integration";
 export interface PartialBranchData {
@@ -671,7 +716,8 @@ export interface Project {
         gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
         /** @internal Mise tools and custom scripts run before the setup command. Managed via builder.config.json. */
         setupDependencies?: SetupDependency[];
-        /** Custom branch name pattern used when gitBranchNamingStrategy is "custom". */
+        /** Project-level skills to install during Fusion initialization. */
+        skills?: ProjectSkill[];
         gitBranchNamingCustom?: string;
         /** When true, the user is prompted to provide a branch name before a new branch is created. */
         askUserForBranchName?: boolean;