@agenshield/broker 0.1.0

package/types.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Broker types and interfaces
+ */
+import type { OperationType } from '@agenshield/ipc';
+/**
+ * Broker daemon configuration
+ */
+export interface BrokerConfig {
+    /** Unix socket path */
+    socketPath: string;
+    /** Whether HTTP fallback is enabled */
+    httpEnabled: boolean;
+    /** HTTP fallback port */
+    httpPort: number;
+    /** HTTP fallback host (should be localhost) */
+    httpHost: string;
+    /** Path to configuration file */
+    configPath: string;
+    /** Path to policies directory */
+    policiesPath: string;
+    /** Path to audit log */
+    auditLogPath: string;
+    /** Log level */
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    /** Whether to fail open if policy check fails */
+    failOpen: boolean;
+    /** Socket file permissions (octal) */
+    socketMode: number;
+    /** Socket owner user */
+    socketOwner?: string;
+    /** Socket owner group */
+    socketGroup?: string;
+}
+/**
+ * Context passed to operation handlers
+ */
+export interface HandlerContext {
+    /** Request ID for tracing */
+    requestId: string;
+    /** Channel the request came from */
+    channel: 'socket' | 'http';
+    /** Client user ID (from socket credentials) */
+    clientUid?: number;
+    /** Client group ID (from socket credentials) */
+    clientGid?: number;
+    /** Client process ID */
+    clientPid?: number;
+    /** Timestamp of request */
+    timestamp: Date;
+    /** Broker configuration */
+    config: BrokerConfig;
+}
+/**
+ * Result from an operation handler
+ */
+export interface HandlerResult<T = unknown> {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Result data (if successful) */
+    data?: T;
+    /** Error information (if failed) */
+    error?: {
+        code: number;
+        message: string;
+        details?: unknown;
+    };
+    /** Audit metadata */
+    audit?: {
+        duration: number;
+        policyMatched?: string;
+        bytesTransferred?: number;
+    };
+}
+/**
+ * Audit log entry
+ */
+export interface AuditEntry {
+    /** Unique entry ID */
+    id: string;
+    /** Timestamp */
+    timestamp: Date;
+    /** Operation type */
+    operation: OperationType;
+    /** Request channel */
+    channel: 'socket' | 'http';
+    /** Client user ID */
+    clientUid?: number;
+    /** Whether operation was allowed */
+    allowed: boolean;
+    /** Policy that matched (if any) */
+    policyId?: string;
+    /** Operation target (URL, path, command) */
+    target: string;
+    /** Operation result */
+    result: 'success' | 'denied' | 'error';
+    /** Error message if failed */
+    errorMessage?: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Secret vault entry
+ */
+export interface VaultEntry {
+    /** Secret name */
+    name: string;
+    /** Encrypted value */
+    encryptedValue: string;
+    /** Operations that can access this secret */
+    allowedOperations: OperationType[];
+    /** Created timestamp */
+    createdAt: Date;
+    /** Last accessed timestamp */
+    lastAccessedAt?: Date;
+    /** Access count */
+    accessCount: number;
+}
+/**
+ * JSON-RPC 2.0 request
+ */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: OperationType;
+    params: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response
+ */
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+/**
+ * JSON-RPC 2.0 error
+ */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Operation-specific parameter types
+ */
+export interface HttpRequestParams {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+    headers?: Record<string, string>;
+    body?: string | Buffer;
+    timeout?: number;
+    followRedirects?: boolean;
+}
+export interface HttpRequestResult {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface FileReadParams {
+    path: string;
+    encoding?: BufferEncoding;
+}
+export interface FileReadResult {
+    content: string;
+    size: number;
+    mtime: string;
+}
+export interface FileWriteParams {
+    path: string;
+    content: string;
+    encoding?: BufferEncoding;
+    mode?: number;
+}
+export interface FileWriteResult {
+    bytesWritten: number;
+    path: string;
+}
+export interface FileListParams {
+    path: string;
+    recursive?: boolean;
+    pattern?: string;
+}
+export interface FileListResult {
+    entries: Array<{
+        name: string;
+        path: string;
+        type: 'file' | 'directory' | 'symlink';
+        size: number;
+        mtime: string;
+    }>;
+}
+export interface ExecParams {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+    shell?: boolean;
+}
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    signal?: string;
+}
+export interface OpenUrlParams {
+    url: string;
+    browser?: string;
+}
+export interface OpenUrlResult {
+    opened: boolean;
+}
+export interface SecretInjectParams {
+    name: string;
+    targetEnv?: string;
+}
+export interface SecretInjectResult {
+    value: string;
+    injected: boolean;
+}
+export interface PingParams {
+    echo?: string;
+}
+export interface PingResult {
+    pong: true;
+    echo?: string;
+    timestamp: string;
+    version: string;
+}
+/**
+ * Skill installation file
+ */
+export interface SkillInstallFile {
+    /** Relative file name (e.g., "skill.md", "lib/utils.js") */
+    name: string;
+    /** File content (base64 encoded for binary, raw string for text) */
+    content: string;
+    /** Optional file mode (e.g., 0o755 for executable) */
+    mode?: number;
+    /** Whether content is base64 encoded */
+    base64?: boolean;
+}
+export interface SkillInstallParams {
+    /** Skill slug (used as directory name) */
+    slug: string;
+    /** Files to install */
+    files: SkillInstallFile[];
+    /** Whether to create a wrapper script in bin directory */
+    createWrapper?: boolean;
+    /** Agent home directory (defaults to env AGENSHIELD_AGENT_HOME) */
+    agentHome?: string;
+    /** Socket group name (defaults to env AGENSHIELD_SOCKET_GROUP) */
+    socketGroup?: string;
+}
+export interface SkillInstallResult {
+    /** Whether installation succeeded */
+    installed: boolean;
+    /** Path to installed skill directory */
+    skillDir: string;
+    /** Path to wrapper script (if created) */
+    wrapperPath?: string;
+    /** Number of files written */
+    filesWritten: number;
+}
+export interface SkillUninstallParams {
+    /** Skill slug to uninstall */
+    slug: string;
+    /** Agent home directory (defaults to env AGENSHIELD_AGENT_HOME) */
+    agentHome?: string;
+    /** Whether to remove wrapper script */
+    removeWrapper?: boolean;
+}
+export interface SkillUninstallResult {
+    /** Whether uninstallation succeeded */
+    uninstalled: boolean;
+    /** Path to removed skill directory */
+    skillDir: string;
+    /** Whether wrapper was removed */
+    wrapperRemoved: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAc,aAAa,EAAqC,MAAM,iBAAiB,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IAErB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IAEjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IAErB,gBAAgB;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE9C,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,SAAS,EAAE,IAAI,CAAC;IAEhB,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IAET,oCAAoC;IACpC,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF,qBAAqB;IACrB,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAC;IAEhB,qBAAqB;IACrB,SAAS,EAAE,aAAa,CAAC;IAEzB,sBAAsB;IACtB,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IAEjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEvC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,6CAA6C;IAC7C,iBAAiB,EAAE,aAAa,EAAE,CAAC;IAEnC,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,IAAI,CAAC;IAEtB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB"}