@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.1

package/dist/setup/wizard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * External Setup Wizard
+ *
+ * Unified wizard for configuring vibes integration with external AI coding tools.
+ * Supports registered external tools through their runtime descriptors.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type ExternalSetupWizardOptions, type ExternalSetupWizardResult } from './types.ts';
+/**
+ * Run the external setup wizard
+ */
+export declare function runExternalSetupWizard(options: ExternalSetupWizardOptions): Promise<ExternalSetupWizardResult>;
+/**
+ * Quick setup with defaults (non-interactive)
+ */
+export declare function quickExternalSetup(options: {
+    runtime: VibesRuntime;
+    targets: string[];
+    tier?: string;
+    global?: boolean;
+    projectDir?: string;
+}): Promise<ExternalSetupWizardResult>;
+export { createExternalSetupState } from './types.ts';
+export type { ExternalSetupState, ExternalSetupWizardOptions, ExternalSetupWizardResult, DetectedTool, TargetInstallResult } from './types.ts';
+//# sourceMappingURL=wizard.d.ts.map

package/dist/setup/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/setup/wizard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAS/F,OAAO,EAGN,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAG9B,MAAM,YAAY,CAAC;AA2GpB;;GAEG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CA8EpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC3C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAQrC;AAED,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EACX,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,mBAAmB,EACnB,MAAM,YAAY,CAAC"}

package/dist/setup/wizard.js

@@ -0,0 +1,182 @@
+/**
+ * External Setup Wizard
+ *
+ * Unified wizard for configuring vibes integration with external AI coding tools.
+ * Supports registered external tools through their runtime descriptors.
+ */
+import { intro, outro, cancel } from '@clack/prompts';
+import { getLogger } from '@vibesdotdev/logging';
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { ToolTierSchema } from "../schemas/tiers.js";
+import { detectToolsStep, selectTargetsStep, selectTiersStep, selectLocationStep, installStep } from "./steps/index.js";
+import { createExternalSetupState } from "./types.js";
+/**
+ * Simple wizard runner for external setup
+ * (Uses a lighter-weight approach than the full WizardManager)
+ */
+class ExternalSetupRunner {
+    steps = [];
+    state;
+    workspaceRoot;
+    vibesPath;
+    runtime;
+    constructor(initialState, workspaceRoot, vibesPath, runtime) {
+        this.state = initialState;
+        this.workspaceRoot = workspaceRoot;
+        this.vibesPath = vibesPath;
+        this.runtime = runtime;
+    }
+    register(step) {
+        this.steps.push(step);
+    }
+    getState() {
+        return this.state;
+    }
+    async runAll() {
+        for (const step of this.steps) {
+            const ctx = this.createStepContext();
+            try {
+                // Initialize step if needed
+                if (step.initialize) {
+                    await step.initialize(ctx);
+                }
+                // Check if initialization set skipped
+                if (this.state.metadata.skipped) {
+                    break;
+                }
+                // Render CLI interface
+                if (step.renderCLI) {
+                    await step.renderCLI(ctx);
+                }
+                // Check if user skipped/cancelled
+                if (this.state.metadata.skipped) {
+                    break;
+                }
+                // Validate step
+                if (step.validate) {
+                    const valid = await step.validate(ctx);
+                    if (!valid && !this.state.metadata.skipped) {
+                        // Step validation failed but not skipped - skip remaining steps
+                        break;
+                    }
+                }
+            }
+            catch (error) {
+                const failure = CaughtFailureSchema.parse(error);
+                getLogger('external.setup.wizard', this.runtime).error(`error in step '${step.id}'`, { error: failure });
+                throw error;
+            }
+        }
+    }
+    createStepContext() {
+        // Use arrow functions to capture 'this' and always return current state
+        const getState = () => this.state;
+        const updateState = (partial) => {
+            this.state = {
+                ...this.state,
+                ...partial,
+                metadata: {
+                    ...this.state.metadata,
+                    ...partial.metadata
+                },
+                external: {
+                    ...this.state.external,
+                    ...partial.external
+                }
+            };
+        };
+        // Return object with getter for state so it always reflects current value
+        return {
+            get state() {
+                return getState();
+            },
+            context: {
+                workspaceRoot: this.workspaceRoot,
+                vibesPath: this.vibesPath,
+                runtime: this.runtime
+            },
+            updateState
+        };
+    }
+}
+/**
+ * Run the external setup wizard
+ */
+export async function runExternalSetupWizard(options) {
+    const { target, tier, global: installGlobal = false, vibesPath, runtime } = options;
+    // The wizard installs into the caller's project, else the bound workspace.
+    const projectDir = options.projectDir ?? (await runtime.context('runtime/workspace-path'));
+    // Create initial state
+    const initialState = createExternalSetupState();
+    // Pre-populate if target/tier provided (single-target mode)
+    if (target) {
+        initialState.external.selectedTargets = [target];
+    }
+    if (tier && target) {
+        initialState.external.tierSelections[target] = tier;
+    }
+    if (installGlobal) {
+        initialState.external.installLocation = 'global';
+    }
+    // Create wizard runner
+    const wizard = new ExternalSetupRunner(initialState, projectDir, vibesPath, runtime);
+    // Register steps
+    wizard.register(detectToolsStep);
+    wizard.register(selectTargetsStep);
+    wizard.register(selectTiersStep);
+    wizard.register(selectLocationStep);
+    wizard.register(installStep);
+    // Show intro
+    intro('vibes external setup');
+    try {
+        // Run the wizard
+        await wizard.runAll();
+        const finalState = wizard.getState();
+        if (finalState.metadata.skipped) {
+            cancel('Setup cancelled');
+            return {
+                success: false,
+                skipped: true,
+                results: []
+            };
+        }
+        // Show success outro
+        const successCount = finalState.external.results.filter((r) => r.success).length;
+        if (successCount > 0) {
+            outro(`Successfully configured ${successCount} tool(s) with vibes integration!`);
+        }
+        else {
+            outro('No tools were configured.');
+        }
+        return {
+            success: finalState.external.success,
+            skipped: false,
+            results: finalState.external.results
+        };
+    }
+    catch (error) {
+        cancel('Setup failed');
+        const failure = CaughtFailureSchema.parse(error);
+        return {
+            success: false,
+            skipped: false,
+            results: [],
+            error: failure instanceof Error ? failure.message : String(failure),
+            failure: valueFreeFailure(failure)
+        };
+    }
+}
+/**
+ * Quick setup with defaults (non-interactive)
+ */
+export function quickExternalSetup(options) {
+    // For quick setup, we run without interactive prompts
+    // Just detect and install with the specified settings
+    return runExternalSetupWizard({
+        ...options,
+        tier: options.tier === undefined ? undefined : ToolTierSchema.parse(options.tier),
+        nonInteractive: true
+    });
+}
+export { createExternalSetupState } from "./types.js";
+//# sourceMappingURL=wizard.js.map

package/dist/setup/wizard.js.map

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

package/dist/storage/agent-message.record.descriptor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Agent Message Storage Record
+ *
+ * Same-machine, cross-session agent messages. Cross-MACHINE delivery rides the
+ * ambient projection seam (see ambient/cloud-message-transport.impl.ts); this
+ * record is the local leg, and it is authoritative and offline-safe exactly
+ * like the touch record.
+ *
+ * EPHEMERAL BY CONSTRUCTION:
+ *  - every row carries `expiresAt`, and reads apply it (read-side expiry, no
+ *    sweep job),
+ *  - a claimed message is DELETED, not flagged — delivered-once must survive a
+ *    crash between read and mark.
+ *
+ * NOTE (verified, see file-access.record.descriptor.ts): StorageRecord CRUDs
+ * localdb tables as a JSON blob via json_extract, so declared indexes are real
+ * but ALTER TABLE migrations for new fields are not. Fields live in the schema.
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record/descriptor';
+export declare const AgentMessageRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    fromSessionId: z.ZodString;
+    fromMachineId: z.ZodOptional<z.ZodString>;
+    fromMachineName: z.ZodOptional<z.ZodString>;
+    fromWorkItemTitle: z.ZodOptional<z.ZodString>;
+    audienceKind: z.ZodEnum<{
+        path: "path";
+        workspace: "workspace";
+        session: "session";
+    }>;
+    audienceSessionId: z.ZodOptional<z.ZodString>;
+    audienceFilePath: z.ZodOptional<z.ZodString>;
+    audienceWorkspaceRoot: z.ZodOptional<z.ZodString>;
+    body: z.ZodString;
+    sentAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    expiresAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    createdAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+}, z.core.$strip>;
+export type AgentMessageRow = z.infer<typeof AgentMessageRowSchema>;
+export declare const agentMessageRecordDescriptor: StorageRecordDescriptorInput;
+export default agentMessageRecordDescriptor;
+//# sourceMappingURL=agent-message.record.descriptor.d.ts.map

package/dist/storage/agent-message.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-message.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/storage/agent-message.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAEnG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;iBAmBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,EAAE,4BA0C1C,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/storage/agent-message.record.descriptor.js

@@ -0,0 +1,72 @@
+/**
+ * Agent Message Storage Record
+ *
+ * Same-machine, cross-session agent messages. Cross-MACHINE delivery rides the
+ * ambient projection seam (see ambient/cloud-message-transport.impl.ts); this
+ * record is the local leg, and it is authoritative and offline-safe exactly
+ * like the touch record.
+ *
+ * EPHEMERAL BY CONSTRUCTION:
+ *  - every row carries `expiresAt`, and reads apply it (read-side expiry, no
+ *    sweep job),
+ *  - a claimed message is DELETED, not flagged — delivered-once must survive a
+ *    crash between read and mark.
+ *
+ * NOTE (verified, see file-access.record.descriptor.ts): StorageRecord CRUDs
+ * localdb tables as a JSON blob via json_extract, so declared indexes are real
+ * but ALTER TABLE migrations for new fields are not. Fields live in the schema.
+ */
+import * as z from 'zod/v4';
+export const AgentMessageRowSchema = z.object({
+    id: z.string().min(1),
+    fromSessionId: z.string().min(1),
+    fromMachineId: z.string().min(1).optional(),
+    fromMachineName: z.string().min(1).optional(),
+    fromWorkItemTitle: z.string().min(1).optional(),
+    /** Flattened audience so the columns are indexable. */
+    audienceKind: z.enum(['session', 'path', 'workspace']),
+    audienceSessionId: z.string().min(1).optional(),
+    audienceFilePath: z.string().min(1).optional(),
+    audienceWorkspaceRoot: z.string().min(1).optional(),
+    body: z.string().min(1).max(500),
+    sentAt: z.union([z.string(), z.date()]),
+    expiresAt: z.union([z.string(), z.date()]),
+    createdAt: z.union([z.string(), z.date()])
+});
+export const agentMessageRecordDescriptor = {
+    kind: 'storage/record',
+    id: 'external.agent_messages',
+    name: 'Agent Messages',
+    description: 'Ephemeral, delivered-once messages between agent sessions on this machine',
+    schema: AgentMessageRowSchema,
+    tableName: 'agent_messages',
+    primaryKey: 'id',
+    indexes: [
+        { name: 'idx_agent_messages_audience_kind', fields: ['audienceKind'], unique: false },
+        { name: 'idx_agent_messages_audience_path', fields: ['audienceFilePath'], unique: false },
+        { name: 'idx_agent_messages_audience_session', fields: ['audienceSessionId'], unique: false },
+        { name: 'idx_agent_messages_expires', fields: ['expiresAt'], unique: false }
+    ],
+    version: 1,
+    timestamps: { createdAt: 'createdAt' },
+    autoId: { field: 'id', strategy: 'uuid' },
+    // Hard delete: a claimed message is gone. Soft-deleting would leave an
+    // archive, and this surface deliberately has none.
+    softDelete: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': { dbName: 'external.db', scope: 'project' }
+    },
+    scope: 'project',
+    validateOnWrite: true,
+    validateOnRead: false,
+    internal: false,
+    namespace: 'external.agent_messages',
+    tags: ['external', 'ambient', 'messaging', 'ephemeral'],
+    versioning: false,
+    audit: false,
+    changeTracking: false
+};
+export default agentMessageRecordDescriptor;
+//# sourceMappingURL=agent-message.record.descriptor.js.map

package/dist/storage/agent-message.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-message.record.descriptor.js","sourceRoot":"","sources":["../../src/storage/agent-message.record.descriptor.ts"],"names":[],"mappings":"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"}

package/dist/storage/file-access.record.descriptor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * File Access Storage Record Descriptor
+ *
+ * Storage pattern for external tool file access tracking.
+ * This replaces the need for one-off adapters like LocalSQLiteExternalAdapter.
+ *
+ * @example
+ * ```typescript
+ * // Query from runtime
+ * const fileAccesses = await runtime
+ *   .query('storage/record')
+ *   .withId('external.file_accesses')
+ *   .resolve();
+ *
+ * // Track a file access
+ * const access = await fileAccesses.create({
+ *   sessionId: 'session-123',
+ *   filePath: '/src/lib/example.ts',
+ *   operation: 'read',
+ *   timestamp: new Date()
+ * });
+ *
+ * // List accesses with filters
+ * const result = await fileAccesses.list({
+ *   where: {
+ *     sessionId: 'session-123',
+ *     operation: 'edit'
+ *   },
+ *   orderBy: { timestamp: 'desc' },
+ *   limit: 100
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record/descriptor';
+/**
+ * File operation types
+ */
+export declare const FileOperationSchema: z.ZodEnum<{
+    read: "read";
+    write: "write";
+    delete: "delete";
+    edit: "edit";
+}>;
+/**
+ * Line range schema for partial file access
+ */
+export declare const LineRangeSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * File Access Schema
+ *
+ * Defines the structure of a file access tracking record.
+ * Tracks file operations during sessions for context and analytics.
+ */
+export declare const FileAccessSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    filePath: z.ZodString;
+    operation: z.ZodEnum<{
+        read: "read";
+        write: "write";
+        delete: "delete";
+        edit: "edit";
+    }>;
+    lineRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>>;
+    symbolsAccessed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    bytesRead: z.ZodOptional<z.ZodNumber>;
+    bytesWritten: z.ZodOptional<z.ZodNumber>;
+    diagnosticsCount: z.ZodOptional<z.ZodNumber>;
+    activeTodoId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+    participantId: z.ZodOptional<z.ZodString>;
+    participantSlug: z.ZodOptional<z.ZodString>;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    headSha: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    workItemTitle: z.ZodOptional<z.ZodString>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    createdAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    updatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>>;
+}, z.core.$strip>;
+export type FileOperation = z.infer<typeof FileOperationSchema>;
+export type LineRange = z.infer<typeof LineRangeSchema>;
+export type FileAccess = z.infer<typeof FileAccessSchema>;
+/**
+ * Storage Record Descriptor for File Accesses
+ *
+ * This descriptor defines how file access tracking data is stored, indexed, and managed.
+ */
+export declare const fileAccessRecordDescriptor: StorageRecordDescriptorInput;
+export default fileAccessRecordDescriptor;
+//# sourceMappingURL=file-access.record.descriptor.d.ts.map

package/dist/storage/file-access.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/storage/file-access.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAInG;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqF3B,CAAC;AAIH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,4BAuPxC,CAAC;AAIF,eAAe,0BAA0B,CAAC"}