@holon-run/agentinbox 0.5.0 → 0.7.0

package/dist/src/sources/remote_profiles.js

@@ -1,387 +1,13 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteSourceProfileRegistry = void 0;
-exports.builtInProfileIdForSourceType = builtInProfileIdForSourceType;
-exports.profileConfigForSource = profileConfigForSource;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const node_url_1 = require("node:url");
-const github_1 = require("./github");
-const github_ci_1 = require("./github_ci");
-const feishu_1 = require("./feishu");
-const REMOTE_USER_PROFILE_ROOT_DIR = "source-profiles";
-const BUILTIN_PROFILE_IDS = new Set(["builtin.github_repo", "builtin.github_repo_ci", "builtin.feishu_bot"]);
-class RemoteSourceProfileRegistry {
-    profileCache = new Map();
-    resolve(source, homeDir) {
-        if (source.sourceType === "github_repo") {
-            return Promise.resolve(GITHUB_REPO_PROFILE);
-        }
-        if (source.sourceType === "github_repo_ci") {
-            return Promise.resolve(GITHUB_REPO_CI_PROFILE);
-        }
-        if (source.sourceType === "feishu_bot") {
-            return Promise.resolve(FEISHU_BOT_PROFILE);
-        }
-        if (source.sourceType !== "remote_source") {
-            throw new Error(`unsupported source type for remote profile: ${source.sourceType}`);
-        }
-        return this.loadUserProfile(source, homeDir);
-    }
-    async loadUserProfile(source, homeDir) {
-        const config = source.config ?? {};
-        const profilePath = asNonEmptyString(config.profilePath);
-        if (!profilePath) {
-            throw new Error("remote_source requires config.profilePath");
-        }
-        const profileRoot = node_path_1.default.resolve(homeDir, REMOTE_USER_PROFILE_ROOT_DIR);
-        const resolvedPath = resolveAndValidateProfilePath(profileRoot, profilePath);
-        const cacheKey = `${resolvedPath}:${source.sourceKey}`;
-        const cached = this.profileCache.get(cacheKey);
-        if (cached) {
-            return cached;
-        }
-        if (!node_fs_1.default.existsSync(resolvedPath)) {
-            throw new Error(`remote_source profile not found: ${resolvedPath}`);
-        }
-        const imported = await dynamicImportModule((0, node_url_1.pathToFileURL)(resolvedPath).href);
-        const profile = (imported.default ?? imported);
-        if (!profile || typeof profile !== "object") {
-            throw new Error(`remote_source profile must export default object: ${resolvedPath}`);
-        }
-        validateProfileContract(profile, resolvedPath);
-        this.profileCache.set(cacheKey, profile);
-        return profile;
-    }
+exports.profileConfigForSource = exports.builtInProfileIdForSourceType = exports.RemoteSourceProfileRegistry = exports.moduleConfigForSource = exports.builtInModuleIdForSourceType = exports.RemoteSourceModuleRegistry = void 0;
+var remote_modules_1 = require("./remote_modules");
+Object.defineProperty(exports, "RemoteSourceModuleRegistry", { enumerable: true, get: function () { return remote_modules_1.RemoteSourceModuleRegistry; } });
+Object.defineProperty(exports, "builtInModuleIdForSourceType", { enumerable: true, get: function () { return remote_modules_1.builtInModuleIdForSourceType; } });
+Object.defineProperty(exports, "moduleConfigForSource", { enumerable: true, get: function () { return remote_modules_1.moduleConfigForSource; } });
+const remote_modules_2 = require("./remote_modules");
+class RemoteSourceProfileRegistry extends remote_modules_2.RemoteSourceModuleRegistry {
 }
 exports.RemoteSourceProfileRegistry = RemoteSourceProfileRegistry;
-async function dynamicImportModule(moduleUrl) {
-    const importer = new Function("url", "return import(url);");
-    return importer(moduleUrl);
-}
-function builtInProfileIdForSourceType(sourceType) {
-    if (sourceType === "github_repo") {
-        return "builtin.github_repo";
-    }
-    if (sourceType === "github_repo_ci") {
-        return "builtin.github_repo_ci";
-    }
-    if (sourceType === "feishu_bot") {
-        return "builtin.feishu_bot";
-    }
-    return null;
-}
-function validateProfileContract(profile, sourcePath) {
-    if (!profile.id || typeof profile.id !== "string") {
-        throw new Error(`remote_source profile id must be a non-empty string: ${sourcePath}`);
-    }
-    if (BUILTIN_PROFILE_IDS.has(profile.id)) {
-        throw new Error(`remote_source profile id is reserved: ${profile.id}`);
-    }
-    if (typeof profile.validateConfig !== "function") {
-        throw new Error(`remote_source profile missing validateConfig(): ${sourcePath}`);
-    }
-    if (typeof profile.buildManagedSourceSpec !== "function") {
-        throw new Error(`remote_source profile missing buildManagedSourceSpec(): ${sourcePath}`);
-    }
-    if (typeof profile.mapRawEvent !== "function") {
-        throw new Error(`remote_source profile missing mapRawEvent(): ${sourcePath}`);
-    }
-    validateOptionalHook(profile.describeCapabilities, "describeCapabilities", sourcePath);
-    validateOptionalHook(profile.listSubscriptionShortcuts, "listSubscriptionShortcuts", sourcePath);
-    validateOptionalHook(profile.expandSubscriptionShortcut, "expandSubscriptionShortcut", sourcePath);
-    validateOptionalHook(profile.deriveTrackedResource, "deriveTrackedResource", sourcePath);
-    validateOptionalHook(profile.projectLifecycleSignal, "projectLifecycleSignal", sourcePath);
-}
-function validateOptionalHook(value, name, sourcePath) {
-    if (value !== undefined && typeof value !== "function") {
-        throw new Error(`remote_source profile ${name} must be a function when provided: ${sourcePath}`);
-    }
-}
-function resolveAndValidateProfilePath(profileRoot, profilePath) {
-    const resolved = node_path_1.default.isAbsolute(profilePath)
-        ? node_path_1.default.resolve(profilePath)
-        : node_path_1.default.resolve(profileRoot, profilePath);
-    const normalizedRoot = ensureTrailingSep(node_path_1.default.resolve(profileRoot));
-    const normalizedResolved = node_path_1.default.resolve(resolved);
-    if (!normalizedResolved.startsWith(normalizedRoot) && normalizedResolved !== node_path_1.default.resolve(profileRoot)) {
-        throw new Error(`remote_source profilePath must stay under ${profileRoot}`);
-    }
-    return normalizedResolved;
-}
-function ensureTrailingSep(input) {
-    return input.endsWith(node_path_1.default.sep) ? input : `${input}${node_path_1.default.sep}`;
-}
-function asRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return {};
-    }
-    return value;
-}
-function asNonEmptyString(value) {
-    if (typeof value !== "string") {
-        return null;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
-}
-const GITHUB_REPO_PROFILE = {
-    id: "builtin.github_repo",
-    describeCapabilities(source) {
-        const config = (0, github_1.parseGithubSourceConfig)(source);
-        return {
-            sourceKind: "github_repo",
-            aliases: ["github_repo"],
-            configSchema: [
-                { name: "owner", type: "string", required: true, description: "GitHub repository owner." },
-                { name: "repo", type: "string", required: true, description: "GitHub repository name." },
-                { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
-                { name: "eventTypes", type: "string[]", required: false, description: "Optional GitHub event type allowlist." },
-                { name: "perPage", type: "number", required: false, description: `Repository events requested per poll. Default ${config.perPage ?? 10}.` },
-                { name: "pollIntervalSecs", type: "number", required: false, description: `Polling interval in seconds. Default ${config.pollIntervalSecs ?? 30}.` },
-            ],
-            metadataFields: [
-                { name: "eventType", type: "string", description: "GitHub event type such as IssueCommentEvent." },
-                { name: "action", type: "string", description: "GitHub event action suffix such as created." },
-                { name: "author", type: "string|null", description: "Actor login for the event." },
-                { name: "isPullRequest", type: "boolean", description: "Whether the event targets a pull request surface." },
-                { name: "reviewState", type: "string|null", description: "Review decision state for PullRequestReviewEvent such as approved or changes_requested." },
-                { name: "labels", type: "string[]", description: "Labels extracted from the issue or pull request." },
-                { name: "mentions", type: "string[]", description: "Mention handles extracted from title/body/comment text." },
-                { name: "number", type: "number|null", description: "Issue or pull request number when present." },
-                { name: "repoFullName", type: "string", description: "Repository full name in owner/repo form." },
-                { name: "title", type: "string|null", description: "Issue, pull request, or comment title." },
-                { name: "body", type: "string|null", description: "Issue, pull request, or comment body text." },
-                { name: "url", type: "string|null", description: "Primary GitHub HTML URL for the event target." },
-            ],
-            payloadExamples: [
-                {
-                    id: "1234567891",
-                    type: "PullRequestReviewEvent",
-                    action: "created",
-                    actor: "Copilot",
-                    pull_request: { number: 67, title: "feat: add remote module capability hooks" },
-                    review: { state: "commented", body: "review summary" },
-                },
-                {
-                    id: "1234567892",
-                    type: "PullRequestEvent",
-                    action: "closed",
-                    actor: "jolestar",
-                    pull_request: { number: 72, title: "feat: add cleanup policy lifecycle engine", merged: true },
-                },
-            ],
-            eventVariantExamples: [
-                "IssueCommentEvent.created",
-                "PullRequestEvent.opened",
-                "PullRequestEvent.closed",
-                "PullRequestReviewEvent.created",
-                "PullRequestReviewCommentEvent.created",
-            ],
-        };
-    },
-    listSubscriptionShortcuts() {
-        return (0, github_1.githubSubscriptionShortcutSpec)();
-    },
-    expandSubscriptionShortcut(input) {
-        return (0, github_1.expandGithubSubscriptionShortcut)(input);
-    },
-    deriveTrackedResource(filter) {
-        return (0, github_1.deriveGithubTrackedResource)(filter);
-    },
-    projectLifecycleSignal(rawPayload) {
-        return (0, github_1.projectGithubLifecycleSignal)(rawPayload);
-    },
-    validateConfig(source) {
-        (0, github_1.parseGithubSourceConfig)(source);
-    },
-    buildManagedSourceSpec(source) {
-        const config = (0, github_1.parseGithubSourceConfig)(source);
-        return {
-            endpoint: github_1.GITHUB_ENDPOINT,
-            operation_id: "get:/repos/{owner}/{repo}/events",
-            args: {
-                owner: config.owner,
-                repo: config.repo,
-                per_page: config.perPage ?? 10,
-            },
-            mode: "poll",
-            poll_config: {
-                interval_secs: config.pollIntervalSecs ?? 30,
-                extract_items_pointer: "",
-                checkpoint_strategy: {
-                    type: "item_key",
-                    item_key_pointer: "/id",
-                    seen_window: 1024,
-                },
-            },
-            options: { auth: config.uxcAuth },
-        };
-    },
-    mapRawEvent(rawPayload, source) {
-        const config = (0, github_1.parseGithubSourceConfig)(source);
-        const normalized = (0, github_1.normalizeGithubRepoEvent)(source, config, rawPayload);
-        if (!normalized) {
-            return null;
-        }
-        return {
-            sourceNativeId: normalized.sourceNativeId,
-            eventVariant: normalized.eventVariant,
-            metadata: normalized.metadata ?? {},
-            rawPayload: normalized.rawPayload ?? rawPayload,
-            occurredAt: normalized.occurredAt,
-            deliveryHandle: normalized.deliveryHandle,
-        };
-    },
-};
-const GITHUB_REPO_CI_PROFILE = {
-    id: "builtin.github_repo_ci",
-    describeCapabilities() {
-        return {
-            sourceKind: "github_repo_ci",
-            aliases: ["github_repo_ci"],
-            configSchema: [
-                { name: "owner", type: "string", required: true, description: "GitHub repository owner." },
-                { name: "repo", type: "string", required: true, description: "GitHub repository name." },
-                { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
-                { name: "pollIntervalSecs", type: "number", required: false, description: "Polling interval in seconds." },
-                { name: "perPage", type: "number", required: false, description: "Workflow runs requested per poll." },
-                { name: "eventFilter", type: "string", required: false, description: "Optional GitHub workflow event filter." },
-                { name: "branch", type: "string", required: false, description: "Optional branch filter for workflow runs." },
-                { name: "statusFilter", type: "string", required: false, description: "Optional workflow status filter." },
-            ],
-            metadataFields: [
-                { name: "name", type: "string|null", description: "Workflow run name." },
-                { name: "status", type: "string", description: "Normalized workflow run status." },
-                { name: "conclusion", type: "string|null", description: "Workflow run conclusion when completed." },
-                { name: "event", type: "string|null", description: "GitHub trigger event for the workflow run." },
-                { name: "headBranch", type: "string|null", description: "Head branch for the workflow run." },
-                { name: "headSha", type: "string|null", description: "Head commit SHA for the workflow run." },
-                { name: "actor", type: "string|null", description: "Actor login for the workflow run." },
-                { name: "commitMessage", type: "string|null", description: "Head commit message when present." },
-                { name: "htmlUrl", type: "string|null", description: "GitHub Actions run URL." },
-            ],
-            eventVariantExamples: ["workflow_run.ci.completed.failure", "workflow_run.nightly_checks.observed"],
-        };
-    },
-    validateConfig(source) {
-        (0, github_ci_1.parseGithubCiSourceConfig)(source);
-    },
-    buildManagedSourceSpec(source) {
-        const config = (0, github_ci_1.parseGithubCiSourceConfig)(source);
-        const args = {
-            owner: config.owner,
-            repo: config.repo,
-            per_page: config.perPage ?? github_ci_1.DEFAULT_GITHUB_CI_PER_PAGE,
-        };
-        if (config.eventFilter) {
-            args.event = config.eventFilter;
-        }
-        if (config.branch) {
-            args.branch = config.branch;
-        }
-        if (config.statusFilter) {
-            args.status = config.statusFilter;
-        }
-        return {
-            endpoint: github_ci_1.GITHUB_CI_ENDPOINT,
-            operation_id: "get:/repos/{owner}/{repo}/actions/runs",
-            args,
-            mode: "poll",
-            poll_config: {
-                interval_secs: config.pollIntervalSecs ?? github_ci_1.DEFAULT_GITHUB_CI_POLL_INTERVAL_SECS,
-                extract_items_pointer: "/workflow_runs",
-                checkpoint_strategy: {
-                    type: "content_hash",
-                    seen_window: 1024,
-                },
-            },
-            options: { auth: config.uxcAuth },
-        };
-    },
-    mapRawEvent(rawPayload, source) {
-        const config = (0, github_ci_1.parseGithubCiSourceConfig)(source);
-        const normalized = (0, github_ci_1.normalizeGithubWorkflowRunEvent)(source, config, rawPayload);
-        if (!normalized) {
-            return null;
-        }
-        return {
-            sourceNativeId: normalized.sourceNativeId,
-            eventVariant: normalized.eventVariant,
-            metadata: normalized.metadata ?? {},
-            rawPayload: normalized.rawPayload ?? rawPayload,
-            occurredAt: normalized.occurredAt,
-            deliveryHandle: normalized.deliveryHandle,
-        };
-    },
-};
-const FEISHU_BOT_PROFILE = {
-    id: "builtin.feishu_bot",
-    describeCapabilities() {
-        return {
-            sourceKind: "feishu_bot",
-            aliases: ["feishu_bot"],
-            configSchema: [
-                { name: "appId", type: "string", required: true, description: "Feishu app ID." },
-                { name: "appSecret", type: "string", required: true, description: "Feishu app secret." },
-                { name: "eventTypes", type: "string[]", required: false, description: "Optional Feishu event type allowlist." },
-                { name: "chatIds", type: "string[]", required: false, description: "Optional Feishu chat allowlist." },
-                { name: "schemaUrl", type: "string", required: false, description: "Optional Feishu OpenAPI schema URL." },
-                { name: "replyInThread", type: "boolean", required: false, description: "Reply in thread when sending outbound messages." },
-                { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
-            ],
-            metadataFields: [
-                { name: "eventType", type: "string", description: "Feishu event type." },
-                { name: "chatId", type: "string", description: "Target chat ID." },
-                { name: "chatType", type: "string|null", description: "Feishu chat type." },
-                { name: "messageId", type: "string", description: "Feishu message ID." },
-                { name: "messageType", type: "string", description: "Feishu message type such as text." },
-                { name: "senderOpenId", type: "string|null", description: "Sender open_id when present." },
-                { name: "senderType", type: "string|null", description: "Sender type." },
-                { name: "mentions", type: "string[]", description: "Mention names extracted from the message." },
-                { name: "mentionOpenIds", type: "string[]", description: "Mention open_ids extracted from the message." },
-                { name: "content", type: "string|null", description: "Normalized message content string." },
-                { name: "threadId", type: "string|null", description: "Thread or root message ID when present." },
-                { name: "parentId", type: "string|null", description: "Parent message ID when present." },
-            ],
-            eventVariantExamples: ["im.message.receive_v1.text"],
-        };
-    },
-    validateConfig(source) {
-        (0, feishu_1.parseFeishuSourceConfig)(source);
-    },
-    buildManagedSourceSpec(source) {
-        const config = (0, feishu_1.parseFeishuSourceConfig)(source);
-        return {
-            endpoint: config.endpoint ?? feishu_1.FEISHU_OPENAPI_ENDPOINT,
-            mode: "stream",
-            transport_hint: "feishu_long_connection",
-            options: { auth: config.uxcAuth },
-        };
-    },
-    mapRawEvent(rawPayload, source) {
-        const config = (0, feishu_1.parseFeishuSourceConfig)(source);
-        const normalized = (0, feishu_1.normalizeFeishuBotEvent)(source, config, rawPayload);
-        if (!normalized) {
-            return null;
-        }
-        return {
-            sourceNativeId: normalized.sourceNativeId,
-            eventVariant: normalized.eventVariant,
-            metadata: normalized.metadata ?? {},
-            rawPayload: normalized.rawPayload ?? rawPayload,
-            occurredAt: normalized.occurredAt,
-            deliveryHandle: normalized.deliveryHandle,
-        };
-    },
-};
-function profileConfigForSource(source) {
-    const config = asRecord(source.config);
-    if (source.sourceType === "remote_source") {
-        return asRecord(config.profileConfig);
-    }
-    return config;
-}
+exports.builtInProfileIdForSourceType = remote_modules_2.builtInModuleIdForSourceType;
+exports.profileConfigForSource = remote_modules_2.moduleConfigForSource;

package/dist/src/store.js

@@ -780,6 +780,12 @@ class AgentInboxStore {
         ]);
         const inserted = this.changes() > before;
         if (inserted) {
+            const rowId = this.lastInsertRowId();
+            this.db.run(`
+        update inbox_items
+        set inbox_sequence = ?
+        where rowid = ? and inbox_sequence is null
+      `, [rowId, rowId]);
             this.persist();
         }
         return inserted;
@@ -792,14 +798,14 @@ class AgentInboxStore {
             filters.push("acked_at is null");
         }
         if (options?.afterItemId) {
-            const anchor = this.getOne("select occurred_at, item_id from inbox_items where inbox_id = ? and item_id = ?", [inboxId, options.afterItemId]);
+            const anchor = this.getOne("select coalesce(inbox_sequence, rowid) as inbox_sequence from inbox_items where inbox_id = ? and item_id = ?", [inboxId, options.afterItemId]);
             if (!anchor) {
                 throw new Error(`unknown inbox item: ${options.afterItemId}`);
             }
-            filters.push("((occurred_at > ?) or (occurred_at = ? and item_id > ?))");
-            params.push(String(anchor.occurred_at), String(anchor.occurred_at), String(anchor.item_id));
+            filters.push("coalesce(inbox_sequence, rowid) > ?");
+            params.push(Number(anchor.inbox_sequence));
         }
-        const rows = this.getAll(`select * from inbox_items where ${filters.join(" and ")} order by occurred_at asc, item_id asc`, params);
+        const rows = this.getAll(`select * from inbox_items where ${filters.join(" and ")} order by coalesce(inbox_sequence, rowid) asc`, params);
         return rows.map((row) => this.mapInboxItem(row));
     }
     ackItems(inboxId, itemIds, ackedAt) {
@@ -818,7 +824,7 @@ class AgentInboxStore {
         return changes;
     }
     ackItemsThrough(inboxId, itemId, ackedAt) {
-        const anchor = this.getOne("select occurred_at, item_id from inbox_items where inbox_id = ? and item_id = ?", [inboxId, itemId]);
+        const anchor = this.getOne("select coalesce(inbox_sequence, rowid) as inbox_sequence from inbox_items where inbox_id = ? and item_id = ?", [inboxId, itemId]);
         if (!anchor) {
             throw new Error(`unknown inbox item: ${itemId}`);
         }
@@ -827,8 +833,8 @@ class AgentInboxStore {
       set acked_at = ?
       where inbox_id = ?
         and acked_at is null
-        and ((occurred_at < ?) or (occurred_at = ? and item_id <= ?))
-    `, [ackedAt, inboxId, String(anchor.occurred_at), String(anchor.occurred_at), String(anchor.item_id)]);
+        and coalesce(inbox_sequence, rowid) <= ?
+    `, [ackedAt, inboxId, Number(anchor.inbox_sequence)]);
         const changes = this.changes();
         if (changes > 0) {
             this.persist();

package/dist/src/terminal.js

@@ -7,6 +7,7 @@ exports.TerminalDispatcher = void 0;
 exports.detectTerminalContext = detectTerminalContext;
 exports.renderAgentPrompt = renderAgentPrompt;
 exports.deriveInlineItemPreview = deriveInlineItemPreview;
+exports.normalizeInlinePreviewText = normalizeInlinePreviewText;
 exports.assignedAgentIdFromContext = assignedAgentIdFromContext;
 const node_child_process_1 = require("node:child_process");
 const node_util_1 = require("node:util");
@@ -78,13 +79,16 @@ function deriveInlineItemPreview(item, summary) {
         candidates.push(summary);
     }
     for (const candidate of candidates) {
-        const preview = normalizeInlinePreview(candidate);
+        const preview = normalizeInlinePreviewText(candidate);
         if (preview) {
             return preview;
         }
     }
     return null;
 }
+function normalizeInlinePreviewText(candidate) {
+    return normalizeInlinePreview(candidate);
+}
 function assignedAgentIdFromContext(input) {
     const primary = normalizeOptionalString(input.runtimeSessionId)
         ?? normalizeOptionalString(input.tmuxPaneId)

package/drizzle/migrations/0008_inbox_item_sequence.sql

@@ -0,0 +1,21 @@
+alter table inbox_items add column inbox_sequence integer;
+
+update inbox_items
+set inbox_sequence = rowid
+where inbox_sequence is null;
+
+create unique index if not exists idx_inbox_items_inbox_sequence
+  on inbox_items(inbox_sequence);
+
+create index if not exists idx_inbox_items_inbox_sequence_order
+  on inbox_items(inbox_id, inbox_sequence);
+
+create trigger if not exists trg_inbox_items_set_sequence_after_insert
+after insert on inbox_items
+for each row
+when new.inbox_sequence is null
+begin
+  update inbox_items
+  set inbox_sequence = new.rowid
+  where rowid = new.rowid;
+end;

package/drizzle/schema.ts

@@ -139,6 +139,7 @@ export const inboxItems = sqliteTable("inbox_items", {
   sourceNativeId: text("source_native_id").notNull(),
   eventVariant: text("event_variant").notNull(),
   inboxId: text("inbox_id").notNull(),
+  inboxSequence: integer("inbox_sequence"),
   occurredAt: text("occurred_at").notNull(),
   metadataJson: text("metadata_json").notNull(),
   rawPayloadJson: text("raw_payload_json").notNull(),
@@ -147,8 +148,10 @@ export const inboxItems = sqliteTable("inbox_items", {
 }, (table) => ({
   sourceNativeEventInboxUnique: uniqueIndex("idx_inbox_items_source_native_event_inbox")
     .on(table.sourceId, table.sourceNativeId, table.eventVariant, table.inboxId),
+  inboxSequenceUnique: uniqueIndex("idx_inbox_items_inbox_sequence").on(table.inboxSequence),
   ackedAtIdx: index("idx_inbox_items_acked_at").on(table.ackedAt),
   inboxAckedAtIdx: index("idx_inbox_items_inbox_acked_at").on(table.inboxId, table.ackedAt),
+  inboxSequenceIdx: index("idx_inbox_items_inbox_sequence_order").on(table.inboxId, table.inboxSequence),
   sourceOccurredAtIdx: index("idx_inbox_items_source_occurred_at").on(table.sourceId, table.occurredAt),
 }));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {
@@ -19,6 +19,7 @@
   },
   "files": [
     "dist/src/",
+    "scripts/",
     "drizzle/",
     "README.md",
     "LICENSE"

package/scripts/iterm2_cursor_probe.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""
+iTerm2 Python API cursor probe for AgentInbox.
+Returns session state including cursor position and buffer contents.
+"""
+
+import sys
+import json
+import asyncio
+
+# Keep this value in sync with the TypeScript probe normalization constant
+# `NORMALIZED_BUFFER_TAIL_LINES`, since both are intended to mirror the same
+# CLI/probe tail window.
+CAPTURE_TAIL_LINES = 20
+
+
+def probe_session(connection, session_id):
+    """Probe iTerm2 session state and return cursor position with buffer contents."""
+    try:
+        import iterm2
+
+        async def get_session_state():
+            try:
+                app = await iterm2.async_get_app(connection)
+                session = app.get_session_by_id(session_id)
+
+                if not session:
+                    return {"status": "gone"}
+
+                screen = await session.async_get_screen_contents()
+                cursor = screen.cursor_coord
+
+                # Capture a tail comparable to the CLI probe window.
+                lines = []
+                start_line = max(0, screen.number_of_lines - CAPTURE_TAIL_LINES)
+                for i in range(start_line, screen.number_of_lines):
+                    try:
+                        line = screen.line(i)
+                        line_str = line.string if hasattr(line, 'string') else str(line)
+                        lines.append(line_str)
+                    except Exception:
+                        break
+
+                return {
+                    "status": "available",
+                    "cursor": {"x": cursor.x, "y": cursor.y},
+                    "screen_height": screen.number_of_lines,
+                    "start_line": start_line,
+                    "lines": lines
+                }
+            except Exception as e:
+                return {"status": "error", "error": str(e)}
+
+        return get_session_state()
+
+    except ImportError:
+        return {"status": "error", "error": "iterm2 module not installed"}
+
+
+def main():
+    if len(sys.argv) < 2:
+        result = {"status": "error", "error": "missing session_id argument"}
+        print(json.dumps(result))
+        sys.exit(1)
+
+    session_id = sys.argv[1]
+
+    # Try to import iterm2 and run the probe
+    try:
+        import iterm2
+        result = iterm2.run_until_complete(probe_session, session_id)
+        print(json.dumps(result))
+
+        # Exit with error code if status is not "available" or "gone"
+        if result.get("status") not in ["available", "gone"]:
+            sys.exit(1)
+        else:
+            sys.exit(0)
+
+    except ImportError:
+        result = {"status": "error", "error": "iterm2 module not installed"}
+        print(json.dumps(result))
+        sys.exit(1)
+    except Exception as e:
+        result = {"status": "error", "error": str(e)}
+        print(json.dumps(result))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()