@bradygaster/squad-sdk 0.7.0 → 0.8.0

package/dist/runtime/streaming.js

@@ -0,0 +1,156 @@
+/**
+ * Streaming Event Pipeline
+ *
+ * Processes streaming events from Copilot SDK sessions including message deltas,
+ * reasoning deltas, and usage/cost tracking.
+ *
+ * @module runtime/streaming
+ */
+// ============================================================================
+// StreamingPipeline
+// ============================================================================
+/**
+ * Processes streaming events from SDK sessions.
+ *
+ * Allows registration of handlers for message deltas, reasoning deltas,
+ * and usage events. Aggregates token counts across all active sessions.
+ */
+export class StreamingPipeline {
+    deltaHandlers = new Set();
+    usageHandlers = new Set();
+    reasoningHandlers = new Set();
+    attachedSessions = new Set();
+    usageData = [];
+    /** Register a handler for message deltas. */
+    onDelta(handler) {
+        this.deltaHandlers.add(handler);
+        return () => this.deltaHandlers.delete(handler);
+    }
+    /** Register a handler for token usage/cost data. */
+    onUsage(handler) {
+        this.usageHandlers.add(handler);
+        return () => this.usageHandlers.delete(handler);
+    }
+    /** Register a handler for reasoning deltas. */
+    onReasoning(handler) {
+        this.reasoningHandlers.add(handler);
+        return () => this.reasoningHandlers.delete(handler);
+    }
+    /** Wire up handlers to a session's event stream. */
+    attachToSession(sessionId) {
+        if (this.attachedSessions.has(sessionId)) {
+            throw new Error(`Session ${sessionId} is already attached`);
+        }
+        this.attachedSessions.add(sessionId);
+    }
+    /** Clean up handlers for a session. */
+    detachFromSession(sessionId) {
+        this.attachedSessions.delete(sessionId);
+    }
+    /** Check whether a session is currently attached. */
+    isAttached(sessionId) {
+        return this.attachedSessions.has(sessionId);
+    }
+    /** Returns all currently attached session IDs. */
+    getAttachedSessions() {
+        return this.attachedSessions;
+    }
+    /**
+     * Process an incoming streaming event.
+     * Dispatches to the correct set of handlers based on event type.
+     */
+    async processEvent(event) {
+        if (!this.attachedSessions.has(event.sessionId)) {
+            return; // Ignore events from unattached sessions
+        }
+        switch (event.type) {
+            case 'message_delta':
+                await this.dispatchDelta(event);
+                break;
+            case 'usage':
+                this.usageData.push(event);
+                await this.dispatchUsage(event);
+                break;
+            case 'reasoning_delta':
+                await this.dispatchReasoning(event);
+                break;
+        }
+    }
+    /** Aggregate token counts and cost across all sessions. */
+    getUsageSummary() {
+        const byAgent = new Map();
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let estimatedCost = 0;
+        for (const event of this.usageData) {
+            totalInputTokens += event.inputTokens;
+            totalOutputTokens += event.outputTokens;
+            estimatedCost += event.estimatedCost;
+            const agentKey = event.agentName ?? 'unknown';
+            const existing = byAgent.get(agentKey);
+            if (existing) {
+                existing.inputTokens += event.inputTokens;
+                existing.outputTokens += event.outputTokens;
+                existing.estimatedCost += event.estimatedCost;
+                existing.turnCount += 1;
+                existing.model = event.model; // keep latest model
+            }
+            else {
+                byAgent.set(agentKey, {
+                    inputTokens: event.inputTokens,
+                    outputTokens: event.outputTokens,
+                    estimatedCost: event.estimatedCost,
+                    model: event.model,
+                    turnCount: 1,
+                });
+            }
+        }
+        return { totalInputTokens, totalOutputTokens, estimatedCost, byAgent };
+    }
+    /** Remove all handlers and detach all sessions. */
+    clear() {
+        this.deltaHandlers.clear();
+        this.usageHandlers.clear();
+        this.reasoningHandlers.clear();
+        this.attachedSessions.clear();
+        this.usageData = [];
+    }
+    // ---------- Private ----------
+    async dispatchDelta(event) {
+        for (const handler of this.deltaHandlers) {
+            try {
+                const result = handler(event);
+                if (result instanceof Promise)
+                    await result;
+            }
+            catch {
+                // Isolate handler errors
+            }
+        }
+    }
+    async dispatchUsage(event) {
+        for (const handler of this.usageHandlers) {
+            try {
+                const result = handler(event);
+                if (result instanceof Promise)
+                    await result;
+            }
+            catch {
+                // Isolate handler errors
+            }
+        }
+    }
+    async dispatchReasoning(event) {
+        for (const handler of this.reasoningHandlers) {
+            try {
+                const result = handler(event);
+                if (result instanceof Promise)
+                    await result;
+            }
+            catch {
+                // Isolate handler errors
+            }
+        }
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/runtime/streaming.js.map

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

package/dist/runtime/telemetry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Telemetry & Update Notifications (M4-7, Issue #108)
+ *
+ * Privacy-first, opt-in telemetry collection for Squad.
+ * No PII, no code content — only aggregate usage metrics.
+ *
+ * @module runtime/telemetry
+ */
+/** Recognised telemetry event names. */
+export type TelemetryEventName = 'squad.init' | 'squad.run' | 'squad.agent.spawn' | 'squad.error' | 'squad.upgrade';
+/** A single telemetry event. */
+export interface TelemetryEvent {
+    /** Event name */
+    name: TelemetryEventName;
+    /** Arbitrary metadata (must not contain PII or code) */
+    properties?: Record<string, string | number | boolean>;
+    /** Timestamp (defaults to Date.now()) */
+    timestamp?: number;
+}
+/** Configuration for telemetry. */
+export interface TelemetryConfig {
+    /** Master switch — disabled by default */
+    enabled: boolean;
+    /** HTTP endpoint for flushing events */
+    endpoint?: string;
+    /** Whether to strip identifying data even from properties */
+    anonymize?: boolean;
+    /** Event names to exclude from collection */
+    excludeEvents?: TelemetryEventName[];
+}
+/** Pluggable transport — how events are actually sent. */
+export type TelemetryTransport = (events: TelemetryEvent[], endpoint: string) => Promise<void>;
+/** Register a custom transport for flushing events. */
+export declare function setTelemetryTransport(fn: TelemetryTransport): void;
+/**
+ * Opt-in, privacy-respecting telemetry collector.
+ *
+ * Events are queued in memory and only sent when `flush()` is called.
+ * The collector respects the consent flag and never transmits when disabled.
+ *
+ * ```ts
+ * const telemetry = new TelemetryCollector({ enabled: false });
+ * telemetry.setConsent(true);
+ * telemetry.collectEvent({ name: 'squad.init' });
+ * await telemetry.flush();
+ * ```
+ */
+export declare class TelemetryCollector {
+    private queue;
+    private config;
+    constructor(config?: Partial<TelemetryConfig>);
+    /** Returns the current consent (enabled) status. */
+    getConsentStatus(): boolean;
+    /** Set consent status. When false, collectEvent becomes a no-op. */
+    setConsent(enabled: boolean): void;
+    /**
+     * Queue a telemetry event.
+     *
+     * Does nothing when consent is not given or the event name is excluded.
+     */
+    collectEvent(event: TelemetryEvent): void;
+    /**
+     * Send all queued events via the configured transport, then clear the queue.
+     * Returns the number of events flushed.
+     */
+    flush(): Promise<number>;
+    /** Return the number of queued (unflushed) events. */
+    get pendingCount(): number;
+    /** Discard all queued events without sending. */
+    drain(): void;
+    /** Return a copy of the current config. */
+    getConfig(): Readonly<TelemetryConfig>;
+}
+/**
+ * Decide whether the user should be notified about available updates.
+ *
+ * @param lastCheck - Timestamp of the last update check
+ * @param intervalMs - Minimum milliseconds between notifications
+ * @returns true if enough time has elapsed since the last check
+ */
+export declare function shouldNotifyUpdate(lastCheck: Date, intervalMs: number): boolean;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/runtime/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/runtime/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,aAAa,GACb,eAAe,CAAC;AAEpB,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAED,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAU/F,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAElE;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAc7C,oDAAoD;IACpD,gBAAgB,IAAI,OAAO;IAI3B,oEAAoE;IACpE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQlC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAgBzC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAW9B,sDAAsD;IACtD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAIb,2CAA2C;IAC3C,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;CAGvC;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG/E"}

package/dist/runtime/telemetry.js

@@ -0,0 +1,120 @@
+/**
+ * Telemetry & Update Notifications (M4-7, Issue #108)
+ *
+ * Privacy-first, opt-in telemetry collection for Squad.
+ * No PII, no code content — only aggregate usage metrics.
+ *
+ * @module runtime/telemetry
+ */
+// ============================================================================
+// Default (no-op) transport
+// ============================================================================
+let _transport = async () => {
+    // no-op until consumer provides a real transport
+};
+/** Register a custom transport for flushing events. */
+export function setTelemetryTransport(fn) {
+    _transport = fn;
+}
+// ============================================================================
+// TelemetryCollector
+// ============================================================================
+/**
+ * Opt-in, privacy-respecting telemetry collector.
+ *
+ * Events are queued in memory and only sent when `flush()` is called.
+ * The collector respects the consent flag and never transmits when disabled.
+ *
+ * ```ts
+ * const telemetry = new TelemetryCollector({ enabled: false });
+ * telemetry.setConsent(true);
+ * telemetry.collectEvent({ name: 'squad.init' });
+ * await telemetry.flush();
+ * ```
+ */
+export class TelemetryCollector {
+    queue = [];
+    config;
+    constructor(config) {
+        this.config = {
+            enabled: false,
+            endpoint: '',
+            anonymize: false,
+            excludeEvents: [],
+            ...config,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Consent management
+    // --------------------------------------------------------------------------
+    /** Returns the current consent (enabled) status. */
+    getConsentStatus() {
+        return this.config.enabled;
+    }
+    /** Set consent status. When false, collectEvent becomes a no-op. */
+    setConsent(enabled) {
+        this.config.enabled = enabled;
+    }
+    // --------------------------------------------------------------------------
+    // Event collection
+    // --------------------------------------------------------------------------
+    /**
+     * Queue a telemetry event.
+     *
+     * Does nothing when consent is not given or the event name is excluded.
+     */
+    collectEvent(event) {
+        if (!this.config.enabled)
+            return;
+        if (this.config.excludeEvents?.includes(event.name))
+            return;
+        const stored = {
+            name: event.name,
+            properties: this.config.anonymize
+                ? undefined
+                : event.properties ? { ...event.properties } : undefined,
+            timestamp: event.timestamp ?? Date.now(),
+        };
+        this.queue.push(stored);
+    }
+    /**
+     * Send all queued events via the configured transport, then clear the queue.
+     * Returns the number of events flushed.
+     */
+    async flush() {
+        if (!this.config.enabled || this.queue.length === 0)
+            return 0;
+        const endpoint = this.config.endpoint ?? '';
+        const batch = [...this.queue];
+        this.queue = [];
+        await _transport(batch, endpoint);
+        return batch.length;
+    }
+    /** Return the number of queued (unflushed) events. */
+    get pendingCount() {
+        return this.queue.length;
+    }
+    /** Discard all queued events without sending. */
+    drain() {
+        this.queue = [];
+    }
+    /** Return a copy of the current config. */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+// ============================================================================
+// Update notification helpers
+// ============================================================================
+/**
+ * Decide whether the user should be notified about available updates.
+ *
+ * @param lastCheck - Timestamp of the last update check
+ * @param intervalMs - Minimum milliseconds between notifications
+ * @returns true if enough time has elapsed since the last check
+ */
+export function shouldNotifyUpdate(lastCheck, intervalMs) {
+    const elapsed = Date.now() - lastCheck.getTime();
+    return elapsed >= intervalMs;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/runtime/telemetry.js.map

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

package/dist/sharing/agent-repo.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Agent Repository Configuration (M5-7, Issue #131)
+ */
+import type { AgentDefinition, AgentManifest, GitHubFetcher } from '../config/agent-source.js';
+export interface AgentRepoConfig {
+    owner: string;
+    repo: string;
+    branch?: string;
+    path?: string;
+    authentication?: {
+        type: 'token' | 'app';
+        token?: string;
+    };
+}
+export interface PushResult {
+    success: boolean;
+    sha?: string;
+    errors: string[];
+}
+/**
+ * Abstracted GitHub operations for agent repo management.
+ */
+export interface AgentRepoOperations extends GitHubFetcher {
+    /** Push a file to a repo (create or update). */
+    pushFile(owner: string, repo: string, path: string, content: string, message: string, branch?: string): Promise<{
+        sha: string;
+    }>;
+}
+export declare function configureAgentRepo(config: AgentRepoConfig): AgentRepoConfig;
+export declare function listRepoAgents(config: AgentRepoConfig, ops: AgentRepoOperations): Promise<AgentManifest[]>;
+export declare function pullAgent(config: AgentRepoConfig, agentId: string, ops: AgentRepoOperations): Promise<AgentDefinition | null>;
+export declare function pushAgent(config: AgentRepoConfig, agent: AgentDefinition, ops: AgentRepoOperations): Promise<PushResult>;
+//# sourceMappingURL=agent-repo.d.ts.map

package/dist/sharing/agent-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-repo.d.ts","sourceRoot":"","sources":["../../src/sharing/agent-repo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK/F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,gDAAgD;IAChD,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7B;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAc3E;AAID,wBAAsB,cAAc,CAClC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,aAAa,EAAE,CAAC,CAmB1B;AAID,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAuBjC;AAID,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,UAAU,CAAC,CAmBrB"}

package/dist/sharing/agent-repo.js

@@ -0,0 +1,79 @@
+/**
+ * Agent Repository Configuration (M5-7, Issue #131)
+ */
+import { parseCharterMetadata } from '../config/agent-source.js';
+// --- Validation ---
+export function configureAgentRepo(config) {
+    if (!config.owner || typeof config.owner !== 'string') {
+        throw new Error('owner is required');
+    }
+    if (!config.repo || typeof config.repo !== 'string') {
+        throw new Error('repo is required');
+    }
+    return {
+        owner: config.owner,
+        repo: config.repo,
+        branch: config.branch ?? 'main',
+        path: config.path ?? '.squad/agents',
+        authentication: config.authentication,
+    };
+}
+// --- List agents ---
+export async function listRepoAgents(config, ops) {
+    const agentPath = config.path ?? '.squad/agents';
+    const entries = await ops.listDirectory(config.owner, config.repo, agentPath, config.branch);
+    const dirs = entries.filter(e => e.type === 'dir');
+    const manifests = [];
+    for (const dir of dirs) {
+        const charterPath = `${agentPath}/${dir.name}/charter.md`;
+        const content = await ops.getFileContent(config.owner, config.repo, charterPath, config.branch);
+        if (!content)
+            continue;
+        const meta = parseCharterMetadata(content);
+        manifests.push({
+            name: meta.name || dir.name,
+            role: meta.role || 'agent',
+            source: `github:${config.owner}/${config.repo}`,
+        });
+    }
+    return manifests;
+}
+// --- Pull agent ---
+export async function pullAgent(config, agentId, ops) {
+    const agentPath = config.path ?? '.squad/agents';
+    const charterPath = `${agentPath}/${agentId}/charter.md`;
+    const charter = await ops.getFileContent(config.owner, config.repo, charterPath, config.branch);
+    if (!charter)
+        return null;
+    const meta = parseCharterMetadata(charter);
+    let history;
+    const historyPath = `${agentPath}/${agentId}/history.md`;
+    const historyContent = await ops.getFileContent(config.owner, config.repo, historyPath, config.branch);
+    if (historyContent)
+        history = historyContent;
+    return {
+        name: meta.name || agentId,
+        role: meta.role || 'agent',
+        source: `github:${config.owner}/${config.repo}`,
+        charter,
+        model: meta.model,
+        tools: meta.tools,
+        skills: meta.skills,
+        history,
+    };
+}
+// --- Push agent ---
+export async function pushAgent(config, agent, ops) {
+    const agentPath = config.path ?? '.squad/agents';
+    const charterPath = `${agentPath}/${agent.name}/charter.md`;
+    const errors = [];
+    try {
+        const result = await ops.pushFile(config.owner, config.repo, charterPath, agent.charter, `Update agent ${agent.name}`, config.branch);
+        return { success: true, sha: result.sha, errors };
+    }
+    catch (err) {
+        errors.push(err instanceof Error ? err.message : String(err));
+        return { success: false, errors };
+    }
+}
+//# sourceMappingURL=agent-repo.js.map

package/dist/sharing/agent-repo.js.map

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

package/dist/sharing/cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Caching Strategy for Remote Agents (M5-8, Issue #132)
+ */
+import type { AgentDefinition } from '../config/agent-source.js';
+export interface CacheEntry<T = AgentDefinition> {
+    value: T;
+    timestamp: number;
+    ttl: number;
+    source: string;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+}
+/** Default TTL: 1 hour for agent definitions. */
+export declare const DEFAULT_AGENT_TTL: number;
+/** Default TTL: 5 minutes for skill content. */
+export declare const DEFAULT_SKILL_TTL: number;
+export declare class AgentCache<T = AgentDefinition> {
+    private cache;
+    private stats;
+    private defaultTtl;
+    constructor(defaultTtl?: number);
+    get(key: string): T | null;
+    set(key: string, value: T, ttl?: number, source?: string): void;
+    invalidate(key: string): boolean;
+    clear(): void;
+    has(key: string): boolean;
+    getStats(): CacheStats;
+    /** Return all non-expired entries. */
+    entries(): Array<[string, CacheEntry<T>]>;
+    private isExpired;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/sharing/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/sharing/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIjE,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,eAAe;IAC7C,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAI/C,qBAAa,UAAU,CAAC,CAAC,GAAG,eAAe;IACzC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,KAAK,CAA6D;IAC1E,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAA0B;IAIlD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAiB1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,IAAI;IAUlE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAShC,KAAK,IAAI,IAAI;IAOb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYzB,QAAQ,IAAI,UAAU;IAItB,sCAAsC;IACtC,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAUzC,OAAO,CAAC,SAAS;CAGlB"}

package/dist/sharing/cache.js

@@ -0,0 +1,85 @@
+/**
+ * Caching Strategy for Remote Agents (M5-8, Issue #132)
+ */
+// --- Constants ---
+/** Default TTL: 1 hour for agent definitions. */
+export const DEFAULT_AGENT_TTL = 60 * 60 * 1000;
+/** Default TTL: 5 minutes for skill content. */
+export const DEFAULT_SKILL_TTL = 5 * 60 * 1000;
+// --- AgentCache class ---
+export class AgentCache {
+    cache = new Map();
+    stats = { hits: 0, misses: 0, evictions: 0, size: 0 };
+    defaultTtl;
+    constructor(defaultTtl = DEFAULT_AGENT_TTL) {
+        this.defaultTtl = defaultTtl;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.stats.evictions++;
+            this.stats.size = this.cache.size;
+            this.stats.misses++;
+            return null;
+        }
+        this.stats.hits++;
+        return entry.value;
+    }
+    set(key, value, ttl, source = 'unknown') {
+        this.cache.set(key, {
+            value,
+            timestamp: Date.now(),
+            ttl: ttl ?? this.defaultTtl,
+            source,
+        });
+        this.stats.size = this.cache.size;
+    }
+    invalidate(key) {
+        const deleted = this.cache.delete(key);
+        if (deleted) {
+            this.stats.evictions++;
+            this.stats.size = this.cache.size;
+        }
+        return deleted;
+    }
+    clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        this.stats.evictions += size;
+        this.stats.size = 0;
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.stats.evictions++;
+            this.stats.size = this.cache.size;
+            return false;
+        }
+        return true;
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    /** Return all non-expired entries. */
+    entries() {
+        const result = [];
+        for (const [key, entry] of this.cache) {
+            if (!this.isExpired(entry)) {
+                result.push([key, entry]);
+            }
+        }
+        return result;
+    }
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > entry.ttl;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/sharing/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/sharing/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,oBAAoB;AAEpB,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,2BAA2B;AAE3B,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,KAAK,GAAe,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAClE,UAAU,CAAS;IAE3B,YAAY,aAAqB,iBAAiB;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,GAAY,EAAE,MAAM,GAAG,SAAS;QACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU;YAC3B,MAAM;SACP,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,sCAAsC;IACtC,OAAO;QACL,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CAAC,KAAoB;QACpC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC;IAClD,CAAC;CACF"}