@oomol-lab/open-flow 0.1.0-beta.4 → 0.1.0-beta.40

package/dist/common/providerAccess.d.ts

@@ -0,0 +1,20 @@
+export type ProviderAccessSource = {
+    readonly kind: 'admin-delegation';
+} | {
+    readonly kind: 'policy';
+    readonly ruleId: string | null;
+};
+export interface ProviderAccessIdentity {
+    readonly accessBindingId: string;
+    readonly connectionId: string;
+    readonly providerId: string;
+    readonly source: ProviderAccessSource;
+}
+export type ProviderAccessReference = ProviderAccessIdentity | {
+    readonly accessBindingId: string;
+    readonly providerId: string;
+    readonly connectionId: null;
+    readonly source: null;
+};
+export declare function parseProviderAccessSource(value: unknown): ProviderAccessSource;
+export declare function providerAccessBindingId(teamId: string, identity: Omit<ProviderAccessIdentity, 'accessBindingId'>): Promise<string>;

package/dist/common/ru-DrP4BRM5.js

@@ -0,0 +1,298 @@
+//#region src/trigger/providers/airtable/locales/ru.json
+var e = { "airtable.on_record_changed": {
+	displayName: "Создание или изменение записи",
+	description: "Периодически проверяет таблицу Airtable и срабатывает при создании или изменении записи, упорядочивая записи по полю времени.",
+	configInputs: {
+		baseId: "ID базы Airtable, которую нужно отслеживать.",
+		fields: "Поля, которые должны быть включены в каждую возвращаемую запись. Оставьте пустым, чтобы включить все поля.",
+		formula: "Формула Airtable, используемая для фильтрации записей. Оставьте пустым, чтобы включить все записи.",
+		maxRecordsPerPoll: "Максимальное количество записей, обрабатываемых за одно опрос.",
+		tableIdOrName: "ID или название таблицы Airtable, которую нужно отслеживать.",
+		triggerField: "Поле даты или времени, используемое для определения созданных или обновленных записей.",
+		view: "Вид Airtable, используемый для фильтрации и сортировки записей. Оставьте пустым, чтобы использовать настройку по умолчанию для таблицы."
+	},
+	outputs: { events: "Записи, созданные или обновленные с момента предыдущего опроса." }
+} }, t = { "feishu_app_bot.on_event": {
+	displayName: "Событие приложения",
+	description: "Получает выбранные события Feishu через общий источник.",
+	configInputs: {
+		sourceId: "Источник событий, который получает события для этого триггера.",
+		eventTypes: "Типы событий Feishu, запускающие выполнение.",
+		chatIds: "ID чатов, из которых будут получаться события. Оставьте пустым, чтобы получать события из всех доступных чатов источника.",
+		resource: "Необязательный документ, календарь или ресурс одобрения, на который можно подписаться."
+	},
+	outputs: {
+		event: "Тип события Feishu.",
+		deliveryId: "Уникальный идентификатор доставки этого события.",
+		appId: "ID приложения Feishu, получившего событие.",
+		tenantKey: "Ключ тенанта Feishu, который сгенерировал событие.",
+		occurredAt: "Время возникновения события, если оно передано Feishu.",
+		body: "Оригинальное тело события Feishu."
+	}
+} }, n = {
+	"github.on_repo_event": {
+		displayName: "Событие репозитория",
+		description: "Срабатывает при выбранных событиях webhook GitHub в репозитории.",
+		configInputs: {
+			events: "События вебхука GitHub, запускающие выполнение.",
+			insecureSsl: "Разрешить GitHub отправлять вебхуки без проверки SSL-сертификата.",
+			owner: "Владелец репозитория GitHub.",
+			repo: "Название репозитория GitHub."
+		},
+		outputs: {
+			body: "Оригинальное тело вебхука GitHub.",
+			deliveryId: "Уникальный идентификатор доставки вебхука GitHub.",
+			event: "Название события вебхука GitHub."
+		}
+	},
+	"github.watch_pull_request": {
+		displayName: "Наблюдение за пул-реквестом",
+		description: "Следит за одним пул-реквестом через уведомления и периодические проверки. Начинает с текущего состояния и сообщает о наблюдаемых изменениях, а не обо всех промежуточных переходах или событиях ревью.",
+		configInputs: {
+			owner: "Владелец репозитория GitHub.",
+			repo: "Название репозитория GitHub.",
+			number: "Номер pull‑request, который нужно отслеживать."
+		},
+		outputs: {
+			pullRequest: "Текущие данные pull‑request после обнаруженного изменения.",
+			version: "Стабильный идентификатор версии отслеживаемого pull‑request."
+		}
+	}
+}, r = { "gitlab.on_project_event": {
+	displayName: "Событие проекта",
+	description: "Срабатывает при выбранных событиях webhook GitLab в проекте.",
+	configInputs: {
+		events: "События проекта GitLab, запускающие выполнение.",
+		insecureSsl: "Разрешить GitLab отправлять вебхуки без проверки SSL-сертификата.",
+		project: "Числовой ID проекта или URL‑кодированный путь проекта.",
+		pushBranchFilter: "Ветка или шаблон для фильтрации событий push. Оставьте пустым, чтобы включить все ветки."
+	},
+	outputs: {
+		body: "Оригинальное тело вебхука GitLab.",
+		deliveryId: "Уникальный идентификатор, сгенерированный для этой доставки вебхука.",
+		event: "Нормализованное название события GitLab.",
+		gitlabEvent: "Оригинальное значение заголовка события GitLab."
+	}
+} }, i = { "gmail.on_message_received": {
+	displayName: "Новое письмо",
+	description: "Периодически проверяет почтовый ящик Gmail и срабатывает при получении нового письма.",
+	configInputs: {
+		includeDrafts: "Также запускать при получении черновиков.",
+		includeSpamAndTrash: "Также запускать при получении сообщений из папок «Спам» и «Корзина».",
+		labelNamesOrIds: "Запускать только для сообщений, имеющих все указанные метки, по названию или ID.",
+		maxMessagesPerPoll: "Максимальное количество сообщений, обрабатываемых за одно опрос.",
+		readStatus: "Запускать только для прочитанных, непрочитанных или обоих типов сообщений.",
+		search: "Поисковый запрос Gmail, которому должно соответствовать каждое сообщение.",
+		sender: "Запускать только для сообщений, отправленных с указанного адреса или имени."
+	},
+	outputs: { events: "Сообщения, полученные с момента предыдущего опроса." }
+} }, a = { "googlecalendar.on_event_changed": {
+	displayName: "Изменение события календаря",
+	description: "Периодически проверяет Google Calendar и срабатывает при создании, изменении или отмене события.",
+	configInputs: {
+		calendarId: "ID календаря Google, который нужно отслеживать.",
+		changes: "Изменения событий календаря, запускающие выполнение.",
+		matchTerm: "Текст, который должен присутствовать в суммарном описании, описании, месте проведения или участниках события. Оставьте пустым, чтобы отслеживать все события.",
+		maxEventsPerPoll: "Максимальное количество событий календаря, обрабатываемых за одно опрос."
+	},
+	outputs: { events: "События календаря, созданные, обновленные или отменённые с момента предыдущего опроса." }
+} }, o = {
+	"googledrive.changes_detected": {
+		displayName: "Обнаружение изменений",
+		description: "Использует канал Google Drive changes.watch и срабатывает, когда доступны изменения Диска.",
+		configInputs: {
+			driveId: "ID общего диска. Оставьте пустым, чтобы отслеживать подключённую учётную запись.",
+			includeCorpusRemovals: "Включать доступный файловый ресурс, когда элемент покидает область изменений.",
+			includeItemsFromAllDrives: "Включать элементы из «Моего диска» и общих дисков.",
+			includeRemoved: "Включать изменения, вызванные удалением или потерей доступа.",
+			pageSize: "Максимальное количество изменений, включаемых в один запуск Flow.",
+			restrictToMyDrive: "Ограничить изменения структурой «Моего диска»."
+		},
+		outputs: { events: "Изменения Google Drive, доступные на момент получения уведомления." }
+	},
+	"googledrive.watch_changes": {
+		displayName: "Наблюдение за изменениями",
+		description: "Отслеживает изменения Диска через уведомления и периодическое сканирование одного и того же потока изменений.",
+		configInputs: {
+			driveId: "ID общего диска. Оставьте пустым, чтобы отслеживать подключённую учётную запись.",
+			includeCorpusRemovals: "Включать доступный файловый ресурс, когда элемент покидает область изменений.",
+			includeItemsFromAllDrives: "Включать элементы из «Моего диска» и общих дисков.",
+			includeRemoved: "Включать изменения, вызванные удалением или потерей доступа.",
+			pageSize: "Максимальное количество изменений, включаемых в один запуск Flow.",
+			restrictToMyDrive: "Ограничить изменения структурой «Моего диска»."
+		},
+		outputs: { events: "Изменения Google Drive, обнаруженные через уведомления или периодические сканирования." }
+	},
+	"googledrive.on_file_change": {
+		displayName: "Изменение файла или папки внутри папки",
+		description: "Периодически проверяет одну папку Google Drive и срабатывает при создании или изменении файлов и папок непосредственно в ней.",
+		configInputs: {
+			changeType: "Запускать ли выполнение при создании или обновлении элементов.",
+			driveId: "ID общего диска. Оставьте пустым, чтобы использовать «Мой диск».",
+			folderId: "ID папки Google Drive, которую нужно отслеживать.",
+			itemTypes: "Отслеживать файлы, папки или оба типа.",
+			maxFilesPerPoll: "Максимальное количество изменённых элементов, обрабатываемых за одно опрос.",
+			mimeTypes: "Запускать только для этих MIME‑типов. Оставьте пустым, чтобы включить все MIME‑типы.",
+			namePrefix: "Запускать только для элементов, чьи названия начинаются с этого текста. Оставьте пустым, чтобы включать все названия."
+		},
+		outputs: { events: "Файлы или папки, созданные или обновленные с момента предыдущего опроса." }
+	}
+}, s = { "googlesheets.on_row_added": {
+	displayName: "Добавление строки",
+	description: "Периодически проверяет лист и срабатывает один раз для каждой новой строки, добавленной ниже последней ранее обнаруженной строки.",
+	configInputs: {
+		columnRange: "Диапазон столбцов A1 для чтения, например A:Z.",
+		dateTimeRender: "Как возвращаются значения даты и времени.",
+		firstDataRow: "Первая строка с данными, следующая за заголовком.",
+		headerRow: "Строка, ячейки которой становятся названиями полей вывода.",
+		maxRowsPerPoll: "Максимальное количество новых строк, обрабатываемых за одно опрос.",
+		sheet: "Название рабочего листа, который нужно отслеживать.",
+		spreadsheetId: "ID книги Google Sheets.",
+		valueRender: "Как возвращаются значения ячеек."
+	},
+	outputs: { events: "Строки, добавленные с момента предыдущего опроса." }
+} }, c = { "linear.on_issue_changed": {
+	displayName: "Создание или изменение задачи",
+	description: "Периодически проверяет новые и изменённые задачи команды Linear. Начинает с текущего момента, не запуская существующие задачи. Сообщает о наблюдаемых текущих состояниях, но не об удалениях или каждом промежуточном изменении статуса.",
+	configInputs: {
+		teamId: "UUID команды Linear. Используйте UUID модели «Копировать» в Linear, чтобы найти его.",
+		stateIds: "Статусы выбранной команды. Оставьте пустым, чтобы отслеживать все статусы. Соответствует текущему статусу, а не всем переходам в него."
+	},
+	outputs: { events: "Проблемы Linear, созданные или обновленные с момента предыдущего опроса." }
+} }, l = { "notion.on_database_page_event": {
+	displayName: "Добавление или изменение страницы базы данных",
+	description: "Периодически проверяет базу данных Notion и срабатывает при добавлении страницы или редактировании существующей.",
+	configInputs: {
+		dataSourceId: "ID источника данных внутри базы данных. Оставьте пустым, чтобы использовать основной источник.",
+		databaseId: "ID базы данных Notion, которую нужно отслеживать.",
+		events: "Изменения страниц, запускающие выполнение.",
+		includeProperties: "Включать свойства страницы в каждый выходной событие.",
+		maxItemsPerPoll: "Максимальное количество изменённых страниц, обрабатываемых за одно опрос."
+	},
+	outputs: { events: "Страницы базы данных, добавленные или обновленные с момента предыдущего опроса." }
+} }, u = { "one_drive.on_item_changed": {
+	displayName: "Изменение файла или папки",
+	description: "Периодически проверяет поток изменений OneDrive и срабатывает при создании, изменении или удалении файла или папки.",
+	configInputs: {
+		events: "Изменения элементов OneDrive, запускающие выполнение.",
+		itemId: "Отслеживать только этот файл или папку по ID. Оставьте пустым, чтобы отслеживать несколько элементов.",
+		itemTypes: "Отслеживать файлы, папки или оба типа.",
+		maxItemsPerPoll: "Максимальное количество изменённых элементов, обрабатываемых за одно опрос.",
+		parentFolderId: "Отслеживать только элементы в этой родительской папке. Оставьте пустым, чтобы отслеживать весь диск."
+	},
+	outputs: { events: "Элементы OneDrive, созданные, обновленные или удалённые с момента предыдущего опроса." }
+} }, d = { "outlook.on_message_received": {
+	displayName: "Новое письмо",
+	description: "Периодически проверяет почтовую папку Microsoft Outlook и срабатывает при поступлении нового письма.",
+	configInputs: {
+		folder: "Известное имя папки, ID папки или пустое значение для всей почтовой ящики.",
+		includeDrafts: "Также запускать при получении черновиков.",
+		maxMessagesPerPoll: "Максимальное количество сообщений, обрабатываемых за одно опрос.",
+		readStatus: "Запускать только для прочитанных, непрочитанных или обоих типов сообщений.",
+		senderAddress: "Точный адрес отправителя. Оставьте пустым, чтобы допустить любого отправителя.",
+		subjectContains: "Безразличный к регистру текст, который должен присутствовать в теме сообщения.",
+		withAttachmentsOnly: "Запускать только для сообщений с вложениями."
+	},
+	outputs: { events: "Сообщения Outlook, полученные с момента предыдущего опроса." }
+} }, f = { "shopify.on_shop_event": {
+	displayName: "Событие магазина",
+	description: "Срабатывает при событиях выбранных тем webhook Shopify в подключённом магазине.",
+	configInputs: { topics: "Темы вебхуков Shopify, запускающие выполнение." },
+	outputs: {
+		apiVersion: "Версия API Shopify, использованная для вебхука.",
+		body: "Оригинальное тело вебхука Shopify.",
+		eventId: "Уникальный ID события Shopify.",
+		shopDomain: "Домен магазина Shopify, который сгенерировал событие.",
+		topic: "Тема вебхука Shopify.",
+		triggeredAt: "Время, когда Shopify инициировал вебхук.",
+		webhookId: "ID подписки на вебхук Shopify."
+	}
+} }, p = { "slack.on_message_posted": {
+	displayName: "Новое сообщение канала",
+	description: "Периодически проверяет один разговор Slack и срабатывает при появлении нового сообщения.",
+	configInputs: {
+		channelId: "ID беседы Slack, которую нужно отслеживать, например C0122KQ70S7E.",
+		fromUserIds: "Запускать только для сообщений от этих пользователей Slack по ID. Оставьте пустым, чтобы допустить любого автора.",
+		ignoreUserIds: "Никогда не запускать для сообщений от этих пользователей Slack по ID.",
+		includeBotMessages: "Также запускать для сообщений, отправленных ботами и приложениями.",
+		includeSystemMessages: "Также запускать для системных уведомлений Slack.",
+		maxMessagesPerPoll: "Максимальное количество сообщений, обрабатываемых за одно опрос.",
+		textContains: "Запускать только при наличии этой строки в тексте сообщения, без учёта регистра."
+	},
+	outputs: { events: "Сообщения Slack, опубликованные с момента предыдущего опроса." }
+} }, m = { "stripe.on_event": {
+	displayName: "Событие аккаунта",
+	description: "Срабатывает при выбранных событиях Stripe в подключённом аккаунте.",
+	configInputs: {
+		apiVersion: "Версия API Stripe, используемая для событий вебхука. Оставьте пустым, чтобы использовать настройку по умолчанию для аккаунта.",
+		events: "Типы событий Stripe, запускающие выполнение.",
+		includeConnectedAccounts: "Также получать события от подключённых аккаунтов Stripe."
+	},
+	outputs: {
+		body: "Оригинальное тело события Stripe.",
+		event: "Тип события Stripe.",
+		eventId: "Уникальный ID события Stripe.",
+		livemode: "Было ли событие создано в режиме реальной работы (live mode)."
+	}
+} }, h = { "telegram.on_update": {
+	displayName: "Обновление бота",
+	description: "Срабатывает, когда подключённый бот Telegram получает выбранное обновление.",
+	configInputs: {
+		chatIds: "Принимать обновления только от этих числовых ID чатов Telegram. Оставьте пустым, чтобы допустить все чаты.",
+		dropPendingUpdates: "Отбросить обновления, находящиеся в очереди до создания или возобновления вебхука.",
+		updates: "Типы обновлений Telegram, запускающие выполнение. Используйте * для стандартного набора Telegram.",
+		userIds: "Принимать обновления только от этих числовых ID пользователей Telegram. Оставьте пустым, чтобы допустить всех пользователей."
+	},
+	outputs: {
+		body: "Оригинальное тело обновления Telegram.",
+		deliveryId: "Уникальный ID, сгенерированный для этого обновления Telegram.",
+		event: "Тип обновления Telegram."
+	}
+} }, g = { "woocommerce.on_store_event": {
+	displayName: "Событие магазина",
+	description: "Срабатывает при выбранных событиях магазина WooCommerce.",
+	configInputs: {
+		events: "События магазина WooCommerce, запускающие выполнение.",
+		webhookName: "Название, отображаемое для вебхука в WooCommerce."
+	},
+	outputs: {
+		body: "Оригинальное тело вебхука WooCommerce.",
+		deliveryId: "Уникальный ID доставки вебхука WooCommerce.",
+		event: "Действие события WooCommerce.",
+		resource: "Тип ресурса WooCommerce.",
+		source: "URL магазина WooCommerce, который сгенерировал событие.",
+		topic: "Полная тема вебхука WooCommerce.",
+		webhookId: "ID подписки на вебхук WooCommerce."
+	}
+} }, _ = { "zendesk.on_event": {
+	displayName: "Подписка на события",
+	description: "Срабатывает при любом из выбранных событий аккаунта Zendesk.",
+	configInputs: { events: "Типы событий Zendesk, запускающие выполнение." },
+	outputs: {
+		body: "Оригинальное тело события Zendesk.",
+		deliveryId: "Уникальный ID, сгенерированный для этой доставки события Zendesk.",
+		event: "Тип события Zendesk.",
+		subject: "Тема Zendesk, связанная со случаем."
+	}
+} }, v = {
+	...e,
+	...t,
+	...n,
+	...r,
+	...i,
+	...a,
+	...o,
+	...s,
+	...c,
+	...l,
+	...u,
+	...d,
+	...f,
+	...p,
+	...m,
+	...h,
+	...g,
+	..._
+};
+//#endregion
+export { v as default };

package/dist/common/run-events.d.ts

@@ -1,9 +1,9 @@
 export type ProjectedRunEvent = {
-    readonly kind: 'node.output';
+    readonly kind: 'node.completed';
     readonly payload: Readonly<Record<string, unknown>>;
     readonly value: unknown;
 } | {
-    readonly kind: 'node.artifact' | 'node.completed' | 'node.failed' | 'node.log' | 'node.progress' | 'node.started' | 'run.progress' | 'run.started';
+    readonly kind: 'node.artifact' | 'node.failed' | 'node.log' | 'node.progress' | 'node.started' | 'run.progress' | 'run.started';
     readonly payload: Readonly<Record<string, unknown>>;
 };
 export declare function createEventProjector(platformRunId: string, nodeFailureCodes: ReadonlySet<string>): (event: unknown) => Promise<ProjectedRunEvent | undefined>;

package/dist/common/run-events.js

@@ -1,5 +1,7 @@
 //#region src/execution/common/events.ts
 var e = new TextEncoder(), t = /* @__PURE__ */ new Set([
+	"agent",
+	"approval",
 	"condition",
 	"connector",
 	"javascript",
@@ -106,25 +108,22 @@ function f(e, t) {
 				}
 			});
 		}
-		if (_ == "node.cache-hit" || _ == "node.preview" || _ == "run.completed" || _ == "run.failed" || _ == "run.output") {
+		if (_ == "run.completed" || _ == "run.failed") {
 			o(g);
 			return;
 		}
-		if (_ == "node.started" || _ == "node.output" || _ == "node.progress" || _ == "node.artifact" || _ == "node.log" || _ == "node.completed" || _ == "node.failed") {
-			let n = s(g, f, e), o = await n.executionId, m = {
+		if (_ == "node.started" || _ == "node.progress" || _ == "node.artifact" || _ == "node.log" || _ == "node.completed" || _ == "node.failed") {
+			let r = s(g, f, e), o = await r.executionId, m = {
 				executionId: o,
-				flowId: n.flowId,
-				nodeId: n.nodeId,
-				scopeId: await c("scope", e, n.rawRunId)
+				flowId: r.flowId,
+				nodeId: r.nodeId,
+				scopeId: await c("scope", e, r.rawRunId)
 			};
 			switch (_) {
-				case "node.output": return {
+				case "node.completed": return {
 					kind: _,
-					payload: {
-						...m,
-						handle: r(g.handle, "Runtime node.output handle")
-					},
-					value: g.value
+					payload: m,
+					value: n(g.outputs, "Runtime node.completed outputs")
 				};
 				case "node.started": {
 					let e = a(g.nodeKind), t = i(g.nodeTitle, "Runtime node.started nodeTitle"), n = i(g.operation, "Runtime node.started operation");
@@ -170,10 +169,6 @@ function f(e, t) {
 							message: l(g.message)
 						}
 					};
-				case "node.completed": return {
-					kind: _,
-					payload: m
-				};
 				case "node.failed": return {
 					kind: _,
 					payload: {

package/dist/common/run-lifecycle.d.ts

@@ -10,6 +10,8 @@ export type RunOperation = {
     readonly kind: 'wait';
 } | {
     readonly kind: 'resolve';
+} | {
+    readonly kind: 'fail-start' | 'fail-resume';
 } | {
     readonly kind: 'commit';
     readonly status: RunTerminalStatus;
@@ -40,7 +42,7 @@ export type RunTransition = {
     readonly status: 'waiting';
 } | {
     readonly kind: 'resolved';
-    readonly status: 'queued';
+    readonly status: 'queued' | 'starting' | 'running';
 } | {
     readonly kind: 'stale';
     readonly status: RunStatus;
@@ -72,6 +74,8 @@ export interface RunLifecycleHarness {
     }): Promise<RunAcceptance>;
     claim(runId: string): Promise<RunClaim>;
     commit(runId: string, status: RunTerminalStatus): Promise<boolean>;
+    failStarting(runId: string): Promise<boolean>;
+    failResume(runId: string): Promise<boolean>;
     observe(runId: string): Promise<RunObservation>;
     resolve(runId: string): Promise<boolean>;
     start(runId: string): Promise<RunStart>;

package/dist/common/run-lifecycle.js

@@ -84,9 +84,17 @@ function a(e, t) {
 			kind: "stale",
 			status: e
 		};
-		case "resolve": return e == "waiting" ? {
+		case "resolve": return i(e) ? {
+			kind: "stale",
+			status: e
+		} : {
 			kind: "resolved",
-			status: "queued"
+			status: e == "waiting" ? "queued" : e
+		};
+		case "fail-start":
+		case "fail-resume": return e == "starting" ? {
+			kind: "committed",
+			status: t.kind == "fail-start" ? "failed" : "indeterminate"
 		} : {
 			kind: "stale",
 			status: e
@@ -94,7 +102,7 @@ function a(e, t) {
 		case "commit": return i(e) ? {
 			kind: "stale",
 			status: e
-		} : t.status == "canceled" || e == "running" || t.status == "failed" && e == "waiting" ? {
+		} : t.status == "canceled" || e == "running" || t.status == "failed" ? {
 			kind: "committed",
 			status: t.status
 		} : {
@@ -115,6 +123,28 @@ async function s(e, t = "request", n = "request-a") {
 	return r.runId;
 }
 var c = [
+	{
+		name: "rejects startup failures outside the start barrier and preserves their terminal",
+		async verify(e) {
+			for (let t of ["failStarting", "failResume"]) {
+				let n = await s(e, t);
+				o(await e[t](n), !1, "Failure before claim"), await e.claim(n), o(await e.commit(n, "completed"), !1, "Completion before start"), o(await e[t](n), !0, "Startup failure");
+				let r = t == "failStarting" ? "failed" : "indeterminate";
+				o(await e.observe(n), {
+					status: r,
+					terminalEvents: [r]
+				}, "Startup terminal"), o(await e[t](n), !1, "Repeated startup failure"), o(await e.start(n), {
+					kind: "stale",
+					status: r
+				}, "Start after failure"), o(await e.commit(n, "canceled"), !1, "Cancellation after failure");
+			}
+			let t = await s(e, "running");
+			await e.claim(t), await e.start(t), o(await e.failStarting(t), !1, "Startup failure after start"), o(await e.failResume(t), !1, "Resume failure after start"), o(await e.observe(t), {
+				status: "running",
+				terminalEvents: []
+			}, "Running observation");
+		}
+	},
 	{
 		name: "pauses and resumes the same Run through the ordinary start barrier",
 		async verify(e) {

package/dist/common/run-results.d.ts

@@ -0,0 +1,57 @@
+import type { JsonValue } from '../browser/flow-change.js';
+export type ResultCall = {
+    readonly id: string;
+    readonly kind: 'connector';
+    readonly action: string;
+    readonly connectionId?: string;
+} | {
+    readonly id: string;
+    readonly kind: 'code';
+};
+export interface ResultInfo {
+    readonly resultId: string;
+    readonly callId: string;
+    readonly toolId: string;
+    readonly source: {
+        readonly kind: 'connector';
+        readonly action: string;
+    } | {
+        readonly kind: 'code';
+    };
+    readonly bytes: number;
+    readonly digest: string;
+    readonly createdAt: string;
+}
+interface ResultEntry {
+    readonly pointer: string;
+    readonly type: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null';
+    readonly length?: number;
+    readonly complete: boolean;
+    readonly value?: JsonValue;
+}
+export interface ResultPage extends ResultEntry {
+    readonly offset: number;
+    readonly nextOffset?: number;
+    readonly entries?: readonly ResultEntry[];
+}
+export interface ResultQuery {
+    readonly pointer?: string;
+    readonly offset?: number;
+    readonly limit?: number;
+    readonly maxBytes?: number;
+}
+export declare function parseResultQuery(value: unknown): Required<ResultQuery>;
+export declare function decodeResultList(value: unknown): {
+    readonly version: 1;
+    readonly runId: string;
+    readonly results: readonly ResultInfo[];
+    readonly nextAfter?: string;
+};
+export declare function decodeResultRead(value: unknown): {
+    readonly version: 1;
+    readonly runId: string;
+    readonly result: ResultInfo;
+    readonly page: ResultPage;
+};
+export declare function readResult(value: JsonValue, query?: ResultQuery): ResultPage;
+export {};

package/dist/common/runtime-contract.d.ts

@@ -1,6 +1,9 @@
-import type { CodeModule, JsonValue } from '../browser/flow-change.js';
-export { currentEngineContract, findEngineContract, type EngineContract } from './engine-contract.js';
+import type { CodeModule, ConnectorCapability, JsonValue } from '../browser/flow-change.js';
+export { currentEngineContract, nodejsEngineContract, findEngineContract, type EngineContract } from './engine-contract.js';
 export type RuntimeModule = Pick<CodeModule, 'imports' | 'source'>;
+/** Snapshot a Task result before JSON transport can discard or coerce invalid values. */
+export declare function snapshotRuntimeResult(value: unknown): JsonValue | undefined;
+export declare const nodejsRuntimeConformanceCases: readonly RuntimeConformanceCase[];
 export interface RuntimeProgram {
     readonly engineContract: string;
     readonly engineDigest: string;
@@ -8,6 +11,7 @@ export interface RuntimeProgram {
     readonly modules: Readonly<Record<string, RuntimeModule>>;
 }
 export interface RuntimeCapabilityCall {
+    readonly callId: string;
     readonly invocationId: string;
     readonly kind: string;
     readonly payload: JsonValue;
@@ -35,7 +39,32 @@ export type LlmTaskResult = {
     readonly version: 1;
 };
 export type InvokeLlmTask = (invocation: LlmTaskInvocation) => Promise<LlmTaskResult>;
+export interface AgentCheckpoint {
+    readonly state: JsonValue;
+    readonly callId: string;
+    readonly toolId: string;
+    readonly input: Readonly<Record<string, JsonValue>>;
+    readonly rounds: number;
+    readonly version: 1;
+}
+export type AgentResult = {
+    readonly kind: 'completed';
+    readonly output: JsonValue;
+} | {
+    readonly kind: 'suspended';
+    readonly checkpoint: AgentCheckpoint;
+};
+export interface AgentInvocation {
+    readonly input: Readonly<Record<string, JsonValue>>;
+    readonly invocationId: string;
+    readonly signal: AbortSignal;
+    readonly resume?: {
+        readonly action: 'approve' | 'reject';
+        readonly checkpoint: AgentCheckpoint;
+    };
+}
 export interface RuntimeInvocation {
+    readonly capabilities?: readonly ConnectorCapability[];
     readonly capability: (call: RuntimeCapabilityCall) => Promise<RuntimeCapabilityResponse>;
     readonly input: JsonValue;
     readonly invocationId: string;
@@ -44,10 +73,16 @@ export interface RuntimeInvocation {
 }
 export interface RuntimeHarness {
     readonly engineDigest: string;
-    invoke(invocation: RuntimeInvocation): Promise<JsonValue>;
+    invoke(invocation: RuntimeInvocation): Promise<JsonValue | undefined>;
 }
 export interface RuntimeConformanceCase {
     readonly name: string;
     verify(harness: RuntimeHarness): Promise<void>;
 }
 export declare const runtimeConformanceCases: readonly RuntimeConformanceCase[];
+export declare function createActions(invoke: (payload: JsonValue) => Promise<RuntimeCapabilityResponse>): Readonly<Record<string, unknown>>;
+export declare function resolveAction(declarations: readonly ConnectorCapability[], payload: unknown): {
+    readonly action: string;
+    readonly connectionId?: string;
+    readonly input: Readonly<Record<string, JsonValue>>;
+};