@viewportai/daemon 0.1.0

package/dist/hooks/types.js

@@ -0,0 +1,148 @@
+/**
+ * Hook system types — adapter-agnostic event definitions for agent lifecycle hooks.
+ *
+ * The hook system allows the daemon to receive events from any agent (Claude Code,
+ * Gemini, Cursor, etc.) via lightweight CLI commands that POST to the daemon.
+ * Each hook event has a typed input schema and metadata about how it should be handled.
+ *
+ * Design:
+ *   - HookEventKind: all supported event names (extensible enum-like union)
+ *   - HookInput<K>: typed input for each event kind
+ *   - HookEventDefinition: registry entry with schema, blocking flag, handler
+ *   - HookResponse: what the daemon returns to the hook command
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Hook event kinds — add new events here
+// ---------------------------------------------------------------------------
+export const HOOK_EVENT_KINDS = [
+    'SessionStart',
+    'SessionEnd',
+    'PermissionRequest',
+    'Notification',
+    'Stop',
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'SubagentStart',
+    'SubagentStop',
+    'UserPromptSubmit',
+    'TaskCompleted',
+];
+// ---------------------------------------------------------------------------
+// Base input — all hook events include these fields
+// ---------------------------------------------------------------------------
+export const HookBaseInputSchema = z.object({
+    hook_event_name: z.string(),
+    session_id: z.string(),
+    transcript_path: z.string().optional(),
+    cwd: z.string().optional(),
+    permission_mode: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Per-event input schemas
+// ---------------------------------------------------------------------------
+export const SessionStartInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('SessionStart'),
+    source: z.enum(['startup', 'resume', 'clear', 'compact']).optional(),
+    agent_type: z.string().optional(),
+    model: z.string().optional(),
+});
+export const SessionEndInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('SessionEnd'),
+    reason: z.string().optional(),
+});
+export const PermissionRequestInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('PermissionRequest'),
+    tool_name: z.string(),
+    tool_input: z.unknown().optional(),
+});
+export const NotificationInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('Notification'),
+    message: z.string(),
+    title: z.string().optional(),
+    notification_type: z.string().optional(),
+});
+export const StopInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('Stop'),
+    stop_hook_active: z.boolean().optional(),
+    last_assistant_message: z.string().optional(),
+});
+export const PreToolUseInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('PreToolUse'),
+    tool_name: z.string(),
+    tool_input: z.unknown().optional(),
+    tool_use_id: z.string().optional(),
+});
+export const PostToolUseInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('PostToolUse'),
+    tool_name: z.string(),
+    tool_input: z.unknown().optional(),
+    tool_response: z.unknown().optional(),
+    tool_use_id: z.string().optional(),
+});
+export const PostToolUseFailureInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('PostToolUseFailure'),
+    tool_name: z.string(),
+    tool_input: z.unknown().optional(),
+    tool_use_id: z.string().optional(),
+    error: z.string().optional(),
+    is_interrupt: z.boolean().optional(),
+});
+export const SubagentStartInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('SubagentStart'),
+    agent_id: z.string().optional(),
+    agent_type: z.string().optional(),
+});
+export const SubagentStopInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('SubagentStop'),
+    agent_id: z.string().optional(),
+    agent_type: z.string().optional(),
+    agent_transcript_path: z.string().optional(),
+    last_assistant_message: z.string().optional(),
+});
+export const UserPromptSubmitInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('UserPromptSubmit'),
+    prompt: z.string().optional(),
+});
+export const TaskCompletedInputSchema = HookBaseInputSchema.extend({
+    hook_event_name: z.literal('TaskCompleted'),
+    task_id: z.string().optional(),
+    task_subject: z.string().optional(),
+    task_description: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Schema registry — maps event kind to its Zod schema
+// ---------------------------------------------------------------------------
+export const HOOK_INPUT_SCHEMAS = {
+    SessionStart: SessionStartInputSchema,
+    SessionEnd: SessionEndInputSchema,
+    PermissionRequest: PermissionRequestInputSchema,
+    Notification: NotificationInputSchema,
+    Stop: StopInputSchema,
+    PreToolUse: PreToolUseInputSchema,
+    PostToolUse: PostToolUseInputSchema,
+    PostToolUseFailure: PostToolUseFailureInputSchema,
+    SubagentStart: SubagentStartInputSchema,
+    SubagentStop: SubagentStopInputSchema,
+    UserPromptSubmit: UserPromptSubmitInputSchema,
+    TaskCompleted: TaskCompletedInputSchema,
+};
+// ---------------------------------------------------------------------------
+// Default event definitions — blocking vs fire-and-forget
+// ---------------------------------------------------------------------------
+export const DEFAULT_EVENT_DEFINITIONS = [
+    { kind: 'SessionStart', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'SessionEnd', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'PermissionRequest', blocking: true, defaultTimeoutMs: 120_000 },
+    { kind: 'Notification', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'Stop', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'PreToolUse', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'PostToolUse', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'PostToolUseFailure', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'SubagentStart', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'SubagentStop', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'UserPromptSubmit', blocking: false, defaultTimeoutMs: 5_000 },
+    { kind: 'TaskCompleted', blocking: false, defaultTimeoutMs: 5_000 },
+];
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Viewport Daemon — CLI entry point.
+ *
+ * Commands:
+ *   vpd start [--port 7070]   Start the daemon
+ *   vpd install               Detect available agents
+ *   vpd add <path>            Register a directory
+ *   vpd remove <path>         Unregister a directory
+ *   vpd list                  List directories + active sessions
+ *   vpd status                Daemon health check
+ *   vpd stop                  Stop the daemon
+ *   vpd restart               Restart the daemon
+ *   vpd worktree ...          Worktree operator commands
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * Viewport Daemon — CLI entry point.
+ *
+ * Commands:
+ *   vpd start [--port 7070]   Start the daemon
+ *   vpd install               Detect available agents
+ *   vpd add <path>            Register a directory
+ *   vpd remove <path>         Unregister a directory
+ *   vpd list                  List directories + active sessions
+ *   vpd status                Daemon health check
+ *   vpd stop                  Stop the daemon
+ *   vpd restart               Restart the daemon
+ *   vpd worktree ...          Worktree operator commands
+ */
+import { getCommand, getArgs } from './cli/args.js';
+import { install, addDirectory, removeDirectory, list, status, stop, restart, run, send, logs, wait, attach, pair, update, showHelp, ls, stopSession, permit, agent, worktree, service, setup, } from './cli/commands.js';
+import { hookNotify } from './cli/hook-command.js';
+import { start, runSupervisorCommand, runWorkerCommand } from './startup.js';
+const commands = {
+    start,
+    install,
+    add: addDirectory,
+    remove: removeDirectory,
+    list,
+    status,
+    stop,
+    restart,
+    run,
+    send,
+    logs,
+    wait,
+    attach,
+    pair,
+    update,
+    ls,
+    permit,
+    agent,
+    worktree,
+    service,
+    setup,
+};
+const command = getCommand();
+// Sub-command: vpd hook notify --event <EventName>
+if (command === 'hook') {
+    const subcommand = getArgs()[1];
+    if (subcommand === 'notify') {
+        hookNotify().catch(() => process.exit(1));
+    }
+    else {
+        console.error(`Unknown hook subcommand: ${subcommand}`);
+        console.error('Usage: vpd hook notify --event <EventName>');
+        process.exit(1);
+    }
+}
+else {
+    if (command === '__supervisor') {
+        runSupervisorCommand().catch((err) => {
+            console.error(`Supervisor error: ${err.message}`);
+            process.exit(1);
+        });
+    }
+    else if (command === '__worker') {
+        runWorkerCommand().catch((err) => {
+            console.error(`Worker error: ${err.message}`);
+            process.exit(1);
+        });
+    }
+    else {
+        let handler = commands[command];
+        if (command === 'daemon') {
+            const subcommand = getArgs()[1] ?? 'status';
+            if (subcommand === 'start')
+                handler = start;
+            if (subcommand === 'status')
+                handler = status;
+            if (subcommand === 'stop')
+                handler = stop;
+            if (subcommand === 'restart')
+                handler = restart;
+            if (subcommand === 'pair')
+                handler = pair;
+            if (subcommand === 'update')
+                handler = update;
+            if (subcommand === 'service')
+                handler = service;
+            if (subcommand === 'setup')
+                handler = setup;
+        }
+        else if (command === 'session') {
+            const subcommand = getArgs()[1];
+            if (subcommand === 'stop')
+                handler = stopSession;
+        }
+        else if (command === 'permit') {
+            handler = permit;
+        }
+        else if (command === 'agent') {
+            handler = agent;
+        }
+        else if (command === 'worktree') {
+            handler = worktree;
+        }
+        if (!handler) {
+            if (command !== 'help') {
+                console.error(`Unknown command: ${command}\n`);
+            }
+            showHelp();
+            process.exit(command === 'help' ? 0 : 1);
+        }
+        handler().catch((err) => {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,OAAO,EACP,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,EAAE,EACF,WAAW,EACX,MAAM,EACN,KAAK,EACL,QAAQ,EACR,OAAO,EACP,KAAK,GACN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7E,MAAM,QAAQ,GAAwC;IACpD,KAAK;IACL,OAAO;IACP,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,eAAe;IACvB,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,OAAO;IACP,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,EAAE;IACF,MAAM;IACN,KAAK;IACL,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC;AAEF,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAE7B,mDAAmD;AACnD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;KAAM,CAAC;IACN,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;QAC/B,oBAAoB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YAC1C,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YACtC,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;YAC5C,IAAI,UAAU,KAAK,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAC;YAC5C,IAAI,UAAU,KAAK,QAAQ;gBAAE,OAAO,GAAG,MAAM,CAAC;YAC9C,IAAI,UAAU,KAAK,MAAM;gBAAE,OAAO,GAAG,IAAI,CAAC;YAC1C,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,GAAG,OAAO,CAAC;YAChD,IAAI,UAAU,KAAK,MAAM;gBAAE,OAAO,GAAG,IAAI,CAAC;YAC1C,IAAI,UAAU,KAAK,QAAQ;gBAAE,OAAO,GAAG,MAAM,CAAC;YAC9C,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,GAAG,OAAO,CAAC;YAChD,IAAI,UAAU,KAAK,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAC;QAC9C,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,UAAU,KAAK,MAAM;gBAAE,OAAO,GAAG,WAAW,CAAC;QACnD,CAAC;aAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;aAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,GAAG,QAAQ,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvB,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YAC7B,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/permissions/engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Permission resolution engine.
+ *
+ * Resolves whether a tool call should be auto-approved, require user approval,
+ * or be denied — based on the layered PermissionsConfig.
+ *
+ * For v0.1: tool name matching only. Future: semantic Bash command matching,
+ * path-based rules, etc.
+ */
+import type { PermissionsConfig } from '../core/types.js';
+export type PermissionResolution = 'auto-approve' | 'require-approval' | 'deny';
+/**
+ * Resolve the permission for a tool call.
+ *
+ * Priority: deny > autoApprove > requireApproval > default (require-approval)
+ */
+export declare function resolvePermission(toolName: string, _toolInput: Record<string, unknown> | undefined, config: PermissionsConfig): PermissionResolution;
+/**
+ * Check if a tool name matches any pattern in a list.
+ * For v0.1: exact match only. Future: glob/regex patterns.
+ */
+export declare function matchesTool(toolName: string, patterns: string[]): boolean;
+//# sourceMappingURL=engine.d.ts.map

package/dist/permissions/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/permissions/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CAsBtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAEzE"}

package/dist/permissions/engine.js

@@ -0,0 +1,43 @@
+/**
+ * Permission resolution engine.
+ *
+ * Resolves whether a tool call should be auto-approved, require user approval,
+ * or be denied — based on the layered PermissionsConfig.
+ *
+ * For v0.1: tool name matching only. Future: semantic Bash command matching,
+ * path-based rules, etc.
+ */
+import { metrics } from '../core/metrics.js';
+/**
+ * Resolve the permission for a tool call.
+ *
+ * Priority: deny > autoApprove > requireApproval > default (require-approval)
+ */
+export function resolvePermission(toolName, _toolInput, config) {
+    // Deny takes highest priority
+    if (config.deny.includes(toolName)) {
+        metrics.increment('permissions.denied');
+        return 'deny';
+    }
+    // Auto-approve if listed
+    if (config.autoApprove.includes(toolName)) {
+        metrics.increment('permissions.auto_approved');
+        return 'auto-approve';
+    }
+    // Explicitly require approval if listed
+    if (config.requireApproval.includes(toolName)) {
+        metrics.increment('permissions.require_approval');
+        return 'require-approval';
+    }
+    // Default: require approval for unknown tools
+    metrics.increment('permissions.require_approval');
+    return 'require-approval';
+}
+/**
+ * Check if a tool name matches any pattern in a list.
+ * For v0.1: exact match only. Future: glob/regex patterns.
+ */
+export function matchesTool(toolName, patterns) {
+    return patterns.includes(toolName);
+}
+//# sourceMappingURL=engine.js.map

package/dist/permissions/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/permissions/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,UAA+C,EAC/C,MAAyB;IAEzB,8BAA8B;IAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,yBAAyB;IACzB,IAAI,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QAC/C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QAClD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,8CAA8C;IAC9C,OAAO,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAClD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAkB;IAC9D,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Plugin loader — discovers and loads agent plugins from:
+ *   1. ~/.viewport/plugins/  (user-installed plugins)
+ *   2. node_modules/ (project-local plugins)
+ *
+ * Plugins are npm packages that export an AgentDefinition.
+ * Convention: @viewport/agent-* or viewport-agent-*
+ *
+ * Each plugin's package.json must have a "viewport" field:
+ *   { "viewport": { "type": "agent", "agentId": "my-agent" } }
+ */
+import type { AgentDefinition } from '../core/agent-registry.js';
+export interface PluginManifest {
+    /** Package name. */
+    name: string;
+    /** Package version. */
+    version: string;
+    /** Viewport plugin metadata. */
+    viewport: {
+        type: 'agent';
+        agentId: string;
+    };
+}
+export interface LoadedPlugin {
+    manifest: PluginManifest;
+    definition: AgentDefinition;
+    path: string;
+}
+/** Get the global plugins directory. */
+export declare function pluginsDir(): string;
+/**
+ * Discover and load all agent plugins.
+ * Scans:
+ *   1. ~/.viewport/plugins/
+ *   2. Current project's node_modules/ (optional)
+ */
+export declare function loadPluginAgents(options?: {
+    projectDir?: string;
+}): Promise<LoadedPlugin[]>;
+/**
+ * List installed plugins (without loading them).
+ */
+export declare function listPlugins(): Promise<PluginManifest[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMjE,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,eAAe,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,wCAAwC;AACxC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA6HD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiCjG;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAU7D"}

package/dist/plugins/loader.js

@@ -0,0 +1,177 @@
+/**
+ * Plugin loader — discovers and loads agent plugins from:
+ *   1. ~/.viewport/plugins/  (user-installed plugins)
+ *   2. node_modules/ (project-local plugins)
+ *
+ * Plugins are npm packages that export an AgentDefinition.
+ * Convention: @viewport/agent-* or viewport-agent-*
+ *
+ * Each plugin's package.json must have a "viewport" field:
+ *   { "viewport": { "type": "agent", "agentId": "my-agent" } }
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { configDir } from '../core/config.js';
+import { logger } from '../core/output.js';
+// ---------------------------------------------------------------------------
+// Plugin directories
+// ---------------------------------------------------------------------------
+/** Get the global plugins directory. */
+export function pluginsDir() {
+    return path.join(configDir(), 'plugins');
+}
+// ---------------------------------------------------------------------------
+// Plugin discovery
+// ---------------------------------------------------------------------------
+/**
+ * Scan a directory for Viewport plugin packages.
+ * Returns plugin manifests found in package.json files.
+ */
+async function scanForPlugins(dir) {
+    const found = [];
+    try {
+        const entries = await fs.readdir(dir);
+        for (const entry of entries) {
+            const entryPath = path.join(dir, entry);
+            // Handle scoped packages (@viewport/agent-*)
+            if (entry.startsWith('@')) {
+                try {
+                    const scopedEntries = await fs.readdir(entryPath);
+                    for (const scopedEntry of scopedEntries) {
+                        const scopedPath = path.join(entryPath, scopedEntry);
+                        const manifest = await readPluginManifest(scopedPath);
+                        if (manifest) {
+                            found.push({ manifest, dir: scopedPath });
+                        }
+                    }
+                }
+                catch {
+                    // Not a directory or unreadable
+                }
+                continue;
+            }
+            // Handle unscoped packages (viewport-agent-*)
+            if (entry.startsWith('viewport-agent-') || entry.startsWith('@viewport')) {
+                const manifest = await readPluginManifest(entryPath);
+                if (manifest) {
+                    found.push({ manifest, dir: entryPath });
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist — not an error
+    }
+    return found;
+}
+/**
+ * Read and validate a plugin's package.json.
+ */
+async function readPluginManifest(pkgDir) {
+    try {
+        const pkgPath = path.join(pkgDir, 'package.json');
+        const raw = await fs.readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        // Must have viewport metadata
+        const viewport = pkg['viewport'];
+        if (!viewport || viewport['type'] !== 'agent' || typeof viewport['agentId'] !== 'string') {
+            return null;
+        }
+        return {
+            name: typeof pkg['name'] === 'string' ? pkg['name'] : 'unknown',
+            version: typeof pkg['version'] === 'string' ? pkg['version'] : '0.0.0',
+            viewport: {
+                type: 'agent',
+                agentId: viewport['agentId'],
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin loading
+// ---------------------------------------------------------------------------
+/**
+ * Load a single plugin from its directory.
+ * The plugin must export an AgentDefinition as default or named 'definition'.
+ */
+async function loadPlugin(manifest, pkgDir) {
+    try {
+        // Resolve the main entry point
+        const pkgPath = path.join(pkgDir, 'package.json');
+        const raw = await fs.readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        const main = pkg['main'] ?? 'index.js';
+        const entryPath = path.resolve(pkgDir, main);
+        // Dynamic import
+        const mod = await import(entryPath);
+        const definition = mod.definition ?? mod.default?.definition ?? mod.default;
+        if (!definition || typeof definition.id !== 'string') {
+            logger.warn(`Plugin ${manifest.name}: no valid AgentDefinition exported`);
+            return null;
+        }
+        // Validate the definition has required fields
+        if (!definition.displayName || !definition.tier || !definition.createAdapter) {
+            logger.warn(`Plugin ${manifest.name}: incomplete AgentDefinition`);
+            return null;
+        }
+        return { manifest, definition, path: pkgDir };
+    }
+    catch (err) {
+        logger.warn(`Plugin ${manifest.name}: failed to load — ${err}`);
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Discover and load all agent plugins.
+ * Scans:
+ *   1. ~/.viewport/plugins/
+ *   2. Current project's node_modules/ (optional)
+ */
+export async function loadPluginAgents(options) {
+    const scanDirs = [pluginsDir(), path.join(pluginsDir(), 'node_modules')];
+    // Optionally scan project-local node_modules
+    if (options?.projectDir) {
+        scanDirs.push(path.join(options.projectDir, 'node_modules'));
+    }
+    const allFound = [];
+    for (const dir of scanDirs) {
+        const found = await scanForPlugins(dir);
+        allFound.push(...found);
+    }
+    // Deduplicate by agentId (first one wins)
+    const seen = new Set();
+    const unique = allFound.filter((f) => {
+        if (seen.has(f.manifest.viewport.agentId))
+            return false;
+        seen.add(f.manifest.viewport.agentId);
+        return true;
+    });
+    // Load each plugin
+    const loaded = [];
+    for (const { manifest, dir } of unique) {
+        const plugin = await loadPlugin(manifest, dir);
+        if (plugin) {
+            loaded.push(plugin);
+        }
+    }
+    return loaded;
+}
+/**
+ * List installed plugins (without loading them).
+ */
+export async function listPlugins() {
+    const scanDirs = [pluginsDir(), path.join(pluginsDir(), 'node_modules')];
+    const manifests = [];
+    for (const dir of scanDirs) {
+        const found = await scanForPlugins(dir);
+        manifests.push(...found.map((f) => f.manifest));
+    }
+    return manifests;
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/server/auth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Authentication module for the Viewport daemon.
+ *
+ * Local mode: random token saved to ~/.viewport/auth-token
+ * Relay mode (future): API key validated against relay server
+ */
+export interface AuthProvider {
+    /** Validate a token/key. Returns true if valid. */
+    validate(token: string): Promise<boolean>;
+    /** Get the current token (for display in terminal). Null if N/A. */
+    getDisplayToken(): string | null;
+}
+/** Local file-based auth. Token saved to ~/.viewport/auth-token */
+export declare class LocalAuthProvider implements AuthProvider {
+    private token;
+    initialize(): Promise<void>;
+    validate(token: string): Promise<boolean>;
+    getDisplayToken(): string | null;
+}
+/** No-op auth that allows everything. Used with --no-auth flag. */
+export declare class NoopAuthProvider implements AuthProvider {
+    validate(): Promise<boolean>;
+    getDisplayToken(): string | null;
+}
+/** Extract Bearer token from Authorization header. */
+export declare function extractBearerToken(authHeader: string | undefined): string | null;
+export declare function extractTokenFromRequest(input: {
+    authorization?: string;
+    url?: string;
+    allowQueryToken?: boolean;
+}): string | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,oEAAoE;IACpE,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,mEAAmE;AACnE,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,KAAK,CAAuB;IAE9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/C,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC;AAED,mEAAmE;AACnE,qBAAa,gBAAiB,YAAW,YAAY;IAC7C,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAGlC,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,MAAM,GAAG,IAAI,CAgBhB"}