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

package/dist/schemas/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/schemas/presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAK5B,eAAO,MAAM,wBAAwB,aAGI,CAAC;AAC1C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;iBAchC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBASnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAY7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAa3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,wBAAwB;;;;;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAavB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,sBAAsB;;;;;;;;iBAgBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/presets.js

@@ -0,0 +1,270 @@
+/**
+ * Unified Preset/Recipe Schemas for External Tool Integration
+ *
+ * Provides common schemas for configuring external tool descriptors with
+ * vibes integration presets.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+import { hookLifecycleEventSchema } from "../plugins/schemas/manifest.js";
+// External Tool Targets
+export const ExternalToolTargetSchema = z
+    .string()
+    .regex(/^[a-z][a-z0-9-]*$/)
+    .describe('External tool descriptor ID');
+// Preset Categories
+export const PresetCategorySchema = z.enum([
+    'integration', // MCP, hooks, plugins
+    'model', // Model provider/selection
+    'workflow', // Approval, sandbox, permissions
+    'alias' // CLI aliases
+]);
+// Recipe Step Types
+export const RecipeStepTypeSchema = z.enum([
+    'file-write', // Write a file
+    'file-edit', // Edit existing file (JSON merge, TOML merge)
+    'file-copy', // Copy from template
+    'file-backup', // Timestamped backup of named files under a base dir
+    'file-restore', // Restore files from a timestamped backup
+    'command', // Run shell command
+    'hook-install', // Install hook scripts
+    'mcp-configure', // Configure MCP server
+    'adapter-codegen', // runtime-discovered tools/adapter codegen
+    'operation', // Execute a provider-owned external/operation asset
+    'prompt', // Show user prompt/confirmation
+    'validate' // Validate preconditions
+]);
+// Recipe Step Schemas
+export const FileWriteStepSchema = z.object({
+    type: z.literal('file-write'),
+    path: z.string().describe('File path (supports ~ and {{variables}})'),
+    content: z.string().describe('File content (supports {{variables}})'),
+    mode: z.number().optional().describe('File permissions (e.g., 0o755)'),
+    overwrite: z.boolean().optional(),
+    createDirs: z.boolean().optional()
+});
+export const FileEditStepSchema = z.object({
+    type: z.literal('file-edit'),
+    path: z.string().describe('File path to edit'),
+    format: z.enum(['json', 'toml', 'yaml']),
+    merge: z.record(z.string(), JsonValueSchema).describe('Deep merge this into existing file'),
+    arrayStrategy: z.enum(['append', 'replace', 'merge']).optional()
+});
+export const FileCopyStepSchema = z.object({
+    type: z.literal('file-copy'),
+    source: z.string().describe('Source file or template path'),
+    destination: z.string().describe('Destination path'),
+    mode: z.number().optional(),
+    overwrite: z.boolean().default(false)
+});
+/**
+ * Timestamped backup of named files under a base directory (shared recipe step).
+ * Replaces ad-hoc Claude-only backup utilities for any target.
+ */
+export const FileBackupStepSchema = z.object({
+    type: z.literal('file-backup'),
+    /** Directory containing the files (supports ~ and {{variables}}) */
+    baseDir: z.string(),
+    /** Relative filenames under baseDir to back up if they exist */
+    files: z.array(z.string()).min(1),
+    /** Subdirectory name for timestamped backups (default: backups) */
+    backupDirName: z.string().default('backups'),
+    /**
+     * When set, store the absolute backup directory path in this recipe
+     * variable so a later file-restore can use {{variable}}.
+     */
+    variable: z.string().optional()
+});
+/**
+ * Restore files from a timestamped backup produced by file-backup.
+ */
+export const FileRestoreStepSchema = z.object({
+    type: z.literal('file-restore'),
+    /** Destination base directory (supports ~ and {{variables}}) */
+    baseDir: z.string(),
+    /**
+     * Absolute path to a specific backup directory. Prefer this when a prior
+     * file-backup step stored the path in a variable.
+     */
+    backupDir: z.string().optional(),
+    /** Timestamp folder name under baseDir/backupDirName when backupDir omitted */
+    backupTimestamp: z.string().optional(),
+    backupDirName: z.string().default('backups'),
+    /** Optional subset of files; default = all files present in the backup */
+    files: z.array(z.string()).optional()
+});
+export const CommandStepSchema = z.object({
+    type: z.literal('command'),
+    command: z.string(),
+    args: z.array(z.string()).default([]),
+    cwd: z.string().optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    silent: z.boolean().default(false),
+    allowFailure: z.boolean().default(false)
+});
+export const HookInstallStepSchema = z.object({
+    type: z.literal('hook-install'),
+    target: ExternalToolTargetSchema,
+    hooks: z.array(hookLifecycleEventSchema),
+    vibesPath: z.string().default('vibes'),
+    /** When omitted, executeRecipe uses ExecutionContext.global */
+    global: z.boolean().optional()
+});
+export const McpConfigureStepSchema = z.object({
+    type: z.literal('mcp-configure'),
+    target: ExternalToolTargetSchema,
+    serverName: z.string().default('vibes'),
+    command: z.string(),
+    args: z.array(z.string()),
+    env: z.record(z.string(), z.string()).optional(),
+    timeout: z.number().optional().describe('Startup timeout in seconds'),
+    toolTimeout: z.number().optional().describe('Tool execution timeout'),
+    enabledTools: z.array(z.string()).optional(),
+    disabledTools: z.array(z.string()).optional(),
+    /** When omitted, executeRecipe uses ExecutionContext.global */
+    global: z.boolean().optional(),
+    tier: z
+        .enum(['minimal', 'default', 'recommended', 'full'])
+        .optional()
+        .describe('Agent-pack tool tier for MCP/skills surface')
+});
+export const AdapterCodegenStepSchema = z.object({
+    type: z.literal('adapter-codegen'),
+    adapterId: z.string().trim().min(1).describe('Runtime tools/adapter descriptor id'),
+    outputDir: z.string().optional(),
+    tier: z
+        .enum(['minimal', 'default', 'recommended', 'full'])
+        .optional()
+        .describe('Agent-pack tool tier for codegen filters'),
+    global: z.boolean().optional().describe('Use global output paths (skills)')
+});
+export const OperationStepSchema = z.object({
+    type: z.literal('operation'),
+    operationId: z.string().trim().min(1),
+    options: z.record(z.string(), z.unknown()).default({})
+});
+export const PromptStepSchema = z.object({
+    type: z.literal('prompt'),
+    message: z.string(),
+    promptType: z.enum(['confirm', 'input', 'select']).default('confirm'),
+    options: z.array(z.string()).optional().describe('Options for select type'),
+    default: z.string().optional(),
+    variable: z.string().optional().describe('Store response in variable')
+});
+export const ValidateStepSchema = z.object({
+    type: z.literal('validate'),
+    check: z.enum([
+        'tool-installed', // Check external tool is installed
+        'vibes-authenticated', // Check vibes auth
+        'session-active', // Check active session
+        'file-exists', // Check file exists
+        'command-available' // Check command in PATH
+    ]),
+    target: z.string().optional().describe('Path or command name'),
+    message: z.string().optional().describe('Error message if fails'),
+    fatal: z.boolean().default(true)
+});
+export const RecipeStepSchema = z.discriminatedUnion('type', [
+    FileWriteStepSchema,
+    FileEditStepSchema,
+    FileCopyStepSchema,
+    FileBackupStepSchema,
+    FileRestoreStepSchema,
+    CommandStepSchema,
+    HookInstallStepSchema,
+    McpConfigureStepSchema,
+    AdapterCodegenStepSchema,
+    OperationStepSchema,
+    PromptStepSchema,
+    ValidateStepSchema
+]);
+// Recipe Schema
+export const RecipeSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    steps: z.array(RecipeStepSchema),
+    rollback: z.array(RecipeStepSchema).optional().describe('Undo steps if fails'),
+    variables: z.record(z.string(), z.string()).optional().describe('Default template variables')
+});
+// Preset Features Schema
+export const PresetFeaturesSchema = z.object({
+    mcpServer: z.boolean().default(false),
+    hooks: z.array(z.string()).default([]),
+    aliases: z.array(z.string()).default([]),
+    modelConfig: z.boolean().default(false),
+    workflowConfig: z.boolean().default(false),
+    disableInternalTools: z.boolean().default(false)
+});
+// Preset Requirements Schema
+export const PresetRequirementsSchema = z.object({
+    vibesVersion: z.string().optional(),
+    toolVersion: z.string().optional(),
+    platform: z.array(z.enum(['darwin', 'linux', 'win32'])).optional(),
+    dependencies: z.array(z.string()).optional()
+});
+// Preset Schema
+export const PresetSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    target: ExternalToolTargetSchema,
+    category: PresetCategorySchema,
+    tags: z.array(z.string()).default([]),
+    features: PresetFeaturesSchema,
+    recipe: RecipeSchema,
+    requires: PresetRequirementsSchema.optional(),
+    author: z.string().optional(),
+    version: z.string().default('1.0.0'),
+    homepage: z.url().optional()
+});
+// Preset Registry Schema
+export const PresetRegistrySchema = z.object({
+    version: z.string(),
+    presets: z.array(PresetSchema),
+    aliases: z.record(z.string(), z.string()).describe('alias -> preset id')
+});
+// Execution Context Schema
+export const ExecutionContextSchema = z.object({
+    target: ExternalToolTargetSchema,
+    projectDir: z.string(),
+    global: z.boolean().default(false),
+    dryRun: z.boolean().default(false),
+    variables: z.record(z.string(), z.string()).default({}),
+    vibesPath: z.string().default('vibes'),
+    includeTools: z
+        .boolean()
+        .optional()
+        .describe('Opt in to per-tool SKILL.md projection. Absent/false by default — the projection is ' +
+        'retired (docs/architecture/CONTEXT-ENGINEERING.md). Set only by the explicit ' +
+        '`vibes dev external skills generate --include-tools` flag; AdapterCodegenStep has no ' +
+        'field for it, so a preset recipe cannot turn it on.')
+});
+// Execution Result Schema
+export const StepResultSchema = z.object({
+    step: z.number(),
+    type: RecipeStepTypeSchema,
+    success: z.boolean(),
+    message: z.string().optional(),
+    error: z.string().optional(),
+    filesCreated: z.array(z.string()).optional(),
+    filesModified: z.array(z.string()).optional(),
+    skipped: z.boolean().optional(),
+    /** A failed step's value-free facts: class name, errno or taxonomy code, and a CapabilityError reason. */
+    failure: z
+        .object({ name: z.string(), code: z.string().optional(), reason: z.string().optional() })
+        .optional()
+});
+export const ExecutionResultSchema = z.object({
+    preset: z.string(),
+    target: ExternalToolTargetSchema,
+    success: z.boolean(),
+    dryRun: z.boolean(),
+    steps: z.array(StepResultSchema),
+    filesCreated: z.array(z.string()),
+    filesModified: z.array(z.string()),
+    aliasesCreated: z.array(z.string()),
+    nextSteps: z.array(z.string()),
+    error: z.string().optional()
+});
+//# sourceMappingURL=presets.js.map

package/dist/schemas/presets.js.map

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

package/dist/schemas/roster.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The roster — who is working right now, where, on what.
+ *
+ * DERIVED, NEVER USER-DECLARED. Account heartbeats project live runtime/session
+ * facts; recent file touches remain a local collision fallback. Both age out
+ * automatically, so an agent never has to remember to mark itself departed and
+ * a crashed session disappears without a sweep job.
+ *
+ * HONESTY ABOUT STALENESS IS THE WHOLE PRODUCT. A roster that shows dead agents
+ * as present teaches everyone to ignore it, and an ignored line is pure tax on
+ * every context window forever. So a row is classified, and ghosts are dropped
+ * rather than shown greyed out.
+ */
+import * as z from 'zod/v4';
+import type { AgentSessionAnnouncement } from './agent-roster.ts';
+import type { TouchPeer } from './collision.ts';
+/**
+ * Liveness bands.
+ *
+ * `active`  — touched something in the last 2 minutes. Working right now.
+ * `recent`  — last 15 minutes. Probably still around, maybe thinking.
+ * Anything older is a GHOST and is not returned at all.
+ */
+export declare const ACTIVE_WINDOW_MS: number;
+export declare const RECENT_WINDOW_MS: number;
+/** Cap on roster lines. Past this the tail is summarised, never enumerated. */
+export declare const ROSTER_CAP = 5;
+export declare const RosterEntrySchema: z.ZodObject<{
+    agentId: z.ZodString;
+    providerId: z.ZodNullable<z.ZodString>;
+    modelId: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodString;
+    sessionStartedAt: z.ZodCoercedDate<unknown>;
+    sessionLengthMs: z.ZodNumber;
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+    participantId: z.ZodOptional<z.ZodString>;
+    participantSlug: z.ZodOptional<z.ZodString>;
+    runtimeEnvironment: z.ZodOptional<z.ZodString>;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    workItemTitle: z.ZodOptional<z.ZodString>;
+    lastPath: z.ZodOptional<z.ZodString>;
+    lastSeen: z.ZodCoercedDate<unknown>;
+    ageMs: z.ZodNumber;
+    liveness: z.ZodEnum<{
+        active: "active";
+        recent: "recent";
+    }>;
+    origin: z.ZodEnum<{
+        local: "local";
+        account: "account";
+    }>;
+}, z.core.$strip>;
+export type RosterEntry = z.infer<typeof RosterEntrySchema>;
+export interface AgentSessionIdentity {
+    sessionId: string;
+    participantId?: string;
+    agentId?: string;
+}
+export interface RosterQueryOptions {
+    now?: Date;
+    /** Exact caller identity. Prefer this for shared sessions. */
+    exclude?: AgentSessionIdentity;
+    /** Compatibility fallback for hosts that cannot yet identify a participant. */
+    excludeSessionId?: string;
+}
+/** One seat in one room; participant is preferred, agent is the portable fallback. */
+export declare function agentSessionIdentityKey(identity: AgentSessionIdentity): string;
+/**
+ * Roll a touch stream up into one row per session.
+ *
+ * Pure and time-injected so the bands are testable without sleeping.
+ */
+export declare function rosterFromTouches(touches: TouchPeer[], options?: RosterQueryOptions): RosterEntry[];
+/** Turn provider announcements into honest live rows at an injected clock. */
+export declare function rosterFromAnnouncements(announcements: AgentSessionAnnouncement[], options?: RosterQueryOptions): RosterEntry[];
+/**
+ * Merge local and account providers by seat identity. A legacy local touch with
+ * no participant can enrich a single known seat in that session; when several
+ * seats share the room it is ambiguous and is dropped instead of collapsing or
+ * inventing a third person. Newest liveness wins; known identity fills nulls.
+ */
+export declare function mergeRosterEntries(entries: RosterEntry[], now?: Date): RosterEntry[];
+/**
+ * ONE line for the wake packet.
+ *
+ * Returns null when nobody else is around — and ALONE IS THE COMMON CASE, so
+ * this must cost exactly zero bytes then. Every session pays for this line
+ * forever; it earns its place only by being short, current, and true.
+ */
+export declare function formatRosterLine(entries: RosterEntry[], cap?: number): string | null;
+/** Multi-line human rendering for `vibes who`. */
+export declare function formatRosterTable(entries: RosterEntry[]): string;
+//# sourceMappingURL=roster.d.ts.map

package/dist/schemas/roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../../src/schemas/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,8DAA8D;IAC9D,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAE9E;AAcD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,GAAE,kBAAuB,GAC9B,WAAW,EAAE,CAqDf;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACtC,aAAa,EAAE,wBAAwB,EAAE,EACzC,OAAO,GAAE,kBAAuB,GAC9B,WAAW,EAAE,CAoCf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,OAAa,GAAG,WAAW,EAAE,CAqD1F;AAwCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI,CAiBxF;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CA0ChE"}