@bradygaster/squad-sdk 0.7.0 → 0.8.2

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"}

package/dist/sharing/conflicts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Conflict Resolution on Import (M5-9, Issue #133)
+ */
+import type { SquadConfig } from '../config/schema.js';
+/** Incoming config bundle for conflict detection. */
+export interface IncomingBundle {
+    version: string;
+    config: Partial<SquadConfig>;
+    agents?: Array<{
+        name: string;
+        charter: string;
+    }>;
+    skills?: Array<{
+        id: string;
+        content: string;
+    }>;
+}
+export type ConflictType = 'added' | 'modified' | 'removed';
+export interface Conflict {
+    path: string;
+    existingValue: unknown;
+    incomingValue: unknown;
+    type: ConflictType;
+}
+export type ConflictStrategy = 'keep-existing' | 'use-incoming' | 'merge' | 'manual';
+/** Detect conflicts between an existing config and an incoming bundle. */
+export declare function detectConflicts(existing: SquadConfig, incoming: IncomingBundle): Conflict[];
+/** Resolve conflicts using the given strategy. Returns a merged SquadConfig. */
+export declare function resolveConflicts(existing: SquadConfig, conflicts: Conflict[], strategy: ConflictStrategy): SquadConfig;
+/** Generate a human-readable markdown conflict report. */
+export declare function generateConflictReport(conflicts: Conflict[]): string;
+//# sourceMappingURL=conflicts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../src/sharing/conflicts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AA2BrF,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,cAAc,GACvB,QAAQ,EAAE,CAuBZ;AAID,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,gBAAgB,GACzB,WAAW,CA4Bb;AAID,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAqBpE"}

package/dist/sharing/conflicts.js

@@ -0,0 +1,121 @@
+/**
+ * Conflict Resolution on Import (M5-9, Issue #133)
+ */
+// --- Detection ---
+/** Flatten an object into dotted key paths. */
+function flattenObject(obj, prefix = '') {
+    const result = new Map();
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            for (const [k, v] of flattenObject(value, fullKey)) {
+                result.set(k, v);
+            }
+        }
+        else {
+            result.set(fullKey, value);
+        }
+    }
+    return result;
+}
+function valuesEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/** Detect conflicts between an existing config and an incoming bundle. */
+export function detectConflicts(existing, incoming) {
+    const conflicts = [];
+    const existingFlat = flattenObject(existing);
+    const incomingFlat = flattenObject(incoming.config);
+    // Check incoming keys against existing
+    for (const [path, incomingValue] of incomingFlat) {
+        const existingValue = existingFlat.get(path);
+        if (existingValue === undefined) {
+            conflicts.push({ path, existingValue: undefined, incomingValue, type: 'added' });
+        }
+        else if (!valuesEqual(existingValue, incomingValue)) {
+            conflicts.push({ path, existingValue, incomingValue, type: 'modified' });
+        }
+    }
+    // Check for keys in existing that are missing from incoming (removed)
+    for (const [path, existingValue] of existingFlat) {
+        if (!incomingFlat.has(path)) {
+            conflicts.push({ path, existingValue, incomingValue: undefined, type: 'removed' });
+        }
+    }
+    return conflicts;
+}
+// --- Resolution ---
+/** Resolve conflicts using the given strategy. Returns a merged SquadConfig. */
+export function resolveConflicts(existing, conflicts, strategy) {
+    if (strategy === 'keep-existing') {
+        return { ...existing };
+    }
+    if (strategy === 'manual') {
+        return { ...existing };
+    }
+    // Clone via JSON round-trip
+    const result = JSON.parse(JSON.stringify(existing));
+    for (const conflict of conflicts) {
+        if (strategy === 'use-incoming') {
+            if (conflict.type === 'removed') {
+                deletePath(result, conflict.path);
+            }
+            else {
+                setPath(result, conflict.path, conflict.incomingValue);
+            }
+        }
+        else if (strategy === 'merge') {
+            if (conflict.type === 'added') {
+                setPath(result, conflict.path, conflict.incomingValue);
+            }
+            // 'modified' keeps existing, 'removed' keeps existing
+        }
+    }
+    return result;
+}
+// --- Report ---
+/** Generate a human-readable markdown conflict report. */
+export function generateConflictReport(conflicts) {
+    if (conflicts.length === 0)
+        return '# Conflict Report\n\nNo conflicts detected.\n';
+    const lines = [
+        '# Conflict Report',
+        '',
+        `**${conflicts.length}** conflict(s) detected.`,
+        '',
+        '| # | Path | Type | Existing | Incoming |',
+        '|---|------|------|----------|----------|',
+    ];
+    let i = 1;
+    for (const c of conflicts) {
+        const existing = c.existingValue === undefined ? '_(none)_' : `\`${JSON.stringify(c.existingValue)}\``;
+        const incoming = c.incomingValue === undefined ? '_(none)_' : `\`${JSON.stringify(c.incomingValue)}\``;
+        lines.push(`| ${i++} | \`${c.path}\` | ${c.type} | ${existing} | ${incoming} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// --- Helpers ---
+function setPath(obj, dotPath, value) {
+    const parts = dotPath.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== 'object') {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function deletePath(obj, dotPath) {
+    const parts = dotPath.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== 'object') {
+            return;
+        }
+        current = current[parts[i]];
+    }
+    delete current[parts[parts.length - 1]];
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/sharing/conflicts.js.map

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

package/dist/sharing/export.d.ts

@@ -0,0 +1,50 @@
+/**
+ * M5-1: Export command (squad export)
+ * Exports Squad configuration as a portable bundle.
+ */
+export interface ExportOptions {
+    includeHistory?: boolean;
+    includeSkills?: boolean;
+    format?: 'json' | 'yaml';
+    anonymize?: boolean;
+}
+export interface AgentCharter {
+    name: string;
+    role: string;
+    content: string;
+}
+export interface ExportRoutingRule {
+    pattern: string;
+    agent: string;
+    priority?: number;
+}
+export interface ExportMetadata {
+    version: string;
+    timestamp: string;
+    source: string;
+}
+export interface ExportBundle {
+    config: Record<string, unknown>;
+    agents: AgentCharter[];
+    skills: string[];
+    routingRules: ExportRoutingRule[];
+    metadata: ExportMetadata;
+    history?: Record<string, unknown>[];
+}
+/**
+ * Strip secrets and sensitive patterns from text content.
+ */
+export declare function sanitizeContent(content: string): string;
+/**
+ * Anonymize PII and local paths from content.
+ */
+export declare function anonymizeContent(content: string): string;
+/**
+ * Export a Squad project configuration as a bundle.
+ */
+export declare function exportSquadConfig(projectDir: string, options?: ExportOptions): ExportBundle;
+/**
+ * Serialize an export bundle to a string.
+ */
+export declare function serializeBundle(bundle: ExportBundle, format?: 'json' | 'yaml'): string;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/sharing/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACrC;AAWD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAuCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CA6C3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKtF"}