@hyperdrive.bot/fleet-client 0.3.179 → 0.3.181

package/dist/daemon-client.d.ts

@@ -466,6 +466,12 @@ export type SourceTriggersPayload = Extract<SessionOutboundMessage, {
 export type SourceSubscribePayload = Extract<SessionOutboundMessage, {
     type: "source/subscribe/response";
 }>["payload"];
+export type SourceActionsPayload = Extract<SessionOutboundMessage, {
+    type: "source/actions/response";
+}>["payload"];
+export type SourceRunPayload = Extract<SessionOutboundMessage, {
+    type: "source/run/response";
+}>["payload"];
 export type SourceDisconnectPayload = Extract<SessionOutboundMessage, {
     type: "source/disconnect/response";
 }>["payload"];
@@ -478,6 +484,9 @@ export type SourceAccountsPayload = Extract<SessionOutboundMessage, {
 export type SourceAssignPayload = Extract<SessionOutboundMessage, {
     type: "source/assign/response";
 }>["payload"];
+export type SourceItemsPayload = Extract<SessionOutboundMessage, {
+    type: "source/items/response";
+}>["payload"];
 export type IngestionFilterListPayload = Extract<SessionOutboundMessage, {
     type: "ingestion/filter/list/response";
 }>["payload"];
@@ -696,6 +705,8 @@ export interface SourceCheckOptions {
 export interface SourceSubscribeOptions {
     sourceId: string;
     componentId?: string;
+    /** Values for the trigger's own props, by name (e.g. `{ drive: "My Drive" }`). */
+    props?: Record<string, unknown>;
     requestId?: string;
 }
 export interface SourceDisconnectOptions {
@@ -712,12 +723,32 @@ export interface SourceAccountsOptions {
     sourceId: string;
     requestId?: string;
 }
+export interface SourceActionsOptions {
+    sourceId: string;
+    requestId?: string;
+}
+export interface SourceRunOptions {
+    sourceId: string;
+    /** The action component id, as `source/actions` lists it (e.g. "gmail-send-email"). */
+    actionId: string;
+    /** The action's own input. The account is never part of it. */
+    props: Record<string, unknown>;
+    requestId?: string;
+}
 export interface SourceAssignOptions {
     sourceId: string;
     /** The aggregator account id, as `source/accounts` reports it. */
     accountId: string;
     requestId?: string;
 }
+export interface SourceItemsOptions {
+    sourceId: string;
+    /** Epoch ms, inclusive. Nothing older comes back. */
+    sinceMs: number;
+    /** Events read from each deployed trigger. Absent means the daemon's default. */
+    perTriggerLimit?: number;
+    requestId?: string;
+}
 export interface IngestionFilterListOptions {
     /** Absent means every filter on the daemon. */
     sourceId?: string;
@@ -1566,6 +1597,10 @@ export declare class DaemonClient {
         sourceId: string;
         requestId?: string;
     }): Promise<SourceTriggersPayload>;
+    /** The actions this source's app offers. Read-only. */
+    sourceActions(options: SourceActionsOptions): Promise<SourceActionsPayload>;
+    /** Run one action as the source's bound account. Not idempotent: never retry blindly. */
+    sourceRun(options: SourceRunOptions): Promise<SourceRunPayload>;
     sourceSubscribe(options: SourceSubscribeOptions): Promise<SourceSubscribePayload>;
     sourceDisconnect(options: SourceDisconnectOptions): Promise<SourceDisconnectPayload>;
     /** Give a source the user's own name, or clear it. Local only. */
@@ -1574,6 +1609,14 @@ export declare class DaemonClient {
     sourceAccounts(options: SourceAccountsOptions): Promise<SourceAccountsPayload>;
     /** Point a source at one of those accounts. A refusal comes back as `reason`. */
     sourceAssign(options: SourceAssignOptions): Promise<SourceAssignPayload>;
+    /**
+     * The recent items of one source, payloads included. Read-only: the daemon
+     * side creates, writes, arms and spawns nothing.
+     *
+     * A failed read resolves with `payload.error` set rather than rejecting, so a
+     * caller can tell an empty window from a read that never happened.
+     */
+    sourceItems(options: SourceItemsOptions): Promise<SourceItemsPayload>;
     loopRun(options: RunLoopOptions): Promise<LoopRunPayload>;
     loopList(requestId?: string): Promise<LoopListPayload>;
     loopInspect(options: string | InspectLoopOptions): Promise<LoopInspectPayload>;

package/dist/daemon-client.js

@@ -4387,6 +4387,27 @@ export class DaemonClient {
             responseType: "source/triggers/response",
         });
     }
+    /** The actions this source's app offers. Read-only. */
+    async sourceActions(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: { type: "source/actions", sourceId: options.sourceId },
+            responseType: "source/actions/response",
+        });
+    }
+    /** Run one action as the source's bound account. Not idempotent: never retry blindly. */
+    async sourceRun(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "source/run",
+                sourceId: options.sourceId,
+                actionId: options.actionId,
+                props: options.props,
+            },
+            responseType: "source/run/response",
+        });
+    }
     async sourceSubscribe(options) {
         return this.sendCorrelatedSessionRequest({
             requestId: options.requestId,
@@ -4394,6 +4415,7 @@ export class DaemonClient {
                 type: "source/subscribe",
                 sourceId: options.sourceId,
                 ...(options.componentId === undefined ? {} : { componentId: options.componentId }),
+                ...(options.props === undefined ? {} : { props: options.props }),
             },
             responseType: "source/subscribe/response",
         });
@@ -4440,6 +4462,27 @@ export class DaemonClient {
             responseType: "source/assign/response",
         });
     }
+    /**
+     * The recent items of one source, payloads included. Read-only: the daemon
+     * side creates, writes, arms and spawns nothing.
+     *
+     * A failed read resolves with `payload.error` set rather than rejecting, so a
+     * caller can tell an empty window from a read that never happened.
+     */
+    async sourceItems(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "source/items",
+                sourceId: options.sourceId,
+                sinceMs: options.sinceMs,
+                ...(options.perTriggerLimit === undefined
+                    ? {}
+                    : { perTriggerLimit: options.perTriggerLimit }),
+            },
+            responseType: "source/items/response",
+        });
+    }
     async loopRun(options) {
         return this.sendCorrelatedSessionRequest({
             requestId: options.requestId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/fleet-client",
-  "version": "0.3.179",
+  "version": "0.3.181",
   "description": "Paseo client SDK package",
   "license": "Apache-2.0",
   "files": [
@@ -36,8 +36,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@hyperdrive.bot/fleet-protocol": "0.3.179",
-    "@hyperdrive.bot/fleet-relay": "0.3.179",
+    "@hyperdrive.bot/fleet-protocol": "0.3.181",
+    "@hyperdrive.bot/fleet-relay": "0.3.181",
     "zod": "^4.4.3"
   },
   "devDependencies": {