@viewportai/daemon 0.1.0

package/dist/core/agent-registry.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Agent Registry — the extensibility backbone of Viewport.
+ *
+ * Agent definitions describe how to detect, configure, and instantiate
+ * each supported agent. The daemon core never imports agent-specific code
+ * directly — it loads agents from the registry.
+ *
+ * Two tiers:
+ *   - SDK adapters: deep integration (structured tool calls, permissions, tokens)
+ *   - PTY adapters: broad compatibility (terminal I/O, spawn any CLI)
+ */
+import type { AgentAdapter, SessionDiscovery } from './interfaces.js';
+import type { PermissionsConfig, GitTrackerConfig } from './types.js';
+export type AgentTier = 'sdk' | 'pty';
+export interface AgentDefaults {
+    /** Tool names that trigger git commits. */
+    commitOn: string[];
+    /** Tools that are safe to auto-approve. */
+    autoApprove: string[];
+    /** Tools that require user approval. */
+    requireApproval: string[];
+    /** Tools to always deny. */
+    deny: string[];
+}
+export interface AgentCapabilities {
+    /** Agent emits structured tool call events. */
+    structuredToolCalls: boolean;
+    /** Agent supports interactive permission callbacks. */
+    permissionCallbacks: boolean;
+    /** Agent reports token usage. */
+    tokenUsage: boolean;
+    /** Sessions can be resumed. */
+    resume: boolean;
+    /** Agent supports extended thinking / chain-of-thought streaming. */
+    extendedThinking: boolean;
+}
+export interface AgentDetection {
+    /** Check if the agent is installed / available on this machine. */
+    check: () => Promise<boolean>;
+    /** Human-readable description (shown in `vpd install`). */
+    description: string;
+}
+/** Model info from agent SDKs (e.g. Claude's supportedModels()). */
+export interface ModelInfo {
+    /** Model identifier to use in API calls. */
+    value: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Description of the model's capabilities. */
+    description: string;
+    /** Whether this model supports effort levels. */
+    supportsEffort?: boolean;
+    /** Available effort levels for this model. */
+    supportedEffortLevels?: ('low' | 'medium' | 'high' | 'max')[];
+    /** Whether this model supports adaptive thinking. */
+    supportsAdaptiveThinking?: boolean;
+}
+export interface AgentDefinition {
+    /** Unique identifier (e.g. 'claude', 'aider', 'codex'). */
+    id: string;
+    /** Display name for UIs. */
+    displayName: string;
+    /** Integration tier. */
+    tier: AgentTier;
+    /** Agent-specific tool defaults (merged into config resolution chain). */
+    defaults: AgentDefaults;
+    /** Declared capabilities — UI adapts based on these. */
+    capabilities: AgentCapabilities;
+    /** Detection: how to check if this agent is available. */
+    detection: AgentDetection;
+    /** Factory: create an adapter. Returns null if unavailable. */
+    createAdapter: () => Promise<AgentAdapter | null>;
+    /** Factory: create a discovery provider (for agents that persist session history). */
+    createDiscovery?: () => Promise<SessionDiscovery | null>;
+    /** Directories this agent uses for session storage (for file watching). */
+    watchDirs?: () => string[];
+    /** Fetch available models from the agent's SDK. Returns empty array if not supported. */
+    fetchModels?: () => Promise<ModelInfo[]>;
+}
+export declare class AgentRegistry {
+    private definitions;
+    private cachedModels;
+    /** Register an agent definition. */
+    register(definition: AgentDefinition): void;
+    /** Get an agent definition by ID. */
+    get(agentId: string): AgentDefinition | undefined;
+    /** Get all registered definitions. */
+    getAll(): AgentDefinition[];
+    /** Get agent IDs. */
+    getIds(): string[];
+    /** Check which registered agents are available on this machine. */
+    detectAvailable(): Promise<Map<string, boolean>>;
+    /**
+     * Resolve agent-specific permissions defaults.
+     * Returns a PermissionsConfig from the agent's registered defaults,
+     * used as the base layer in config resolution.
+     */
+    resolveAgentPermissions(agentId: string): PermissionsConfig | undefined;
+    /**
+     * Resolve agent-specific git tracker defaults.
+     * Returns partial GitTrackerConfig with commitOn from the agent's defaults.
+     */
+    resolveAgentGitConfig(agentId: string): Partial<GitTrackerConfig> | undefined;
+    /** Get capabilities for a specific agent (for hello message). */
+    getCapabilities(agentId: string): AgentCapabilities | undefined;
+    /** Get all directories that registered agents want watched. */
+    getAllWatchDirs(): string[];
+    /**
+     * Fetch available models from all registered agents that support it.
+     * Results are cached — call invalidateModelCache() to refresh.
+     */
+    fetchAllModels(): Promise<ModelInfo[]>;
+    /** Get cached models (synchronous — returns empty if not yet fetched). */
+    getCachedModels(): ModelInfo[];
+    /** Invalidate the model cache (e.g. on reconnect). */
+    invalidateModelCache(): void;
+    /** Serialize all agents for the hello message. */
+    toHelloPayload(): AgentInfo[];
+}
+/** Serialized agent info for the wire protocol (hello message). */
+export interface AgentInfo {
+    id: string;
+    displayName: string;
+    tier: AgentTier;
+    available: boolean;
+    capabilities: AgentCapabilities;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/core/agent-registry.d.ts.map

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

package/dist/core/agent-registry.js

@@ -0,0 +1,131 @@
+/**
+ * Agent Registry — the extensibility backbone of Viewport.
+ *
+ * Agent definitions describe how to detect, configure, and instantiate
+ * each supported agent. The daemon core never imports agent-specific code
+ * directly — it loads agents from the registry.
+ *
+ * Two tiers:
+ *   - SDK adapters: deep integration (structured tool calls, permissions, tokens)
+ *   - PTY adapters: broad compatibility (terminal I/O, spawn any CLI)
+ */
+// ---------------------------------------------------------------------------
+// Agent registry — holds registered definitions
+// ---------------------------------------------------------------------------
+export class AgentRegistry {
+    definitions = new Map();
+    cachedModels = null;
+    /** Register an agent definition. */
+    register(definition) {
+        this.definitions.set(definition.id, definition);
+    }
+    /** Get an agent definition by ID. */
+    get(agentId) {
+        return this.definitions.get(agentId);
+    }
+    /** Get all registered definitions. */
+    getAll() {
+        return [...this.definitions.values()];
+    }
+    /** Get agent IDs. */
+    getIds() {
+        return [...this.definitions.keys()];
+    }
+    /** Check which registered agents are available on this machine. */
+    async detectAvailable() {
+        const results = new Map();
+        const checks = this.getAll().map(async (def) => {
+            try {
+                const available = await def.detection.check();
+                results.set(def.id, available);
+            }
+            catch {
+                results.set(def.id, false);
+            }
+        });
+        await Promise.all(checks);
+        return results;
+    }
+    /**
+     * Resolve agent-specific permissions defaults.
+     * Returns a PermissionsConfig from the agent's registered defaults,
+     * used as the base layer in config resolution.
+     */
+    resolveAgentPermissions(agentId) {
+        const def = this.definitions.get(agentId);
+        if (!def)
+            return undefined;
+        return {
+            autoApprove: def.defaults.autoApprove,
+            requireApproval: def.defaults.requireApproval,
+            deny: def.defaults.deny,
+        };
+    }
+    /**
+     * Resolve agent-specific git tracker defaults.
+     * Returns partial GitTrackerConfig with commitOn from the agent's defaults.
+     */
+    resolveAgentGitConfig(agentId) {
+        const def = this.definitions.get(agentId);
+        if (!def)
+            return undefined;
+        return {
+            commitOn: def.defaults.commitOn,
+        };
+    }
+    /** Get capabilities for a specific agent (for hello message). */
+    getCapabilities(agentId) {
+        return this.definitions.get(agentId)?.capabilities;
+    }
+    /** Get all directories that registered agents want watched. */
+    getAllWatchDirs() {
+        const dirs = [];
+        for (const def of this.definitions.values()) {
+            if (def.watchDirs) {
+                dirs.push(...def.watchDirs());
+            }
+        }
+        return dirs;
+    }
+    /**
+     * Fetch available models from all registered agents that support it.
+     * Results are cached — call invalidateModelCache() to refresh.
+     */
+    async fetchAllModels() {
+        if (this.cachedModels)
+            return this.cachedModels;
+        const allModels = [];
+        for (const def of this.definitions.values()) {
+            if (def.fetchModels) {
+                try {
+                    const models = await def.fetchModels();
+                    allModels.push(...models);
+                }
+                catch {
+                    // Agent's model fetch failed — non-fatal
+                }
+            }
+        }
+        this.cachedModels = allModels;
+        return allModels;
+    }
+    /** Get cached models (synchronous — returns empty if not yet fetched). */
+    getCachedModels() {
+        return this.cachedModels ?? [];
+    }
+    /** Invalidate the model cache (e.g. on reconnect). */
+    invalidateModelCache() {
+        this.cachedModels = null;
+    }
+    /** Serialize all agents for the hello message. */
+    toHelloPayload() {
+        return this.getAll().map((def) => ({
+            id: def.id,
+            displayName: def.displayName,
+            tier: def.tier,
+            available: true, // Only registered agents that passed detection are in the registry at runtime
+            capabilities: def.capabilities,
+        }));
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/core/agent-registry.js.map

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

package/dist/core/config-schema.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+export declare const ViewportConfigSchema: z.ZodObject<{
+    defaults: z.ZodOptional<z.ZodObject<{
+        agent: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        gitTracker: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            commitOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            autoSquashOnComplete: z.ZodOptional<z.ZodBoolean>;
+            branchPrefix: z.ZodOptional<z.ZodString>;
+            commitAuthor: z.ZodOptional<z.ZodString>;
+            maxCommitsPerSession: z.ZodOptional<z.ZodNumber>;
+            worktreeRoot: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        permissions: z.ZodOptional<z.ZodObject<{
+            autoApprove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireApproval: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        costCapUsd: z.ZodOptional<z.ZodNumber>;
+        trust: z.ZodOptional<z.ZodEnum<{
+            operator: "operator";
+            automated: "automated";
+            external: "external";
+        }>>;
+    }, z.core.$strict>>;
+    directories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        config: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            gitTracker: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                commitOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                autoSquashOnComplete: z.ZodOptional<z.ZodBoolean>;
+                branchPrefix: z.ZodOptional<z.ZodString>;
+                commitAuthor: z.ZodOptional<z.ZodString>;
+                maxCommitsPerSession: z.ZodOptional<z.ZodNumber>;
+                worktreeRoot: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            permissions: z.ZodOptional<z.ZodObject<{
+                autoApprove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                requireApproval: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            costCapUsd: z.ZodOptional<z.ZodNumber>;
+            trust: z.ZodOptional<z.ZodEnum<{
+                operator: "operator";
+                automated: "automated";
+                external: "external";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    relayUrl: z.ZodOptional<z.ZodString>;
+    relayToken: z.ZodOptional<z.ZodString>;
+    machineId: z.ZodOptional<z.ZodString>;
+    daemon: z.ZodOptional<z.ZodObject<{
+        listen: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodEnum<{
+            local: "local";
+            lan: "lan";
+            relay: "relay";
+        }>>;
+        allowedHosts: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<true>]>>;
+        allowedOrigins: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<true>]>>;
+        authEnabled: z.ZodOptional<z.ZodBoolean>;
+        logFile: z.ZodOptional<z.ZodString>;
+        relay: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            publicEndpoint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/core/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqCtB,CAAC"}

package/dist/core/config-schema.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+const PartialGitTrackerSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    commitOn: z.array(z.string()).optional(),
+    ignore: z.array(z.string()).optional(),
+    autoSquashOnComplete: z.boolean().optional(),
+    branchPrefix: z.string().optional(),
+    commitAuthor: z.string().optional(),
+    maxCommitsPerSession: z.number().int().positive().optional(),
+    worktreeRoot: z.string().optional(),
+})
+    .strict();
+const PartialPermissionsSchema = z
+    .object({
+    autoApprove: z.array(z.string()).optional(),
+    requireApproval: z.array(z.string()).optional(),
+    deny: z.array(z.string()).optional(),
+})
+    .strict();
+const PartialSessionConfigSchema = z
+    .object({
+    agent: z.string().min(1).max(128).optional(),
+    model: z.string().min(1).max(256).optional(),
+    gitTracker: PartialGitTrackerSchema.optional(),
+    permissions: PartialPermissionsSchema.optional(),
+    costCapUsd: z.number().nonnegative().optional(),
+    trust: z.enum(['operator', 'automated', 'external']).optional(),
+})
+    .strict();
+export const ViewportConfigSchema = z
+    .object({
+    defaults: PartialSessionConfigSchema.optional(),
+    directories: z
+        .record(z.string(), z
+        .object({
+        path: z.string().min(1),
+        config: PartialSessionConfigSchema.optional(),
+    })
+        .strict())
+        .optional(),
+    relayUrl: z.string().optional(),
+    relayToken: z.string().optional(),
+    machineId: z.string().optional(),
+    daemon: z
+        .object({
+        listen: z.string().optional(),
+        profile: z.enum(['local', 'lan', 'relay']).optional(),
+        allowedHosts: z.union([z.array(z.string()), z.literal(true)]).optional(),
+        allowedOrigins: z.union([z.array(z.string()), z.literal(true)]).optional(),
+        authEnabled: z.boolean().optional(),
+        logFile: z.string().optional(),
+        relay: z
+            .object({
+            enabled: z.boolean().optional(),
+            endpoint: z.string().optional(),
+            publicEndpoint: z.string().optional(),
+        })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+//# sourceMappingURL=config-schema.js.map

package/dist/core/config-schema.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Layered configuration system for the Viewport daemon.
+ *
+ * Resolution order (later wins):
+ *   built-in defaults → global config → directory overrides → session overrides
+ *
+ * Config file: ~/.viewport/config.json
+ */
+import type { SessionConfig } from './types.js';
+import type { AgentRegistry } from './agent-registry.js';
+export declare const BUILT_IN_DEFAULTS: SessionConfig;
+/**
+ * Deep merge objects. Arrays are replaced (not concatenated).
+ * `undefined` values in source are skipped (don't overwrite with undefined).
+ */
+export declare function deepMerge<T>(...sources: Array<Partial<T> | undefined>): T;
+export interface ViewportConfig {
+    /** Global defaults applied to all directories. */
+    defaults?: Partial<SessionConfig>;
+    /** Per-directory config overrides. Keyed by directory ID. */
+    directories?: Record<string, {
+        path: string;
+        config?: Partial<SessionConfig>;
+    }>;
+    /** Relay URL for remote access. */
+    relayUrl?: string;
+    /** Machine token for relay auth. */
+    relayToken?: string;
+    /** Machine ID. */
+    machineId?: string;
+    /** Daemon runtime defaults (listen/profile/security/lifecycle options). */
+    daemon?: {
+        listen?: string;
+        profile?: 'local' | 'lan' | 'relay';
+        allowedHosts?: string[] | true;
+        allowedOrigins?: string[] | true;
+        authEnabled?: boolean;
+        logFile?: string;
+        relay?: {
+            enabled?: boolean;
+            endpoint?: string;
+            publicEndpoint?: string;
+        };
+    };
+}
+export declare function resolveViewportHome(env?: NodeJS.ProcessEnv): string;
+/** Returns the path to the Viewport config directory. */
+export declare function configDir(): string;
+/** Returns the path to the Viewport config file. */
+export declare function configFilePath(): string;
+/** Load the config file, returning empty config if it doesn't exist. */
+export declare function loadConfig(): Promise<ViewportConfig>;
+/** Save the config file, creating the directory if needed. */
+export declare function saveConfig(config: ViewportConfig): Promise<void>;
+/**
+ * Resolve the full SessionConfig for a directory, with optional session overrides.
+ *
+ * Resolution: builtInDefaults ← agentDefaults ← globalDefaults ← directoryConfig ← sessionOverrides
+ *
+ * Agent defaults inject agent-specific tool names and permissions without
+ * polluting the framework-level built-in defaults.
+ */
+export declare function resolveConfig(agentDefaults?: Partial<SessionConfig>, globalDefaults?: Partial<SessionConfig>, directoryConfig?: Partial<SessionConfig>, sessionOverrides?: Partial<SessionConfig>): SessionConfig;
+export declare class ConfigManager {
+    private config;
+    private loaded;
+    private agentRegistry;
+    /** Load config from disk. Safe to call multiple times. */
+    load(): Promise<void>;
+    /** Set the agent registry for agent-aware config resolution. */
+    setAgentRegistry(registry: AgentRegistry): void;
+    /** Get the raw viewport config. */
+    getConfig(): ViewportConfig;
+    /** Resolve a full SessionConfig for a directory, with agent-specific defaults. */
+    resolveSessionConfig(directoryId?: string, sessionOverrides?: Partial<SessionConfig>): SessionConfig;
+    /** Build a partial SessionConfig from agent definition defaults. */
+    private buildAgentDefaults;
+    /** Get the relay URL (if configured). */
+    getRelayUrl(): string | undefined;
+    /** Get the machine ID. */
+    getMachineId(): string;
+    /** Get daemon runtime settings from config (if any). */
+    getDaemonConfig(): {
+        listen?: string;
+        profile?: 'local' | 'lan' | 'relay';
+        allowedHosts?: string[] | true;
+        allowedOrigins?: string[] | true;
+        authEnabled?: boolean;
+        logFile?: string;
+        relay?: {
+            enabled?: boolean;
+            endpoint?: string;
+            publicEndpoint?: string;
+        };
+    } | undefined;
+    /** Merge daemon runtime settings into config. */
+    setDaemonConfig(daemonConfig: NonNullable<ViewportConfig['daemon']>): Promise<void>;
+    /** Update global defaults. */
+    setDefaults(defaults: Partial<SessionConfig>): Promise<void>;
+    /** Register a directory with optional config. */
+    registerDirectory(directoryId: string, dirPath: string, config?: Partial<SessionConfig>): Promise<void>;
+    /** Unregister a directory. */
+    unregisterDirectory(directoryId: string): Promise<void>;
+    /** Get all registered directories. */
+    getDirectories(): Record<string, {
+        path: string;
+        config?: Partial<SessionConfig>;
+    }>;
+    private ensureLoaded;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

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