@aiworkbench/vibe-ide 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * @aiworkbench/vibe-ide — Public types and host adapter contracts.
+ *
+ * This module defines the interfaces that host applications must implement
+ * to integrate the IDE package. The IDE never imports host-specific code
+ * (Next.js, Redux, etc.) — everything flows through these contracts.
+ */
+import type { Bridge, BridgeCapability } from "@aiworkbench/vibe-types";
+import type { FileSystemTree } from "@webcontainer/api";
+/** Supported template frameworks for IDE bootstrapping. */
+export type TemplateId = "react" | "vue" | "vanilla";
+/** Variables substituted into the template during IDE bootstrap. */
+export interface TemplateVars {
+    /** Custom element tag name (e.g. "my-app"). Defaults to `vibe-<framework>-app`. */
+    projectName?: string;
+    /** PascalCase name for JS identifiers. Derived from projectName if omitted. */
+    projectNamePascal?: string;
+    /** App description for manifest.json. */
+    description?: string;
+    /** Default permissions written to manifest.json. */
+    permissions?: BridgeCapability[];
+}
+/** Tabs available in the IDE right pane. */
+export type RightPaneTab = "preview" | "code" | "terminal";
+export type UnifiedMessageStatus = "pending" | "loading" | "sent" | "error";
+export type UnifiedConnectionStatus = "initializing" | "connected" | "disconnected" | "error";
+export interface UnifiedArtifact {
+    name?: string;
+    type?: string;
+}
+export interface UnifiedStatusUpdate {
+    state: string;
+    title: string;
+    detail?: string;
+}
+export interface UnifiedToolInvocation {
+    toolName: string;
+    args: Record<string, unknown>;
+    result?: string;
+    state: "pending" | "running" | "completed" | "error";
+}
+export interface UnifiedMessage {
+    id: string;
+    content: string;
+    sender: "user" | "agent";
+    sentAt: string;
+    status: UnifiedMessageStatus;
+    artifacts?: UnifiedArtifact[];
+    statusUpdates?: UnifiedStatusUpdate[];
+    toolInvocations?: UnifiedToolInvocation[];
+}
+/**
+ * Chat adapter provided by the host. The IDE package does not own any AI
+ * transport — the host is responsible for A2A, direct-LLM, or any other
+ * chat backend. The IDE simply renders messages and forwards user input.
+ */
+export interface VibeIdeChatAdapter {
+    messages: UnifiedMessage[];
+    isProcessing: boolean;
+    error: Error | null;
+    sendMessage: (text: string) => void | Promise<void>;
+    restart?: () => void;
+}
+/**
+ * Controls which bridge capabilities are allowed, denied, or require user
+ * approval when the preview iframe makes requests through the bridge relay.
+ */
+export interface VibeIdePreviewPolicy {
+    /**
+     * Capabilities that are always allowed without prompting the user.
+     * Defaults to `["toast", "storage", "navigation", "events", "theme"]`.
+     */
+    autoApproved?: BridgeCapability[];
+    /**
+     * Called when a non-auto-approved capability is requested. Return `true`
+     * to allow, `false` to deny. If omitted the package shows a built-in
+     * approval dialog.
+     */
+    requestApproval?: (capability: BridgeCapability) => Promise<boolean>;
+    /** Optional navigation guard for `navigation.navigate()` calls. */
+    allowNavigation?: (path: string) => boolean;
+    /** Optional guard for `api.fetch()` calls from the preview. */
+    allowApiRequest?: (input: {
+        endpoint: string;
+        init?: RequestInit;
+    }) => Promise<boolean> | boolean;
+    /** Optional guard for `chat.send()` calls from the preview. */
+    allowChatRequest?: (input: {
+        serverUrl: string;
+        parts: unknown[];
+        options?: unknown;
+    }) => Promise<boolean> | boolean;
+}
+/**
+ * Optional persistence adapter. When provided, the IDE can save and restore
+ * draft snapshots through the host's storage backend.
+ */
+export interface VibeIdePersistenceAdapter {
+    loadDraft?: (draftId: string) => Promise<FileSystemTree | null>;
+    saveDraft?: (draftId: string, snapshot: FileSystemTree) => Promise<void>;
+}
+/**
+ * Callback for gating sensitive MCP tool calls (e.g. writing package.json,
+ * bulk deletes). If omitted, the package falls back to a built-in approval
+ * prompt rendered by the chat pane.
+ */
+export interface VibeIdeApprovalAdapter {
+    requestToolApproval?: (toolCall: {
+        name: string;
+        arguments: unknown;
+    }) => Promise<boolean>;
+}
+/** Options passed when creating the WebContainer MCP adapter. */
+export interface WebContainerMcpAdapterOptions {
+    /** Max tool calls before forcing user interaction. Default: 15. */
+    maxToolSteps?: number;
+    /** Max deletes per cycle before requiring approval. Default: 5. */
+    maxDeletesBeforeApproval?: number;
+    /** Override the approval callback. */
+    onApprovalRequest?: (toolCall: {
+        name: string;
+        arguments: unknown;
+    }) => Promise<boolean>;
+}
+/** Options for booting the WebContainer singleton. */
+export interface VibeIdeBootOptions {
+    /** Force-claim the session from another tab. */
+    takeover?: boolean;
+    /** Custom BroadcastChannel name. Default: "vibe-ide-instance". */
+    channelName?: string;
+}
+/** Props for `<VibeIdeProvider>`. */
+export interface VibeIdeProviderProps {
+    /** Unique draft identifier. */
+    draftId: string;
+    /** Which template to bootstrap. */
+    templateId: TemplateId;
+    /** Host-created Bridge instance. The IDE consumes this — never creates one. */
+    bridge: Bridge;
+    /** Chat adapter. If omitted, the IDE renders an empty left pane. */
+    chat?: VibeIdeChatAdapter;
+    /** Preview capability approval policy. */
+    previewPolicy?: VibeIdePreviewPolicy;
+    /** Optional persistence adapter for save/load. */
+    persistence?: VibeIdePersistenceAdapter;
+    /** Optional tool-approval adapter. */
+    approval?: VibeIdeApprovalAdapter;
+    /** Template variable overrides. */
+    templateVars?: TemplateVars;
+    /** Pre-existing file tree to mount instead of the default template. */
+    initialTree?: FileSystemTree;
+    /** Boot options for the WebContainer. */
+    bootOptions?: VibeIdeBootOptions;
+    children: React.ReactNode;
+}
+/** Props for `<VibeIdeSplitLayout>`. */
+export interface VibeIdeSplitLayoutProps {
+    /** Host-provided left pane content (e.g. a custom chat UI). */
+    leftPane?: React.ReactNode;
+    /** Extra toolbar content injected after the tab pills. */
+    toolbar?: React.ReactNode;
+}
+/** Internal IDE state exposed via `useVibeIde()`. */
+export interface VibeIdeContextValue {
+    draftId: string;
+    templateId: TemplateId;
+    bridge: Bridge;
+    chat: VibeIdeChatAdapter | null;
+    previewPolicy: VibeIdePreviewPolicy;
+    approval: VibeIdeApprovalAdapter;
+    webcontainer: {
+        status: "idle" | "booting" | "ready" | "error" | "blocked";
+        instance: import("@webcontainer/api").WebContainer | null;
+        devServerUrl: string | null;
+        error: Error | null;
+        restart: (options?: {
+            takeover?: boolean;
+        }) => void;
+        coalescer: import("./core/filesystem").WriteCoalescer | null;
+    };
+    manifestPermissions: BridgeCapability[];
+    activeRightPane: RightPaneTab;
+    setActiveRightPane: (tab: RightPaneTab) => void;
+    previewChannelRef: React.RefObject<unknown>;
+    bridgeRef: React.RefObject<Bridge | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@aiworkbench/vibe-ide",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./styles": "./dist/ide-theme.css"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target=browser --external react --external react-dom --external react/jsx-runtime --external react-dom/client && tsc --emitDeclarationOnly && cp src/react/ide-theme.css dist/ide-theme.css",
+    "dev": "tsc --watch --emitDeclarationOnly",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aiworkbench/vibe-types": "^0.0.4",
+    "@webcontainer/api": "^1.6.1",
+    "zod": "^3.25.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.10",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "^5.7.0"
+  }
+}