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

package/dist/schemas/roster.js

@@ -0,0 +1,310 @@
+/**
+ * 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';
+/**
+ * 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 const ACTIVE_WINDOW_MS = 2 * 60 * 1000;
+export const RECENT_WINDOW_MS = 15 * 60 * 1000;
+/** Cap on roster lines. Past this the tail is summarised, never enumerated. */
+export const ROSTER_CAP = 5;
+export const RosterEntrySchema = z.object({
+    agentId: z.string().min(1),
+    providerId: z.string().min(1).nullable(),
+    modelId: z.string().min(1).nullable(),
+    sessionId: z.string().min(1),
+    sessionStartedAt: z.coerce.date(),
+    sessionLengthMs: z.number().int().nonnegative(),
+    machineId: z.string().min(1).optional(),
+    machineName: z.string().min(1).optional(),
+    participantId: z.string().min(1).optional(),
+    participantSlug: z.string().min(1).optional(),
+    runtimeEnvironment: z.string().min(1).optional(),
+    workspaceRoot: z.string().min(1).optional(),
+    gitBranch: z.string().min(1).optional(),
+    workItemId: z.string().min(1).optional(),
+    workItemTitle: z.string().min(1).optional(),
+    /** Most recent path this session touched — what they are in right now. */
+    lastPath: z.string().min(1).optional(),
+    lastSeen: z.coerce.date(),
+    ageMs: z.number().int().nonnegative(),
+    liveness: z.enum(['active', 'recent']),
+    origin: z.enum(['local', 'account'])
+});
+/** One seat in one room; participant is preferred, agent is the portable fallback. */
+export function agentSessionIdentityKey(identity) {
+    return `${identity.sessionId}\u0000${identity.participantId ?? identity.agentId ?? identity.sessionId}`;
+}
+function isExcluded(identity, options) {
+    if (options.exclude) {
+        if (identity.sessionId !== options.exclude.sessionId)
+            return false;
+        if (options.exclude.participantId) {
+            return identity.participantId === options.exclude.participantId;
+        }
+        if (options.exclude.agentId)
+            return identity.agentId === options.exclude.agentId;
+        return true;
+    }
+    return options.excludeSessionId === identity.sessionId;
+}
+/**
+ * Roll a touch stream up into one row per session.
+ *
+ * Pure and time-injected so the bands are testable without sleeping.
+ */
+export function rosterFromTouches(touches, options = {}) {
+    const now = options.now ?? new Date();
+    const byIdentity = new Map();
+    for (const touch of touches) {
+        const identity = {
+            sessionId: touch.sessionId,
+            participantId: touch.participantId,
+            agentId: touch.participantId ?? touch.sessionId
+        };
+        if (isExcluded(identity, options))
+            continue;
+        const ageMs = Math.max(0, now.getTime() - touch.timestamp.getTime());
+        // GHOST: past the recent band. Dropped, not greyed out — showing dead
+        // agents is how a roster earns being ignored.
+        if (ageMs > RECENT_WINDOW_MS)
+            continue;
+        const identityKey = agentSessionIdentityKey(identity);
+        const existing = byIdentity.get(identityKey);
+        // Keep the NEWEST touch per seat: that is what "last seen" means.
+        if (existing && existing.ageMs <= ageMs)
+            continue;
+        byIdentity.set(identityKey, {
+            agentId: touch.participantId ?? touch.sessionId,
+            providerId: null,
+            modelId: null,
+            sessionId: touch.sessionId,
+            // The touch stream predates account roster heartbeats, so it cannot
+            // prove the real start. This fallback is deliberately conservative;
+            // an account announcement replaces it during merge.
+            sessionStartedAt: touch.timestamp,
+            sessionLengthMs: Math.max(0, now.getTime() - touch.timestamp.getTime()),
+            machineId: touch.machineId,
+            machineName: touch.machineName,
+            participantId: touch.participantId,
+            participantSlug: touch.participantSlug,
+            runtimeEnvironment: touch.machineName,
+            workspaceRoot: touch.workspaceRoot,
+            gitBranch: touch.gitBranch,
+            workItemId: touch.workItemId,
+            workItemTitle: touch.workItemTitle,
+            lastPath: touch.filePath,
+            lastSeen: touch.timestamp,
+            ageMs,
+            liveness: ageMs <= ACTIVE_WINDOW_MS ? 'active' : 'recent',
+            origin: touch.origin === 'remote' ? 'account' : 'local'
+        });
+    }
+    return Array.from(byIdentity.values()).sort((a, b) => a.ageMs - b.ageMs);
+}
+/** Turn provider announcements into honest live rows at an injected clock. */
+export function rosterFromAnnouncements(announcements, options = {}) {
+    const now = options.now ?? new Date();
+    const byIdentity = new Map();
+    for (const announcement of announcements) {
+        if (isExcluded(announcement, options))
+            continue;
+        const ageMs = Math.max(0, now.getTime() - announcement.observedAt.getTime());
+        if (ageMs > RECENT_WINDOW_MS)
+            continue;
+        const identityKey = agentSessionIdentityKey(announcement);
+        const current = byIdentity.get(identityKey);
+        if (current && current.ageMs <= ageMs)
+            continue;
+        byIdentity.set(identityKey, {
+            agentId: announcement.agentId,
+            providerId: announcement.providerId,
+            modelId: announcement.modelId,
+            sessionId: announcement.sessionId,
+            sessionStartedAt: announcement.sessionStartedAt,
+            sessionLengthMs: Math.max(0, now.getTime() - announcement.sessionStartedAt.getTime()),
+            participantId: announcement.participantId,
+            participantSlug: announcement.participantSlug,
+            runtimeEnvironment: announcement.runtimeEnvironment,
+            machineId: announcement.machineId,
+            machineName: announcement.machineName,
+            workspaceRoot: announcement.workspaceRoot,
+            gitBranch: announcement.gitBranch,
+            workItemId: announcement.workItemId,
+            workItemTitle: announcement.workItemTitle,
+            lastSeen: announcement.observedAt,
+            ageMs,
+            liveness: ageMs <= ACTIVE_WINDOW_MS ? 'active' : 'recent',
+            origin: 'account'
+        });
+    }
+    return Array.from(byIdentity.values()).sort((a, b) => a.ageMs - b.ageMs);
+}
+/**
+ * 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 function mergeRosterEntries(entries, now = new Date()) {
+    const byIdentity = new Map();
+    const degraded = [];
+    const merge = (previous, entry) => {
+        const newest = entry.lastSeen > previous.lastSeen ? entry : previous;
+        const other = newest === entry ? previous : entry;
+        const sessionStartedAt = entry.sessionStartedAt < previous.sessionStartedAt
+            ? entry.sessionStartedAt
+            : previous.sessionStartedAt;
+        return {
+            ...other,
+            ...newest,
+            agentId: newest.agentId === newest.sessionId && other.agentId !== other.sessionId
+                ? other.agentId
+                : newest.agentId,
+            providerId: newest.providerId ?? other.providerId,
+            modelId: newest.modelId ?? other.modelId,
+            sessionStartedAt,
+            sessionLengthMs: Math.max(0, now.getTime() - sessionStartedAt.getTime()),
+            origin: entry.origin === 'account' || previous.origin === 'account' ? 'account' : 'local'
+        };
+    };
+    for (const entry of entries) {
+        if (!entry.participantId && entry.agentId === entry.sessionId) {
+            degraded.push(entry);
+            continue;
+        }
+        const identityKey = agentSessionIdentityKey(entry);
+        const previous = byIdentity.get(identityKey);
+        if (!previous) {
+            byIdentity.set(identityKey, entry);
+            continue;
+        }
+        byIdentity.set(identityKey, merge(previous, entry));
+    }
+    for (const entry of degraded) {
+        const candidates = [...byIdentity.entries()].filter(([, candidate]) => candidate.sessionId === entry.sessionId);
+        if (candidates.length === 0) {
+            byIdentity.set(agentSessionIdentityKey(entry), entry);
+        }
+        else if (candidates.length === 1) {
+            const [identityKey, candidate] = candidates[0];
+            byIdentity.set(identityKey, merge(candidate, entry));
+        }
+    }
+    return Array.from(byIdentity.values()).sort((a, b) => a.ageMs - b.ageMs);
+}
+function humanAge(ageMs) {
+    const seconds = Math.floor(ageMs / 1000);
+    if (seconds < 45)
+        return 'just now';
+    const minutes = Math.max(1, Math.round(seconds / 60));
+    return `${minutes}m ago`;
+}
+function humanDuration(durationMs) {
+    const totalMinutes = Math.floor(durationMs / 60_000);
+    if (totalMinutes < 1)
+        return '<1m';
+    const days = Math.floor(totalMinutes / (24 * 60));
+    const hours = Math.floor((totalMinutes % (24 * 60)) / 60);
+    const minutes = totalMinutes % 60;
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    return `${minutes}m`;
+}
+/** Trim a path to something readable in a one-line roster. */
+function shortPath(path) {
+    if (!path)
+        return undefined;
+    const parts = path.split('/').filter(Boolean);
+    return parts.length <= 2 ? path : parts.slice(-2).join('/');
+}
+function workDescription(entry) {
+    const base = entry.workItemTitle ??
+        (entry.workItemId ? `work ${entry.workItemId.slice(0, 8)}` : undefined) ??
+        shortPath(entry.lastPath) ??
+        '—';
+    const checkout = [
+        entry.gitBranch ? `branch:${entry.gitBranch}` : undefined,
+        entry.workspaceRoot ? `worktree:${shortPath(entry.workspaceRoot)}` : undefined
+    ].filter(Boolean);
+    return checkout.length > 0 ? `${base} (${checkout.join(' ')})` : base;
+}
+/**
+ * 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 function formatRosterLine(entries, cap = ROSTER_CAP) {
+    if (entries.length === 0)
+        return null;
+    const shown = entries.slice(0, cap);
+    const hidden = entries.length - shown.length;
+    const parts = shown.map((e) => {
+        const bits = [e.sessionId.slice(0, 8)];
+        if (e.machineName)
+            bits.push(`on ${e.machineName}`);
+        if (e.workItemTitle)
+            bits.push(`"${e.workItemTitle}"`);
+        else if (e.workItemId)
+            bits.push(`work ${e.workItemId.slice(0, 8)}`);
+        else if (shortPath(e.lastPath))
+            bits.push(`in ${shortPath(e.lastPath)}`);
+        return `${bits.join(' ')} (${humanAge(e.ageMs)})`;
+    });
+    const tail = hidden > 0 ? `, +${hidden} more` : '';
+    return `Also working: ${parts.join('; ')}${tail}.`;
+}
+/** Multi-line human rendering for `vibes who`. */
+export function formatRosterTable(entries) {
+    if (entries.length === 0) {
+        return 'No other agents are working right now.';
+    }
+    const rows = entries.map((e) => {
+        const dot = e.liveness === 'active' ? '●' : '○';
+        return {
+            dot,
+            agent: e.agentId,
+            model: e.modelId ?? 'unreported',
+            provider: e.providerId ?? 'unreported',
+            session: e.sessionId,
+            length: humanDuration(e.sessionLengthMs),
+            environment: e.runtimeEnvironment ?? e.machineName ?? e.machineId ?? e.origin,
+            seen: humanAge(e.ageMs)
+        };
+    });
+    const w = (key, header) => Math.max(header.length, ...rows.map((r) => String(r[key]).length));
+    const wAgent = w('agent', 'AGENT ID');
+    const wModel = w('model', 'MODEL');
+    const wProvider = w('provider', 'PROVIDER');
+    const wSession = w('session', 'SESSION ID');
+    const wLength = w('length', 'LENGTH');
+    const wEnvironment = w('environment', 'ENVIRONMENT');
+    const header = `  ${'AGENT ID'.padEnd(wAgent)}  ${'MODEL'.padEnd(wModel)}  ${'PROVIDER'.padEnd(wProvider)}  ${'SESSION ID'.padEnd(wSession)}  ${'LENGTH'.padEnd(wLength)}  ${'ENVIRONMENT'.padEnd(wEnvironment)}  LAST SEEN`;
+    const lines = rows.map((r) => `${r.dot} ${r.agent.padEnd(wAgent)}  ${r.model.padEnd(wModel)}  ${r.provider.padEnd(wProvider)}  ${r.session.padEnd(wSession)}  ${r.length.padEnd(wLength)}  ${r.environment.padEnd(wEnvironment)}  ${r.seen}`);
+    const details = entries
+        .filter((entry) => workDescription(entry) !== '—')
+        .map((entry) => `  ${entry.sessionId}: ${workDescription(entry)}`);
+    const active = entries.filter((e) => e.liveness === 'active').length;
+    const summary = `\n${entries.length} agent${entries.length === 1 ? '' : 's'}, ${active} active in the last 2 minutes.`;
+    return [header, ...lines, ...(details.length > 0 ? ['', 'Working on:', ...details] : [])].join('\n') + summary;
+}
+//# sourceMappingURL=roster.js.map

package/dist/schemas/roster.js.map

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

package/dist/schemas/tiers.d.ts

@@ -0,0 +1,95 @@
+/**
+ * External Tool Feature Tiers
+ *
+ * Defines tool availability tiers for external integrations.
+ * These are orthogonal to client-specific presets - tiers define
+ * what features are available, while client presets customize behavior.
+ */
+import * as z from 'zod/v4';
+export declare const ToolTierSchema: z.ZodEnum<{
+    default: "default";
+    full: "full";
+    minimal: "minimal";
+    recommended: "recommended";
+}>;
+export type ToolTier = z.infer<typeof ToolTierSchema>;
+export interface ToolTierDefinition {
+    id: ToolTier;
+    name: string;
+    description: string;
+    shortDescription: string;
+    patterns: string[];
+    disabledPatterns?: string[];
+}
+/**
+ * Minimal tier - Session tracking and language intelligence only
+ *
+ * For users who just want context preservation without full codebase tools.
+ */
+export declare const MINIMAL_TIER: ToolTierDefinition;
+/**
+ * Default tier - Core development tools
+ *
+ * Everything needed for effective AI-assisted coding.
+ * Recommended starting point for most users.
+ */
+export declare const DEFAULT_TIER: ToolTierDefinition;
+/**
+ * Recommended tier - Enhanced automation
+ *
+ * Adds browser, desktop, cognitive, and codemod capabilities for full-stack development.
+ */
+export declare const RECOMMENDED_TIER: ToolTierDefinition;
+/**
+ * Full tier - Everything available
+ *
+ * All MCP tools enabled for power users.
+ */
+export declare const FULL_TIER: ToolTierDefinition;
+export declare const EXTERNAL_TOOL_TIERS: {
+    minimal: ToolTierDefinition;
+    default: ToolTierDefinition;
+    recommended: ToolTierDefinition;
+    full: ToolTierDefinition;
+};
+/**
+ * Get a tier definition by ID
+ */
+export declare function getTierDefinition(tier: ToolTier): ToolTierDefinition;
+/**
+ * Get all tier definitions as an array (for UI selection)
+ */
+export declare function getAllTiers(): ToolTierDefinition[];
+/**
+ * Check if a tool ID matches any pattern in a tier
+ */
+export declare function isToolInTier(toolId: string, tier: ToolTier): boolean;
+/**
+ * Get all tool patterns for a tier (expanded from wildcards)
+ */
+export interface TierPatterns {
+    enabled: string[];
+    disabled: string[];
+}
+export declare function getTierPatterns(tier: ToolTier): TierPatterns;
+export declare const TierSelectionSchema: z.ZodObject<{
+    target: z.ZodString;
+    tier: z.ZodEnum<{
+        default: "default";
+        full: "full";
+        minimal: "minimal";
+        recommended: "recommended";
+    }>;
+}, z.core.$strip>;
+export type TierSelection = z.infer<typeof TierSelectionSchema>;
+export declare const TierSelectionsSchema: z.ZodArray<z.ZodObject<{
+    target: z.ZodString;
+    tier: z.ZodEnum<{
+        default: "default";
+        full: "full";
+        minimal: "minimal";
+        recommended: "recommended";
+    }>;
+}, z.core.$strip>>;
+export type TierSelections = z.infer<typeof TierSelectionsSchema>;
+//# sourceMappingURL=tiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../src/schemas/tiers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,cAAc;;;;;EAAwD,CAAC;AACpF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,kBAM1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,kBAgB1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAoB9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,kBAUvB,CAAC;AAIF,eAAO,MAAM,mBAAmB;;;;;CAKgB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAUpE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAM5D;AAeD,eAAO,MAAM,mBAAmB;;;;;;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;kBAA+B,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schemas/tiers.js

@@ -0,0 +1,143 @@
+/**
+ * External Tool Feature Tiers
+ *
+ * Defines tool availability tiers for external integrations.
+ * These are orthogonal to client-specific presets - tiers define
+ * what features are available, while client presets customize behavior.
+ */
+import * as z from 'zod/v4';
+// Tier Definitions
+export const ToolTierSchema = z.enum(['minimal', 'default', 'recommended', 'full']);
+/**
+ * Minimal tier - Session tracking and language intelligence only
+ *
+ * For users who just want context preservation without full codebase tools.
+ */
+export const MINIMAL_TIER = {
+    id: 'minimal',
+    name: 'Minimal',
+    description: 'Session tracking and language intelligence only',
+    shortDescription: 'session, workspace-lsp',
+    patterns: ['session', 'session-todo', 'session-scratchpad', 'session-collaborate', 'workspace-lsp']
+};
+/**
+ * Default tier - Core development tools
+ *
+ * Everything needed for effective AI-assisted coding.
+ * Recommended starting point for most users.
+ */
+export const DEFAULT_TIER = {
+    id: 'default',
+    name: 'Default',
+    description: 'Core development tools - file operations and code intelligence',
+    shortDescription: 'session, workspace-*',
+    patterns: [
+        'session',
+        'session-todo',
+        'session-scratchpad',
+        'session-collaborate',
+        'workspace-fs',
+        'workspace-search',
+        'workspace-lsp',
+        'workspace-lock',
+        'workspace-rules'
+    ]
+};
+/**
+ * Recommended tier - Enhanced automation
+ *
+ * Adds browser, desktop, cognitive, and codemod capabilities for full-stack development.
+ */
+export const RECOMMENDED_TIER = {
+    id: 'recommended',
+    name: 'Recommended',
+    description: 'Enhanced automation with browser, desktop, knowledge, codemod, and cognitive tools',
+    shortDescription: 'default + browser, desktop, knowledge, codemod, brain, personal',
+    patterns: [
+        // All default tools
+        ...DEFAULT_TIER.patterns,
+        // Browser automation
+        'browser',
+        // Desktop/TUI automation
+        'desktop',
+        // Knowledge base
+        'knowledge',
+        // Code modifications
+        'codemod',
+        // Cognitive/brain tools
+        'brain',
+        'personal'
+    ]
+};
+/**
+ * Full tier - Everything available
+ *
+ * All MCP tools enabled for power users.
+ */
+export const FULL_TIER = {
+    id: 'full',
+    name: 'Full',
+    description: 'All available tools for power users',
+    shortDescription: 'everything',
+    patterns: ['*'],
+    disabledPatterns: [
+        'run-command', // Safety: never expose shell execution by default
+        'run_command' // Legacy retired id — keep blocked if stale configs reappear
+    ]
+};
+// Tier Registry
+export const EXTERNAL_TOOL_TIERS = {
+    minimal: MINIMAL_TIER,
+    default: DEFAULT_TIER,
+    recommended: RECOMMENDED_TIER,
+    full: FULL_TIER
+};
+/**
+ * Get a tier definition by ID
+ */
+export function getTierDefinition(tier) {
+    return EXTERNAL_TOOL_TIERS[tier];
+}
+/**
+ * Get all tier definitions as an array (for UI selection)
+ */
+export function getAllTiers() {
+    return [MINIMAL_TIER, DEFAULT_TIER, RECOMMENDED_TIER, FULL_TIER];
+}
+/**
+ * Check if a tool ID matches any pattern in a tier
+ */
+export function isToolInTier(toolId, tier) {
+    const definition = EXTERNAL_TOOL_TIERS[tier];
+    // Check disabled patterns first
+    if (definition.disabledPatterns?.some((p) => matchPattern(toolId, p))) {
+        return false;
+    }
+    // Check enabled patterns
+    return definition.patterns.some((p) => matchPattern(toolId, p));
+}
+export function getTierPatterns(tier) {
+    const definition = EXTERNAL_TOOL_TIERS[tier];
+    return {
+        enabled: definition.patterns,
+        disabled: definition.disabledPatterns ?? []
+    };
+}
+/**
+ * Match a tool ID against a glob-style pattern
+ */
+function matchPattern(toolId, pattern) {
+    if (pattern === '*')
+        return true;
+    if (pattern.endsWith('*')) {
+        return toolId.startsWith(pattern.slice(0, -1));
+    }
+    return toolId === pattern;
+}
+// Tier Selection Schema (for wizard)
+export const TierSelectionSchema = z.object({
+    target: z.string().regex(/^[a-z][a-z0-9-]*$/).describe('External tool descriptor ID'),
+    tier: ToolTierSchema
+});
+export const TierSelectionsSchema = z.array(TierSelectionSchema);
+//# sourceMappingURL=tiers.js.map

package/dist/schemas/tiers.js.map

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

package/dist/schemas/touch-identity.d.ts

@@ -0,0 +1,25 @@
+import * as z from 'zod/v4';
+/** Optional identity facts recorded with an ambient touch. */
+export declare const TouchIdentitySchema: z.ZodObject<{
+    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>;
+}, z.core.$strip>;
+export type TouchIdentity = z.infer<typeof TouchIdentitySchema>;
+export declare const CachedMachineIdentitySchema: z.ZodObject<{
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CachedMachineIdentity = z.infer<typeof CachedMachineIdentitySchema>;
+export declare const CachedCheckoutIdentitySchema: z.ZodObject<{
+    gitBranch: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodNumber;
+}, z.core.$strip>;
+export type CachedCheckoutIdentity = z.infer<typeof CachedCheckoutIdentitySchema>;
+//# sourceMappingURL=touch-identity.d.ts.map

package/dist/schemas/touch-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-identity.d.ts","sourceRoot":"","sources":["../../src/schemas/touch-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAU9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,2BAA2B;;;iBAAmE,CAAC;AAC5G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,eAAO,MAAM,4BAA4B;;;iBAAwE,CAAC;AAClH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/schemas/touch-identity.js

@@ -0,0 +1,16 @@
+import * as z from 'zod/v4';
+/** Optional identity facts recorded with an ambient touch. */
+export const TouchIdentitySchema = z.object({
+    machineId: z.string().optional(),
+    machineName: z.string().optional(),
+    participantId: z.string().optional(),
+    participantSlug: z.string().optional(),
+    workspaceRoot: z.string().optional(),
+    gitBranch: z.string().optional(),
+    headSha: z.string().optional(),
+    workItemId: z.string().optional(),
+    workItemTitle: z.string().optional()
+});
+export const CachedMachineIdentitySchema = TouchIdentitySchema.pick({ machineId: true, machineName: true });
+export const CachedCheckoutIdentitySchema = z.object({ gitBranch: z.string().optional(), expiresAt: z.number() });
+//# sourceMappingURL=touch-identity.js.map

package/dist/schemas/touch-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-identity.js","sourceRoot":"","sources":["../../src/schemas/touch-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAE5G,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}