@builder.io/ai-utils 0.74.4 → 0.75.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.74.4",
+  "version": "0.75.1",
   "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;
@@ -1301,6 +1347,12 @@ export declare const DeployStatusSchema: z.ZodEnum<{
 export type DeployStatus = z.infer<typeof DeployStatusSchema>;
 /** Deploy statuses that are terminal — never transitioned out of. */
 export declare const TERMINAL_DEPLOY_STATUSES: Set<"building" | "canceled" | "deploying" | "failed" | "live" | "queued" | "uploading">;
+export declare const HostingPublishStatusSchema: z.ZodEnum<{
+    published: "published";
+    publishing: "publishing";
+    unpublished: "unpublished";
+}>;
+export type HostingPublishStatus = z.infer<typeof HostingPublishStatusSchema>;
 export declare const ProjectHostingBuildConfigSchema: z.ZodObject<{
     buildCommand: z.ZodOptional<z.ZodString>;
     buildOutputDir: z.ZodOptional<z.ZodString>;
@@ -1337,6 +1389,11 @@ export declare const ProjectHostingSchema: z.ZodObject<{
             explanation: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
+    publishStatus: z.ZodOptional<z.ZodEnum<{
+        published: "published";
+        publishing: "publishing";
+        unpublished: "unpublished";
+    }>>;
     lastDeployId: z.ZodOptional<z.ZodString>;
     lastDeployAt: z.ZodOptional<z.ZodNumber>;
     lastDeployStatus: z.ZodOptional<z.ZodEnum<{
@@ -1389,8 +1446,8 @@ export type Deploy = z.infer<typeof DeploySchema>;
  *
  * "Is this URL currently live?" is NOT a property of this doc. It's answered by the
  * presence of the per-slug `HTTPRoute` in Envoy Gateway (the source of truth for routing)
- * and/or by `project.hosting.netlifySiteId` (set on publish, cleared on unpublish). The
- * slug doc exists purely to enforce uniqueness and own the permanent reservation.
+ * which is proxied by `project.hosting.publishStatus`.
+ * The slug doc exists purely to enforce uniqueness and own the permanent reservation.
  */
 export declare const HostingSlugSchema: z.ZodObject<{
     projectId: z.ZodString;
@@ -1516,6 +1573,14 @@ export declare const DeployResponseSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export type DeployResponse = z.infer<typeof DeployResponseSchema>;
+export declare const DeleteHostingRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export type DeleteHostingRequest = z.infer<typeof DeleteHostingRequestSchema>;
+export declare const DeleteHostingResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type DeleteHostingResponse = z.infer<typeof DeleteHostingResponseSchema>;
 export declare const GetDeploysRequestSchema: z.ZodObject<{
     projectId: z.ZodString;
     deployId: z.ZodOptional<z.ZodString>;

package/src/projects.js

@@ -206,6 +206,11 @@ export const TERMINAL_DEPLOY_STATUSES = new Set([
     "failed",
     "canceled",
 ]);
+export const HostingPublishStatusSchema = z.enum([
+    "unpublished",
+    "publishing",
+    "published",
+]);
 export const ProjectHostingBuildConfigSchema = z.object({
     buildCommand: z.string().optional(),
     buildOutputDir: z.string().optional(),
@@ -222,10 +227,10 @@ export const ProjectHostingSchema = z.object({
         description: 'e.g. "my-cool-app" — set once on first publish, immutable',
     }),
     netlifySiteId: z.string().optional().meta({
-        description: "Netlify site ID for management API calls; cleared on unpublish, set again on re-publish",
+        description: "Netlify site ID for management API calls. Set once on first publish, immutable.",
     }),
     netlifySiteName: z.string().optional().meta({
-        description: "<name> in <name>.netlify.app — the upstream the HTTPRoute filter rewrites Host to; cleared on unpublish",
+        description: "<name> in <name>.netlify.app — the upstream the HTTPRoute filter rewrites Host to. Set once on first publish, immutable.",
     }),
     url: z.string().optional().meta({
         description: '"https://my-cool-app.builder.cloud" — derived from slug',
@@ -250,6 +255,9 @@ export const ProjectHostingSchema = z.object({
         }),
     })
         .optional(),
+    publishStatus: HostingPublishStatusSchema.optional().meta({
+        description: "Outer publish lifecycle. Absent === unpublished. Denormalized cache of the per-slug HTTPRoute (the source of truth); flipped only after the route op succeeds. Deploy.status is the interior detail of the publishing step.",
+    }),
     lastDeployId: z.string().optional(),
     lastDeployAt: z.number().optional(),
     lastDeployStatus: DeployStatusSchema.optional(),
@@ -304,8 +312,8 @@ export const DeploySchema = z.object({
  *
  * "Is this URL currently live?" is NOT a property of this doc. It's answered by the
  * presence of the per-slug `HTTPRoute` in Envoy Gateway (the source of truth for routing)
- * and/or by `project.hosting.netlifySiteId` (set on publish, cleared on unpublish). The
- * slug doc exists purely to enforce uniqueness and own the permanent reservation.
+ * which is proxied by `project.hosting.publishStatus`.
+ * The slug doc exists purely to enforce uniqueness and own the permanent reservation.
  */
 export const HostingSlugSchema = z.object({
     projectId: z.string(),
@@ -486,6 +494,12 @@ export const DeployResponseSchema = z.object({
     deployId: z.string(),
     status: DeployStatusSchema,
 });
+export const DeleteHostingRequestSchema = z.object({
+    projectId: z.string(),
+});
+export const DeleteHostingResponseSchema = z.object({
+    success: z.literal(true),
+});
 export const GetDeploysRequestSchema = z.object({
     projectId: z.string(),
     deployId: z.string().optional(),