@holon-run/agentinbox 0.5.0 → 0.7.0

package/dist/src/service.js

@@ -9,6 +9,7 @@ const source_resolution_1 = require("./source_resolution");
 const filter_1 = require("./filter");
 const terminal_1 = require("./terminal");
 const runtime_gate_1 = require("./runtime_gate");
+const logging_1 = require("./logging");
 const DEFAULT_SUBSCRIPTION_POLL_LIMIT = 100;
 const DEFAULT_ACTIVATION_WINDOW_MS = 3_000;
 const DEFAULT_ACTIVATION_MAX_ITEMS = 20;
@@ -43,7 +44,7 @@ class AgentInboxService {
     lastAckedInboxGcAt = 0;
     lastLifecycleCleanupAt = 0;
     lastOfflineAgentGcAt = 0;
-    constructor(store, adapters, activationDispatcher = new ActivationDispatcher(), backend, activationPolicy, terminalDispatcher = new terminal_1.TerminalDispatcher(), activationGate = new runtime_gate_1.DefaultActivationGate()) {
+    constructor(store, adapters, activationDispatcher = new ActivationDispatcher(), backend, activationPolicy, terminalDispatcher = new terminal_1.TerminalDispatcher(), activationGate, logger = new logging_1.NoopLogger()) {
         this.store = store;
         this.adapters = adapters;
         this.activationDispatcher = activationDispatcher;
@@ -52,11 +53,13 @@ class AgentInboxService {
         this.activationMaxItems = activationPolicy?.maxItems ?? DEFAULT_ACTIVATION_MAX_ITEMS;
         this.ackedRetentionMs = DEFAULT_ACKED_RETENTION_MS;
         this.terminalDispatcher = terminalDispatcher;
-        this.activationGate = activationGate;
+        this.logger = logger;
+        this.activationGate = activationGate ?? new runtime_gate_1.DefaultActivationGate(undefined, undefined, this.logger.child("gate"));
     }
     activationDispatcher;
     terminalDispatcher;
     activationGate;
+    logger;
     async start() {
         if (this.syncInterval) {
             return;
@@ -1550,12 +1553,32 @@ class AgentInboxService {
         try {
             if (target.kind === "terminal") {
                 const gate = await this.activationGate.evaluate(target);
+                this.logger.debug("activation.gate_decision", {
+                    agentId: input.agentId,
+                    targetId: target.targetId,
+                    runtimeKind: target.runtimeKind,
+                    backend: target.backend,
+                    outcome: gate.outcome,
+                    reason: gate.reason,
+                });
                 if (gate.outcome === "offline") {
+                    this.logger.info("activation.target_offline", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        reason: gate.reason,
+                        transition: "runtime_gate",
+                    });
                     this.markActivationTargetOffline(target.targetId, `runtime gate: ${gate.reason}`);
                     this.reconcileAgentStatus(target.agentId);
                     return "offline";
                 }
                 if (gate.outcome === "defer") {
+                    this.logger.debug("activation.dispatch_deferred", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        reason: gate.reason,
+                        retryMs: DEFAULT_NOTIFY_RETRY_MS,
+                    });
                     this.store.upsertActivationDispatchState({
                         agentId: input.agentId,
                         targetId: input.targetId,
@@ -1570,9 +1593,21 @@ class AgentInboxService {
                     });
                     return "deferred";
                 }
-                const preview = totalUnackedCount === 1 && input.items.length === 1
-                    ? (0, terminal_1.deriveInlineItemPreview)(input.items[0], input.summary)
-                    : null;
+                let preview = null;
+                if (totalUnackedCount === 1 && input.items.length === 1) {
+                    const singleItem = input.items[0];
+                    const source = this.store.getSource(singleItem.sourceId);
+                    if (source) {
+                        try {
+                            const sourcePreview = await this.adapters.deriveInlinePreview(source, singleItem);
+                            preview = typeof sourcePreview === "string" ? (0, terminal_1.normalizeInlinePreviewText)(sourcePreview) : null;
+                        }
+                        catch {
+                            preview = null;
+                        }
+                    }
+                    preview ??= (0, terminal_1.deriveInlineItemPreview)(singleItem, input.summary);
+                }
                 const prompt = (0, terminal_1.renderAgentPrompt)({
                     inboxId: inbox.inboxId,
                     totalUnackedCount,
@@ -1582,6 +1617,11 @@ class AgentInboxService {
                 terminalPrompt = prompt;
                 const promptFingerprint = terminalReminderFingerprint(prompt, input.items);
                 if (state?.status === "dirty" && state.lastNotifiedFingerprint === promptFingerprint) {
+                    this.logger.debug("activation.dispatch_suppressed", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        reason: "unchanged_terminal_prompt",
+                    });
                     this.store.upsertActivationDispatchState({
                         agentId: input.agentId,
                         targetId: input.targetId,
@@ -1596,7 +1636,19 @@ class AgentInboxService {
                     });
                     return "suppressed";
                 }
+                this.logger.debug("activation.terminal_dispatch_start", {
+                    agentId: input.agentId,
+                    targetId: target.targetId,
+                    totalUnackedCount,
+                    newItemCount: input.newItemCount,
+                    sourceIds: input.sourceIds,
+                    subscriptionIds: input.subscriptionIds,
+                });
                 await this.terminalDispatcher.dispatch(target, prompt);
+                this.logger.debug("activation.terminal_dispatch_succeeded", {
+                    agentId: input.agentId,
+                    targetId: target.targetId,
+                });
             }
             else {
                 const activation = {
@@ -1636,11 +1688,28 @@ class AgentInboxService {
             return "dispatched";
         }
         catch (error) {
-            console.warn(`activation target dispatch failed for ${target.targetId}:`, error);
             const message = error instanceof Error ? error.message : String(error);
+            this.logger.warn("activation.dispatch_failed", {
+                agentId: input.agentId,
+                targetId: target.targetId,
+                targetKind: target.kind,
+                error,
+                message,
+            });
             if (target.kind === "terminal") {
                 const exists = await this.terminalDispatcher.probe(target);
+                this.logger.debug("activation.terminal_probe_after_failure", {
+                    agentId: input.agentId,
+                    targetId: target.targetId,
+                    exists,
+                });
                 if (!exists) {
+                    this.logger.info("activation.target_offline", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        reason: message,
+                        transition: "dispatch_probe",
+                    });
                     this.markActivationTargetOffline(target.targetId, message);
                     this.reconcileAgentStatus(target.agentId);
                     return "offline";

package/dist/src/source_resolution.js

@@ -4,7 +4,7 @@ exports.resolveSourceIdentity = resolveSourceIdentity;
 exports.resolveSourceSchema = resolveSourceSchema;
 exports.withResolvedIdentity = withResolvedIdentity;
 const paths_1 = require("./paths");
-const remote_profiles_1 = require("./sources/remote_profiles");
+const remote_modules_1 = require("./sources/remote_modules");
 const source_schema_1 = require("./source_schema");
 async function resolveSourceIdentity(source, context = {}) {
     if (source.sourceType === "local_event") {
@@ -14,7 +14,7 @@ async function resolveSourceIdentity(source, context = {}) {
             implementationId: "builtin.local_event",
         };
     }
-    const builtinImplementationId = (0, remote_profiles_1.builtInProfileIdForSourceType)(source.sourceType);
+    const builtinImplementationId = (0, remote_modules_1.builtInModuleIdForSourceType)(source.sourceType);
     if (builtinImplementationId) {
         return {
             hostType: "remote_source",
@@ -25,30 +25,30 @@ async function resolveSourceIdentity(source, context = {}) {
     if (source.sourceType !== "remote_source") {
         throw new Error(`unsupported source type for source resolution: ${source.sourceType}`);
     }
-    const profileRegistry = context.profileRegistry ?? new remote_profiles_1.RemoteSourceProfileRegistry();
+    const moduleRegistry = context.moduleRegistry ?? context.profileRegistry ?? new remote_modules_1.RemoteSourceModuleRegistry();
     const homeDir = context.homeDir ?? (0, paths_1.resolveAgentInboxHome)(process.env);
-    const profile = await profileRegistry.resolve(source, homeDir);
-    const capabilityDescription = typeof profile.describeCapabilities === "function"
-        ? profile.describeCapabilities(profileInputSource(source))
+    const module = await moduleRegistry.resolve(source, homeDir);
+    const capabilityDescription = typeof module.describeCapabilities === "function"
+        ? module.describeCapabilities(moduleInputSource(source))
         : undefined;
     return {
         hostType: "remote_source",
-        sourceKind: capabilityDescription?.sourceKind?.trim() || `remote:${profile.id}`,
-        implementationId: profile.id,
+        sourceKind: capabilityDescription?.sourceKind?.trim() || `remote:${module.id}`,
+        implementationId: module.id,
     };
 }
 async function resolveSourceSchema(source, context = {}) {
-    const profileRegistry = context.profileRegistry ?? new remote_profiles_1.RemoteSourceProfileRegistry();
+    const moduleRegistry = context.moduleRegistry ?? context.profileRegistry ?? new remote_modules_1.RemoteSourceModuleRegistry();
     const homeDir = context.homeDir ?? (0, paths_1.resolveAgentInboxHome)(process.env);
-    const resolvedContext = { ...context, profileRegistry, homeDir };
+    const resolvedContext = { ...context, moduleRegistry, homeDir };
     const identity = await resolveSourceIdentity(source, resolvedContext);
     const staticSchema = (0, source_schema_1.getSourceSchema)(source.sourceType);
     let capabilityDescription;
-    let profile = null;
+    let module = null;
     if (identity.hostType === "remote_source") {
-        profile = await profileRegistry.resolve(source, homeDir);
-        capabilityDescription = typeof profile.describeCapabilities === "function"
-            ? profile.describeCapabilities(profileInputSource(source))
+        module = await moduleRegistry.resolve(source, homeDir);
+        capabilityDescription = typeof module.describeCapabilities === "function"
+            ? module.describeCapabilities(moduleInputSource(source))
             : undefined;
     }
     return withResolvedIdentity(source.sourceId, {
@@ -60,10 +60,10 @@ async function resolveSourceSchema(source, context = {}) {
     }, identity, identity.hostType === "remote_source"
         ? {
             aliases: capabilityDescription?.aliases,
-            supportsTrackedResourceRef: typeof profile?.deriveTrackedResource === "function",
-            supportsLifecycleSignals: typeof profile?.projectLifecycleSignal === "function",
-            shortcuts: typeof profile?.listSubscriptionShortcuts === "function"
-                ? profile.listSubscriptionShortcuts(profileInputSource(source))
+            supportsTrackedResourceRef: typeof module?.deriveTrackedResource === "function",
+            supportsLifecycleSignals: typeof module?.projectLifecycleSignal === "function",
+            shortcuts: typeof module?.listSubscriptionShortcuts === "function"
+                ? module.listSubscriptionShortcuts(moduleInputSource(source))
                 : [],
         }
         : undefined);
@@ -89,12 +89,12 @@ function withResolvedIdentity(sourceId, schema, identity, capabilityMetadata) {
         } : {}),
     };
 }
-function profileInputSource(source) {
+function moduleInputSource(source) {
     if (source.sourceType !== "remote_source") {
         return source;
     }
     return {
         ...source,
-        config: (0, remote_profiles_1.profileConfigForSource)(source),
+        config: (0, remote_modules_1.moduleConfigForSource)(source),
     };
 }

package/dist/src/source_schema.js

@@ -21,8 +21,8 @@ const SOURCE_SCHEMAS = {
         payloadExamples: [],
         eventVariantExamples: [],
         configFields: [
-            { name: "profilePath", type: "string", required: true, description: "Local profile module path under $AGENTINBOX_HOME/source-profiles." },
-            { name: "profileConfig", type: "object", required: false, description: "Profile-specific configuration passed to validate/spec/map hooks." },
+            { name: "profilePath", type: "string", required: true, description: "Local module path under $AGENTINBOX_HOME/source-profiles." },
+            { name: "profileConfig", type: "object", required: false, description: "Module-specific configuration passed to validate/spec/map hooks." },
         ],
     },
     github_repo: {

package/dist/src/sources/remote.js

@@ -4,7 +4,7 @@ exports.RemoteSourceRuntime = exports.RpcUxcRemoteSourceClient = void 0;
 const uxc_daemon_client_1 = require("@holon-run/uxc-daemon-client");
 const paths_1 = require("../paths");
 const util_1 = require("../util");
-const remote_profiles_1 = require("./remote_profiles");
+const remote_modules_1 = require("./remote_modules");
 const REMOTE_SOURCE_TYPES = new Set([
     "remote_source",
     "github_repo",
@@ -55,7 +55,7 @@ exports.RpcUxcRemoteSourceClient = RpcUxcRemoteSourceClient;
 class RemoteSourceRuntime {
     store;
     appendSourceEvent;
-    profileRegistry;
+    moduleRegistry;
     client;
     interval = null;
     inFlight = new Set();
@@ -65,7 +65,7 @@ class RemoteSourceRuntime {
     constructor(store, appendSourceEvent, options) {
         this.store = store;
         this.appendSourceEvent = appendSourceEvent;
-        this.profileRegistry = options?.profileRegistry ?? new remote_profiles_1.RemoteSourceProfileRegistry();
+        this.moduleRegistry = options?.moduleRegistry ?? options?.profileRegistry ?? new remote_modules_1.RemoteSourceModuleRegistry();
         this.client = options?.client ?? new RpcUxcRemoteSourceClient();
         this.homeDir = options?.homeDir ?? (0, paths_1.resolveAgentInboxHome)(process.env);
     }
@@ -79,10 +79,10 @@ class RemoteSourceRuntime {
         if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
             return;
         }
-        const profile = await this.profileRegistry.resolve(source, this.homeDir);
-        const profileSource = profileInputSource(source);
-        profile.validateConfig(profileSource);
-        profile.buildManagedSourceSpec(profileSource);
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        const moduleSource = moduleInputSource(source);
+        module.validateConfig(moduleSource);
+        module.buildManagedSourceSpec(moduleSource);
     }
     async start() {
         if (this.interval) {
@@ -171,26 +171,36 @@ class RemoteSourceRuntime {
         if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
             return null;
         }
-        const profile = await this.profileRegistry.resolve(source, this.homeDir);
-        if (typeof profile.projectLifecycleSignal !== "function") {
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        if (typeof module.projectLifecycleSignal !== "function") {
             return null;
         }
-        return profile.projectLifecycleSignal(rawPayload, profileInputSource(source));
+        return module.projectLifecycleSignal(rawPayload, moduleInputSource(source));
     }
     async expandSubscriptionShortcut(source, input) {
         if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
             return null;
         }
-        const profile = await this.profileRegistry.resolve(source, this.homeDir);
-        if (typeof profile.expandSubscriptionShortcut !== "function") {
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        if (typeof module.expandSubscriptionShortcut !== "function") {
             return null;
         }
-        return profile.expandSubscriptionShortcut({
+        return module.expandSubscriptionShortcut({
             name: input.name,
             args: input.args,
-            source: profileInputSource(source),
+            source: moduleInputSource(source),
         });
     }
+    async deriveInlinePreview(source, item) {
+        if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
+            return null;
+        }
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        if (typeof module.deriveInlinePreview !== "function") {
+            return null;
+        }
+        return module.deriveInlinePreview(item, moduleInputSource(source));
+    }
     async syncAll() {
         const sources = this.store
             .listSources()
@@ -245,10 +255,10 @@ class RemoteSourceRuntime {
                     };
                 }
             }
-            const profile = await this.profileRegistry.resolve(source, this.homeDir);
-            const profileSource = profileInputSource(source);
-            profile.validateConfig(profileSource);
-            const spec = profile.buildManagedSourceSpec(profileSource);
+            const module = await this.moduleRegistry.resolve(source, this.homeDir);
+            const moduleSource = moduleInputSource(source);
+            module.validateConfig(moduleSource);
+            const spec = module.buildManagedSourceSpec(moduleSource);
             const binding = managedBindingForSource(source);
             const ensured = await this.client.sourceEnsure({
                 namespace: binding.namespace,
@@ -269,7 +279,7 @@ class RemoteSourceRuntime {
                 if (Object.keys(rawPayload).length === 0) {
                     continue;
                 }
-                const mapped = profile.mapRawEvent(rawPayload, profileSource);
+                const mapped = module.mapRawEvent(rawPayload, moduleSource);
                 if (!mapped) {
                     continue;
                 }
@@ -338,7 +348,7 @@ class RemoteSourceRuntime {
     }
 }
 exports.RemoteSourceRuntime = RemoteSourceRuntime;
-function profileInputSource(source) {
+function moduleInputSource(source) {
     if (source.sourceType !== "remote_source") {
         return source;
     }