instar 0.26.11 → 0.27.2

package/dist/moltbridge/MoltBridgeClient.js

@@ -0,0 +1,321 @@
+/**
+ * MoltBridgeClient — Wraps the published MoltBridge SDK for instar integration.
+ *
+ * Uses the real `moltbridge` npm package with proper Ed25519 auth,
+ * proof-of-AI verification, and correct endpoint paths.
+ *
+ * Adds:
+ * - Circuit breaker for resilience
+ * - IQS band caching (1-hour TTL)
+ * - Identity bridging (instar Ed25519 key → MoltBridge SDK signer)
+ */
+import { MoltBridge } from 'moltbridge';
+const CB_THRESHOLD = 3;
+const CB_RESET_MS = 5 * 60 * 1000; // 5 minutes
+// ── Client ───────────────────────────────────────────────────────────
+export class MoltBridgeClient {
+    config;
+    sdk = null;
+    circuitBreaker = {
+        failures: 0, lastFailure: 0, open: false, openedAt: 0,
+    };
+    iqsCache = new Map();
+    IQS_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+    verificationToken = null;
+    constructor(config) {
+        this.config = config;
+    }
+    get enabled() {
+        return this.config.enabled;
+    }
+    get enrichmentMode() {
+        return this.config.enrichmentMode ?? 'manual';
+    }
+    /**
+     * Initialize the SDK with an instar identity.
+     * Must be called before any API operations.
+     */
+    initializeWithIdentity(identity) {
+        const seedHex = identity.privateKey.toString('hex');
+        this.sdk = new MoltBridge({
+            agentId: identity.canonicalId,
+            signingKey: seedHex,
+            baseUrl: this.config.apiUrl,
+            timeout: 30_000,
+            maxRetries: 3,
+        });
+    }
+    /**
+     * Check if the SDK has been initialized with an identity.
+     */
+    get initialized() {
+        return this.sdk !== null;
+    }
+    /**
+     * Verify with MoltBridge (proof-of-AI challenge).
+     * Required before registration.
+     */
+    async verify() {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            const result = await this.sdk.verify();
+            this.recordSuccess();
+            this.verificationToken = result.token;
+            return result;
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Register this agent with MoltBridge.
+     * Automatically runs verification if no token is cached.
+     */
+    async register(identity, capabilities = [], displayName) {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            // Run verification if we don't have a token
+            if (!this.verificationToken) {
+                const verification = await this.sdk.verify();
+                this.verificationToken = verification.token;
+            }
+            const response = await this.sdk.register({
+                agentId: identity.canonicalId,
+                name: displayName ?? this.config.agentName ?? 'instar-agent',
+                platform: this.config.platform ?? 'instar',
+                pubkey: identity.publicKey.toString('base64url'),
+                capabilities,
+                verificationToken: this.verificationToken,
+                omniscienceAcknowledged: true,
+                article22Consent: true,
+            });
+            this.recordSuccess();
+            this.verificationToken = null; // consumed
+            return {
+                agent: response.agent ?? response,
+                consentsGranted: response.consents_granted ?? [],
+            };
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Discover agents by capability.
+     */
+    async discover(capability, limit = 10) {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        const startTime = Date.now();
+        try {
+            const response = await this.sdk.discoverCapability({
+                needs: [capability],
+                maxResults: limit,
+            });
+            this.recordSuccess();
+            const results = response.results ?? [];
+            return {
+                agents: results.map((r) => ({
+                    agentId: r.agent_id,
+                    agentName: r.agent_name,
+                    capabilities: r.matched_capabilities ?? [],
+                    trustScore: r.trust_score ?? 0,
+                    matchScore: r.match_score,
+                })),
+                source: 'moltbridge',
+                queryTimeMs: Date.now() - startTime,
+                cached: false,
+            };
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Get IQS band for an agent (cached).
+     * Returns null on error (graceful degradation).
+     */
+    async getIQSBand(targetId) {
+        // Check cache first
+        const cached = this.iqsCache.get(targetId);
+        if (cached && Date.now() - cached.cachedAt < this.IQS_CACHE_TTL_MS) {
+            return cached.band;
+        }
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            const response = await this.sdk.evaluateIqs({ targetId });
+            this.recordSuccess();
+            const band = (response.band ?? 'unknown');
+            this.iqsCache.set(targetId, { band, cachedAt: Date.now() });
+            return band;
+        }
+        catch (err) {
+            this.recordFailure();
+            return null; // graceful degradation
+        }
+    }
+    /**
+     * Submit a peer attestation.
+     */
+    async submitAttestation(attestation) {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            await this.sdk.attest({
+                targetAgentId: attestation.targetAgentId,
+                attestationType: attestation.attestationType,
+                capabilityTag: attestation.capabilityTag,
+                confidence: attestation.confidence,
+            });
+            this.recordSuccess();
+            return true;
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    // ── Rich Agent Profile Methods ──────────────────────────────────
+    /**
+     * Publish or update the agent's rich profile on MoltBridge.
+     * Maps the rich profile payload to MoltBridge's principal profile APIs.
+     */
+    async publishProfile(profile) {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            // Map rich profile to MoltBridge's principal/agent profile fields
+            const expertise = profile.specializations.map(s => s.domain);
+            const projects = profile.trackRecord.map(t => ({
+                name: t.title,
+                description: t.description,
+                status: 'completed',
+                visibility: 'public',
+            }));
+            // Update agent-level profile (capabilities + a2a endpoint)
+            await this.sdk.updateProfile({
+                capabilities: expertise,
+            });
+            // Update principal profile with rich narrative data
+            const result = await this.sdk.updatePrincipal({
+                bio: profile.narrative,
+                role: profile.roleContext,
+                expertise,
+                lookingFor: [],
+                canOffer: [profile.collaborationStyle, profile.differentiation].filter(Boolean),
+                replace: true,
+            });
+            this.recordSuccess();
+            return result;
+        }
+        catch (err) {
+            // If principal not onboarded yet, onboard first
+            if (err?.message?.includes('onboard') || err?.status === 404) {
+                try {
+                    const expertise = profile.specializations.map(s => s.domain);
+                    const result = await this.sdk.onboardPrincipal({
+                        bio: profile.narrative,
+                        role: profile.roleContext,
+                        expertise,
+                        canOffer: [profile.collaborationStyle, profile.differentiation].filter(Boolean),
+                    });
+                    this.recordSuccess();
+                    return result;
+                }
+                catch (onboardErr) {
+                    this.recordFailure();
+                    throw onboardErr;
+                }
+            }
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Get the agent's full profile from MoltBridge.
+     */
+    async getProfile() {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            const result = await this.sdk.getPrincipal();
+            this.recordSuccess();
+            return result;
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Get the public-facing profile summary (for discovery cards).
+     */
+    async getProfileSummary() {
+        this.requireSDK();
+        this.checkCircuitBreaker();
+        try {
+            const result = await this.sdk.getPrincipalVisibility();
+            this.recordSuccess();
+            return result;
+        }
+        catch (err) {
+            this.recordFailure();
+            throw err;
+        }
+    }
+    /**
+     * Check server health (unauthenticated).
+     */
+    async health() {
+        this.requireSDK();
+        try {
+            const result = await this.sdk.health();
+            return result;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /**
+     * Check if the circuit breaker is currently open.
+     */
+    get isCircuitBreakerOpen() {
+        if (!this.circuitBreaker.open)
+            return false;
+        if (Date.now() - this.circuitBreaker.openedAt > CB_RESET_MS) {
+            this.circuitBreaker.open = false;
+            this.circuitBreaker.failures = 0;
+            return false;
+        }
+        return true;
+    }
+    // ── Private ─────────────────────────────────────────────────────
+    requireSDK() {
+        if (!this.sdk) {
+            throw new Error('MoltBridgeClient not initialized — call initializeWithIdentity() first');
+        }
+    }
+    checkCircuitBreaker() {
+        if (this.isCircuitBreakerOpen) {
+            throw new Error('MoltBridge circuit breaker is open — service temporarily unavailable');
+        }
+    }
+    recordSuccess() {
+        this.circuitBreaker.failures = 0;
+    }
+    recordFailure() {
+        this.circuitBreaker.failures++;
+        this.circuitBreaker.lastFailure = Date.now();
+        if (this.circuitBreaker.failures >= CB_THRESHOLD) {
+            this.circuitBreaker.open = true;
+            this.circuitBreaker.openedAt = Date.now();
+        }
+    }
+}
+//# sourceMappingURL=MoltBridgeClient.js.map

package/dist/moltbridge/MoltBridgeClient.js.map

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

package/dist/moltbridge/ProfileCompiler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ProfileCompiler — Compiles rich agent profiles from instar agent data.
+ *
+ * Implements the spec v2.1 compilation pipeline:
+ * 1. Rule-based extraction from AGENT.md, tagged MEMORY.md, git stats, jobs, capabilities
+ * 2. LLM narrative synthesis (Haiku-class) from StructuredSignals only
+ * 3. Content-hash freshness tracking (max 1 recompilation per 24 hours)
+ * 4. Human review gate (drafts must be approved before publishing)
+ *
+ * Security: USER.md is NEVER read. MEMORY.md only contributes #profile-safe entries.
+ */
+import type { StructuredSignals, ProfileDraft, ProfileFreshnessState } from './types.js';
+export interface ProfileCompilerConfig {
+    /** Path to the agent's state directory (e.g., .instar/) */
+    stateDir: string;
+    /** Path to the project root (for git stats) */
+    projectRoot: string;
+    /** Optional LLM synthesis function. If not provided, uses rule-based narrative. */
+    llmSynthesize?: (signals: StructuredSignals) => Promise<string>;
+    /** Agent's capability list from server config */
+    capabilities?: string[];
+    /** Agent's job names from job scheduler */
+    jobNames?: string[];
+}
+export declare class ProfileCompiler {
+    private config;
+    private currentDraft;
+    private freshnessState;
+    constructor(config: ProfileCompilerConfig);
+    /**
+     * Compile a rich profile from the agent's data sources.
+     * Returns a draft pending human approval.
+     */
+    compile(): Promise<ProfileDraft>;
+    /**
+     * Check if recompilation is needed based on source changes.
+     */
+    needsRecompile(): Promise<boolean>;
+    /**
+     * Get the current draft (if any).
+     */
+    getCurrentDraft(): ProfileDraft | null;
+    /**
+     * Mark the current draft as published and update freshness state.
+     */
+    markPublished(): void;
+    /**
+     * Check if auto-publish is allowed (max 3 consecutive without human review).
+     */
+    canAutoPublish(): boolean;
+    /** Get freshness state for external inspection. */
+    getFreshnessState(): ProfileFreshnessState;
+    extractSignals(): Promise<StructuredSignals>;
+    private readAgentMd;
+    /**
+     * Read ONLY #profile-safe tagged entries from MEMORY.md.
+     * USER.md is NEVER read (contains human PII).
+     */
+    private readTaggedMemory;
+    private getGitStats;
+    private extractName;
+    private extractRoleHints;
+    private extractSpecializations;
+    private buildProfile;
+    private buildRuleBasedNarrative;
+    private computeSourceHash;
+}
+//# sourceMappingURL=ProfileCompiler.d.ts.map

package/dist/moltbridge/ProfileCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileCompiler.d.ts","sourceRoot":"","sources":["../../src/moltbridge/ProfileCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EACV,iBAAiB,EAEjB,YAAY,EACZ,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAKD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAIpB;gBAEU,MAAM,EAAE,qBAAqB;IAIzC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IA4BtC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,aAAa,IAAI,IAAI;IAWrB;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB,mDAAmD;IACnD,iBAAiB,IAAI,qBAAqB;IAMpC,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC;YAwBpC,WAAW;IAUzB;;;OAGG;YACW,gBAAgB;IAgC9B,OAAO,CAAC,WAAW;IA2CnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,sBAAsB;YA2ChB,YAAY;IAgD1B,OAAO,CAAC,uBAAuB;IA2B/B,OAAO,CAAC,iBAAiB;CAI1B"}