forkit-connect 0.1.5 → 0.1.6

package/dist/v1/service.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectV1Service = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
@@ -54,6 +55,24 @@ const SMART_INBOX_FRESH_MAX_AGE_MS = 45 * 1000;
 function isRecord(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
+function extractApiErrorCode(body) {
+    if (!isRecord(body))
+        return null;
+    const directKeys = ['code', 'errorCode', 'error_code'];
+    for (const key of directKeys) {
+        const value = body[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    if (isRecord(body.error)) {
+        for (const key of directKeys) {
+            const value = body.error[key];
+            if (typeof value === 'string' && value.trim())
+                return value.trim();
+        }
+    }
+    return null;
+}
 function smartInboxItemTimestamp(item) {
     const details = isRecord(item.details_received_automatically) ? item.details_received_automatically : {};
     const rawTimestamp = [
@@ -583,6 +602,7 @@ class ConnectV1Service {
         this.credentialStore = new credential_store_1.ConnectCredentialStore(this.stateStore.getPaths().stateDir, options?.credentialBackend, options?.legacyCredentialBackend);
         this.credentialStore.migrateLegacyPlaintextFile();
         this.migrateLegacyCredentials();
+        this.syncRuntimeIdentityMetadata();
         this.syncIdentityFromLocalState();
         this.syncServiceEntitlements();
     }
@@ -1203,6 +1223,7 @@ class ConnectV1Service {
         return entitlements;
     }
     syncIdentityFromLocalState() {
+        this.syncRuntimeIdentityMetadata();
         const state = this.stateStore.readState();
         const identity = this.getIdentityState(state);
         const hasIdentity = Boolean(identity.connect_device_id && identity.connect_public_key && this.hasStoredPrivateKey());
@@ -1227,6 +1248,22 @@ class ConnectV1Service {
         this.stateStore.updateConnectIdentity(nextIdentity);
         return nextIdentity;
     }
+    syncRuntimeIdentityMetadata() {
+        const state = this.stateStore.readState();
+        const nextHostname = node_os_1.default.hostname();
+        const nextPlatform = process.platform;
+        const nextArch = process.arch;
+        if (state.runtime_identity.hostname === nextHostname
+            && state.runtime_identity.platform === nextPlatform
+            && state.runtime_identity.arch === nextArch) {
+            return;
+        }
+        this.stateStore.updateRuntimeIdentity({
+            hostname: nextHostname,
+            platform: nextPlatform,
+            arch: nextArch,
+        });
+    }
     createConnectIdentity() {
         const { privateKey, publicKey } = (0, node_crypto_1.generateKeyPairSync)('ed25519');
         const publicKeyValue = publicKey.export({ type: 'spki', format: 'der' }).toString('base64url');
@@ -1633,6 +1670,12 @@ class ConnectV1Service {
             sessionRef: this.readSessionRef(),
         });
     }
+    getApiClientWithSessionToken(sessionRef) {
+        return new api_1.ConnectApiClient({
+            baseUrl: DEFAULT_BASE_URL,
+            sessionRef,
+        });
+    }
     ensureRuntimePassportIdentity() {
         const state = this.stateStore.readState();
         if (state.connect_identity.connect_device_id) {
@@ -2757,18 +2800,20 @@ class ConnectV1Service {
     }
     setRuntimeSignalApiKeyForGaid(gaid, apiKey) {
         if (!gaid || !apiKey)
-            return;
+            return null;
+        const metadata = this.credentialStore.setRuntimeSignalApiKey(gaid, apiKey);
         const state = this.stateStore.readState();
         const binding = this.findBindingByGaid(state, gaid);
-        if (!binding)
-            return;
-        const metadata = this.credentialStore.setRuntimeSignalApiKey(gaid, apiKey);
+        if (!binding) {
+            return metadata;
+        }
         this.stateStore.upsertModelBinding({
             ...binding,
             runtimeSignalKeyPresent: true,
             runtimeSignalKeyRef: metadata.credentialRef,
             updatedAt: nowIso(),
         });
+        return metadata;
     }
     clearRuntimeSignalApiKeyForGaid(gaid, source = 'reset') {
         if (!gaid)
@@ -2858,10 +2903,10 @@ class ConnectV1Service {
         if (/^[_\-x0]+$/i.test(trimmedKey)) {
             return { stored: false, backfilled: 0, gaid: trimmedGaid, keyRef: null };
         }
-        this.setRuntimeSignalApiKeyForGaid(trimmedGaid, trimmedKey);
+        const credentialMetadata = this.setRuntimeSignalApiKeyForGaid(trimmedGaid, trimmedKey);
         const afterState = this.stateStore.readState();
         const binding = this.findBindingByGaid(afterState, trimmedGaid);
-        const keyRef = binding?.runtimeSignalKeyRef ?? null;
+        const keyRef = binding?.runtimeSignalKeyRef ?? credentialMetadata?.credentialRef ?? null;
         const backfilled = this.backfillLocalOnlyC2Events(trimmedGaid);
         this.stateStore.addEvidenceEvent({
             type: 'runtimeSignal_key_configured',
@@ -2874,6 +2919,72 @@ class ConnectV1Service {
         });
         return { stored: true, backfilled, gaid: trimmedGaid, keyRef };
     }
+    registerRuntimeObserverTarget(input) {
+        const now = nowIso();
+        const runtimeGaid = String(input.gaid || '').trim();
+        const rawRepoRoot = String(input.repoRoot || '').trim();
+        if (!runtimeGaid || !rawRepoRoot) {
+            throw new Error('RUNTIME_OBSERVER_TARGET_INVALID');
+        }
+        const repoRoot = node_path_1.default.resolve(rawRepoRoot);
+        const state = this.stateStore.readState();
+        const existing = state.runtime_observer_targets.find((item) => item.runtime_gaid === runtimeGaid);
+        const nextTarget = {
+            runtime_gaid: runtimeGaid,
+            repo_root: repoRoot,
+            client_name: normalizeDisplayText(input.clientName) ?? existing?.client_name ?? null,
+            subject_id: normalizeDisplayText(input.subjectId) ?? existing?.subject_id ?? null,
+            worktree_id: normalizeDisplayText(input.worktreeId) ?? existing?.worktree_id ?? null,
+            last_observed_at: existing?.last_observed_at ?? null,
+            last_emitted_at: existing?.last_emitted_at ?? null,
+            last_fingerprint: existing?.last_fingerprint ?? null,
+            last_summary: existing?.last_summary ?? null,
+            last_error: existing?.last_error ?? null,
+            updated_at: now,
+        };
+        this.stateStore.upsertRuntimeObserverTarget(nextTarget);
+        return nextTarget;
+    }
+    listRuntimeObserverTargets() {
+        return [...this.stateStore.readState().runtime_observer_targets];
+    }
+    hasRuntimeSignalKey(gaid) {
+        return Boolean(this.credentialStore.getRuntimeSignalApiKey(String(gaid || '').trim()));
+    }
+    hasStoredRuntimeSignalKey(gaid) {
+        const trimmedGaid = String(gaid || '').trim();
+        if (!trimmedGaid)
+            return false;
+        return this.hasRuntimeSignalKey(trimmedGaid);
+    }
+    removeRuntimeObserverTarget(gaid) {
+        const runtimeGaid = String(gaid || '').trim();
+        if (!runtimeGaid)
+            return false;
+        const state = this.stateStore.readState();
+        const existing = state.runtime_observer_targets.find((item) => item.runtime_gaid === runtimeGaid);
+        if (!existing)
+            return false;
+        this.stateStore.removeRuntimeObserverTarget(runtimeGaid);
+        return true;
+    }
+    updateRuntimeObserverTargetResult(input) {
+        const state = this.stateStore.readState();
+        const existing = state.runtime_observer_targets.find((item) => item.runtime_gaid === String(input.gaid || '').trim());
+        if (!existing)
+            return null;
+        const nextTarget = {
+            ...existing,
+            last_observed_at: typeof input.observedAt === 'string' ? input.observedAt : existing.last_observed_at,
+            last_emitted_at: typeof input.emittedAt === 'string' ? input.emittedAt : existing.last_emitted_at,
+            last_fingerprint: input.fingerprint !== undefined ? (normalizeDisplayText(input.fingerprint) ?? null) : existing.last_fingerprint,
+            last_summary: input.summary !== undefined ? (normalizeDisplayText(input.summary) ?? null) : existing.last_summary,
+            last_error: input.error !== undefined ? (normalizeDisplayText(input.error) ?? null) : existing.last_error,
+            updated_at: nowIso(),
+        };
+        this.stateStore.upsertRuntimeObserverTarget(nextTarget);
+        return nextTarget;
+    }
     // ─── Auto-provisioning ────────────────────────────────────────────────────
     /**
      * After login, automatically create a runtime-signal API key for every bound
@@ -2887,7 +2998,12 @@ class ConnectV1Service {
         if (!this.hasSessionRef()) {
             return { provisioned: [], skipped: [], failed: [] };
         }
-        const gaidsNeedingKeys = (0, lifecycle_monitor_1.findPassportsNeedingApiKeyProvisioning)(state);
+        const gaidsNeedingKeys = [...new Set([
+                ...(0, lifecycle_monitor_1.findPassportsNeedingApiKeyProvisioning)(state),
+                ...state.runtime_observer_targets
+                    .map((target) => normalizeDisplayText(target.runtime_gaid))
+                    .filter((gaid) => Boolean(gaid)),
+            ])].filter((gaid) => !this.hasRuntimeSignalKey(gaid));
         if (gaidsNeedingKeys.length === 0) {
             return { provisioned: [], skipped: [], failed: [] };
         }
@@ -3086,6 +3202,8 @@ class ConnectV1Service {
         const completionTokens = Math.max(0, Math.trunc(input.completionTokens ?? 0));
         const totalTokens = promptTokens + completionTokens;
         const { workspaceId, projectId } = this.resolveRuntimeRunScope(state, gaid);
+        const runtimeMetadata = isRecord(input.metadata) ? input.metadata : {};
+        const steps = Array.isArray(input.steps) ? input.steps.filter((step) => isRecord(step)) : [];
         return this.getApiClient(state).pushRuntimeRunLog({
             gaid,
             apiKey,
@@ -3116,13 +3234,50 @@ class ConnectV1Service {
                 ...(input.summary ? { summary: String(input.summary).trim().slice(0, 4000) } : {}),
                 metadata: {
                     source: 'forkit-connect-cli',
+                    sourceSurface: 'connect_assisted',
                     safe_metadata_only: true,
                     connect_device_id: state.connect_identity.connect_device_id,
+                    ...runtimeMetadata,
                 },
             },
-            steps: [],
+            steps,
         });
     }
+    async emitRuntimeObserverCheckin(input) {
+        const state = this.stateStore.readState();
+        const gaid = String(input.gaid || '').trim();
+        const apiKey = String(input.apiKey || this.resolveRuntimeSignalApiKeyForEvent(state, gaid) || '').trim();
+        if (!gaid || !apiKey) {
+            return {
+                ok: false,
+                status: 0,
+                body: {
+                    error: 'Runtime signal API key required for runtime observer check-ins.',
+                    code: 'MISSING_RUNTIME_SIGNAL_API_KEY',
+                },
+                contract: null,
+            };
+        }
+        const metadata = isRecord(input.metadata) ? input.metadata : {};
+        const client = this.getApiClientWithSessionToken(apiKey);
+        return client.sendRuntimeCheckin(gaid, {
+            ...(input.sessionLabel ? { sessionLabel: String(input.sessionLabel).trim() } : {}),
+            ...(input.environment ? { environment: String(input.environment).trim() } : {}),
+            ...(input.region ? { region: String(input.region).trim() } : {}),
+            ...(input.hostLabel ? { hostLabel: String(input.hostLabel).trim() } : {}),
+            ...(input.runtimeLabel ? { runtimeLabel: String(input.runtimeLabel).trim() } : {}),
+            ...(input.runtimeMode ? { runtimeMode: String(input.runtimeMode).trim() } : {}),
+            ...(input.resourceAccuracy ? { resourceAccuracy: String(input.resourceAccuracy).trim() } : {}),
+            ...(input.resourceNote ? { resourceNote: String(input.resourceNote).trim() } : {}),
+            ...(input.cpuPercent !== undefined ? { cpuPercent: input.cpuPercent } : {}),
+            ...(input.memoryMb !== undefined ? { memoryMb: input.memoryMb } : {}),
+            ...(input.vramMb !== undefined ? { vramMb: input.vramMb } : {}),
+            ...(input.promptTokens !== undefined ? { promptTokens: Math.max(0, Math.trunc(input.promptTokens)) } : {}),
+            ...(input.completionTokens !== undefined ? { completionTokens: Math.max(0, Math.trunc(input.completionTokens)) } : {}),
+            ...(input.executionMs !== undefined ? { executionMs: Math.max(0, Math.trunc(input.executionMs)) } : {}),
+            metadata,
+        }, input.sessionId || null);
+    }
     findAgentByIdOrName(state, selector) {
         const normalized = selector.trim().toLowerCase();
         const exactId = state.detected_agents.find((agent) => agent.agent_id === selector || agent.agent_id.startsWith(selector));
@@ -6423,7 +6578,7 @@ class ConnectV1Service {
                     source: 'draft_sync',
                 });
                 if (!this.shouldFallbackToQueuedTrainingDraft(result.status)) {
-                    throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : `DRAFT_CREATE_FAILED:${result.status}`);
+                    throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : (extractApiErrorCode(result.body) || `DRAFT_CREATE_FAILED:${result.status}`));
                 }
             }
             else {
@@ -7789,7 +7944,7 @@ class ConnectV1Service {
                     body: result.body,
                     source: 'draft_sync',
                 });
-                throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : `DRAFT_CREATE_FAILED:${result.status}`);
+                throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : (extractApiErrorCode(result.body) || `DRAFT_CREATE_FAILED:${result.status}`));
             }
             const parsed = this.parseDraftResponse(result);
             let finalGaid = parsed.gaid;

package/dist/v1/state.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelUsageRecord, BuildSession, C2SessionState, C2LifecycleEvent, ConnectIdentityState, ConnectConfig, ConnectEffectiveBindingState, ConnectState, DaemonStatus, DetectedAgent, DetectedModel, DetectedRuntime, DeliveredNotification, EvidenceEvent, LifecycleMonitorRecord, ModelEvolutionCandidate, ModelBinding, PendingReview, RuntimePassport, ServiceEntitlements, SyncQueueItem, VitalityPulseEvent, VitalityPulseSummary } from './types';
+import type { AgentModelUsageRecord, BuildSession, C2SessionState, C2LifecycleEvent, ConnectIdentityState, ConnectConfig, ConnectEffectiveBindingState, ConnectState, DaemonStatus, DetectedAgent, DetectedModel, DetectedRuntime, DeliveredNotification, EvidenceEvent, LifecycleMonitorRecord, ModelEvolutionCandidate, ModelBinding, PendingReview, RuntimePassport, RuntimeIdentity, RuntimeObserverTarget, ServiceEntitlements, SyncQueueItem, VitalityPulseEvent, VitalityPulseSummary } from './types';
 import type { AgentLink } from './types';
 export interface StatePaths {
     stateDir: string;
@@ -26,6 +26,7 @@ export declare class LocalStateStore {
     updateEffectiveBinding(effectiveBinding: ConnectEffectiveBindingState | null): ConnectState;
     updateConnectConfig(configPatch: Partial<Pick<ConnectConfig, 'discovery_mode' | 'daemon_interval_seconds' | 'notifications_enabled' | 'notification_min_interval_seconds' | 'evolution_bridge_enabled'>>): ConnectState;
     updateConnectIdentity(identityPatch: Partial<ConnectIdentityState>): ConnectState;
+    updateRuntimeIdentity(identityPatch: Partial<RuntimeIdentity>): ConnectState;
     updateServiceEntitlements(entitlements: ServiceEntitlements): ConnectState;
     updateDaemonStatus(statusPatch: Partial<DaemonStatus>): ConnectState;
     appendC2Events(events: C2LifecycleEvent[]): ConnectState;
@@ -46,6 +47,8 @@ export declare class LocalStateStore {
     upsertDetectedRuntime(runtime: DetectedRuntime): ConnectState;
     upsertRuntimePassport(runtimePassport: RuntimePassport): ConnectState;
     replaceRuntimePassports(runtimePassports: RuntimePassport[]): ConnectState;
+    upsertRuntimeObserverTarget(target: RuntimeObserverTarget): ConnectState;
+    removeRuntimeObserverTarget(runtimeGaid: string): ConnectState;
     upsertC2Session(session: C2SessionState): ConnectState;
     replaceC2Sessions(sessions: C2SessionState[]): ConnectState;
     upsertBuildSession(buildSession: BuildSession): ConnectState;

package/dist/v1/state.js

@@ -65,6 +65,7 @@ const STATE_SECTION_NAMES = [
     'agent_model_usage',
     'detected_runtimes',
     'runtime_passports',
+    'runtime_observer_targets',
     'c2_sessions',
     'evolution_candidates',
     'detected_models',
@@ -413,6 +414,7 @@ function normalizeState(parsed) {
         agent_model_usage: Array.isArray(value.agent_model_usage) ? value.agent_model_usage : [],
         detected_runtimes: Array.isArray(value.detected_runtimes) ? value.detected_runtimes : [],
         runtime_passports: Array.isArray(value.runtime_passports) ? value.runtime_passports : [],
+        runtime_observer_targets: Array.isArray(value.runtime_observer_targets) ? value.runtime_observer_targets : [],
         c2_sessions: Array.isArray(value.c2_sessions) ? value.c2_sessions : [],
         evolution_candidates: Array.isArray(value.evolution_candidates) ? value.evolution_candidates : [],
         detected_models: Array.isArray(value.detected_models) ? value.detected_models : [],
@@ -477,6 +479,7 @@ function buildInitialState() {
         agent_model_usage: [],
         detected_runtimes: [],
         runtime_passports: [],
+        runtime_observer_targets: [],
         c2_sessions: [],
         evolution_candidates: [],
         detected_models: [],
@@ -593,6 +596,14 @@ class LocalStateStore {
             };
         });
     }
+    updateRuntimeIdentity(identityPatch) {
+        return this.mutateState((state) => {
+            state.runtime_identity = {
+                ...state.runtime_identity,
+                ...identityPatch,
+            };
+        });
+    }
     updateServiceEntitlements(entitlements) {
         return this.mutateState((state) => {
             state.service_entitlements = entitlements;
@@ -813,6 +824,23 @@ class LocalStateStore {
             state.runtime_passports = [...seen.values()].sort((left, right) => right.last_seen_at.localeCompare(left.last_seen_at));
         });
     }
+    upsertRuntimeObserverTarget(target) {
+        return this.mutateState((state) => {
+            const index = state.runtime_observer_targets.findIndex((item) => item.runtime_gaid === target.runtime_gaid);
+            if (index >= 0) {
+                state.runtime_observer_targets[index] = target;
+            }
+            else {
+                state.runtime_observer_targets.push(target);
+            }
+            state.runtime_observer_targets.sort((left, right) => right.updated_at.localeCompare(left.updated_at));
+        });
+    }
+    removeRuntimeObserverTarget(runtimeGaid) {
+        return this.mutateState((state) => {
+            state.runtime_observer_targets = state.runtime_observer_targets.filter((item) => item.runtime_gaid !== runtimeGaid);
+        });
+    }
     upsertC2Session(session) {
         return this.mutateState((state) => {
             const index = state.c2_sessions.findIndex((item) => item.session_id === session.session_id && item.passport_gaid === session.passport_gaid);

package/dist/v1/types.d.ts

@@ -268,6 +268,19 @@ export interface RuntimeHandoffSummary {
     unlinked_runtimes: string[];
     unhealthy_runtimes: string[];
 }
+export interface RuntimeObserverTarget {
+    runtime_gaid: string;
+    repo_root: string;
+    client_name: string | null;
+    subject_id: string | null;
+    worktree_id: string | null;
+    last_observed_at: string | null;
+    last_emitted_at: string | null;
+    last_fingerprint: string | null;
+    last_summary: string | null;
+    last_error: string | null;
+    updated_at: string;
+}
 export interface C2SessionState {
     session_id: string;
     passport_gaid: string;
@@ -895,6 +908,7 @@ export interface ConnectState {
     agent_model_usage: AgentModelUsageRecord[];
     detected_runtimes: DetectedRuntime[];
     runtime_passports: RuntimePassport[];
+    runtime_observer_targets: RuntimeObserverTarget[];
     c2_sessions: C2SessionState[];
     evolution_candidates: ModelEvolutionCandidate[];
     detected_models: DetectedModel[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forkit-connect",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Forkit Connect Local Engine - The Global AI Governance Fabric",
   "license": "MIT",
   "main": "dist/index.js",