@rudderhq/shared 0.3.6-canary.3 → 0.3.6-canary.30

package/dist/agent-run.d.ts

@@ -0,0 +1,4 @@
+import type { AgentRun, HeartbeatRun } from "./types/heartbeat.js";
+export declare function toAgentRun(run: HeartbeatRun): AgentRun;
+export declare function toAgentRuns(runs: HeartbeatRun[]): AgentRun[];
+//# sourceMappingURL=agent-run.d.ts.map

package/dist/agent-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.d.ts","sourceRoot":"","sources":["../src/agent-run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA8DnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,QAAQ,CAoBtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,CAE5D"}

package/dist/agent-run.js

@@ -0,0 +1,90 @@
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function isAgentRunScene(value) {
+    return value === "issue"
+        || value === "chat"
+        || value === "automation"
+        || value === "review"
+        || value === "manual"
+        || value === "heartbeat";
+}
+function isAgentRunTargetType(value) {
+    return value === "issue"
+        || value === "chat_conversation"
+        || value === "chat_message"
+        || value === "automation_run"
+        || value === "wakeup_request"
+        || value === "manual";
+}
+function resolveScene(run, context) {
+    if (isAgentRunScene(context.scene))
+        return context.scene;
+    if (run.invocationSource === "chat" || run.chatConversationId || stringValue(context.conversationId))
+        return "chat";
+    if (run.invocationSource === "review")
+        return "review";
+    if (run.invocationSource === "automation" || stringValue(context.automationRunId))
+        return "automation";
+    if (run.invocationSource === "timer")
+        return "heartbeat";
+    if (stringValue(context.issueId))
+        return "issue";
+    return "manual";
+}
+function resolveTargetType(run, context) {
+    if (isAgentRunTargetType(context.targetType))
+        return context.targetType;
+    if (run.chatConversationId || stringValue(context.conversationId))
+        return "chat_conversation";
+    if (stringValue(context.automationRunId))
+        return "automation_run";
+    if (stringValue(context.issueId))
+        return "issue";
+    if (run.wakeupRequestId || stringValue(context.wakeupRequestId))
+        return "wakeup_request";
+    return "manual";
+}
+function resolveTargetId(run, context, targetType) {
+    const explicit = stringValue(context.targetId);
+    if (explicit)
+        return explicit;
+    if (targetType === "chat_conversation")
+        return run.chatConversationId ?? stringValue(context.conversationId);
+    if (targetType === "chat_message")
+        return stringValue(context.messageId) ?? stringValue(context.assistantMessageId) ?? stringValue(context.userMessageId);
+    if (targetType === "automation_run")
+        return stringValue(context.automationRunId);
+    if (targetType === "issue")
+        return stringValue(context.issueId);
+    if (targetType === "wakeup_request")
+        return run.wakeupRequestId ?? stringValue(context.wakeupRequestId);
+    return null;
+}
+export function toAgentRun(run) {
+    const context = asRecord(run.contextSnapshot);
+    const targetType = resolveTargetType(run, context);
+    const conversationId = run.chatConversationId ?? stringValue(context.conversationId);
+    const messageId = stringValue(context.messageId)
+        ?? stringValue(context.assistantMessageId)
+        ?? stringValue(context.userMessageId);
+    return {
+        ...run,
+        scene: resolveScene(run, context),
+        triggerKind: stringValue(context.triggerKind) ?? run.triggerDetail ?? run.invocationSource,
+        targetType,
+        targetId: resolveTargetId(run, context, targetType),
+        conversationId,
+        messageId,
+        automationRunId: stringValue(context.automationRunId),
+        automationId: stringValue(context.automationId),
+        wakeupRequestId: run.wakeupRequestId ?? stringValue(context.wakeupRequestId),
+    };
+}
+export function toAgentRuns(runs) {
+    return runs.map(toAgentRun);
+}
+//# sourceMappingURL=agent-run.js.map

package/dist/agent-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.js","sourceRoot":"","sources":["../src/agent-run.ts"],"names":[],"mappings":"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"}

package/dist/agent-run.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-run.test.d.ts.map

package/dist/agent-run.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.test.d.ts","sourceRoot":"","sources":["../src/agent-run.test.ts"],"names":[],"mappings":""}

package/dist/agent-run.test.js

@@ -0,0 +1,111 @@
+import { describe, expect, it } from "vitest";
+import { toAgentRun } from "./index.js";
+function heartbeatRun(overrides) {
+    return {
+        id: "run-1",
+        orgId: "org-1",
+        agentId: "agent-1",
+        invocationSource: "on_demand",
+        triggerDetail: null,
+        status: "running",
+        startedAt: null,
+        finishedAt: null,
+        error: null,
+        wakeupRequestId: null,
+        exitCode: null,
+        signal: null,
+        usageJson: null,
+        resultJson: null,
+        sessionIdBefore: null,
+        sessionIdAfter: null,
+        logStore: null,
+        logRef: null,
+        logBytes: null,
+        logSha256: null,
+        logCompressed: false,
+        stdoutExcerpt: null,
+        stderrExcerpt: null,
+        errorCode: null,
+        externalRunId: null,
+        chatConversationId: null,
+        processPid: null,
+        processStartedAt: null,
+        retryOfRunId: null,
+        processLossRetryCount: 0,
+        contextSnapshot: null,
+        createdAt: new Date("2026-06-20T00:00:00.000Z"),
+        updatedAt: new Date("2026-06-20T00:00:00.000Z"),
+        ...overrides,
+    };
+}
+describe("toAgentRun", () => {
+    it("normalizes chat run scene and target from legacy heartbeat fields", () => {
+        const run = toAgentRun(heartbeatRun({
+            id: "chat-run",
+            invocationSource: "chat",
+            triggerDetail: "chat_assistant_reply_stream",
+            chatConversationId: "conversation-1",
+            contextSnapshot: {
+                assistantMessageId: "assistant-message-1",
+            },
+        }));
+        expect(run.scene).toBe("chat");
+        expect(run.triggerKind).toBe("chat_assistant_reply_stream");
+        expect(run.targetType).toBe("chat_conversation");
+        expect(run.targetId).toBe("conversation-1");
+        expect(run.conversationId).toBe("conversation-1");
+        expect(run.messageId).toBe("assistant-message-1");
+    });
+    it("honors explicit automation target metadata while preserving linked chat facts", () => {
+        const run = toAgentRun(heartbeatRun({
+            id: "automation-chat-run",
+            invocationSource: "chat",
+            triggerDetail: "chat_assistant_reply_stream",
+            chatConversationId: "conversation-1",
+            contextSnapshot: {
+                scene: "chat",
+                targetType: "automation_run",
+                targetId: "automation-run-1",
+                automationRunId: "automation-run-1",
+                automationId: "automation-1",
+                conversationId: "conversation-1",
+                userMessageId: "user-message-1",
+                assistantMessageId: "assistant-message-1",
+            },
+        }));
+        expect(run.scene).toBe("chat");
+        expect(run.targetType).toBe("automation_run");
+        expect(run.targetId).toBe("automation-run-1");
+        expect(run.automationRunId).toBe("automation-run-1");
+        expect(run.automationId).toBe("automation-1");
+        expect(run.conversationId).toBe("conversation-1");
+        expect(run.messageId).toBe("assistant-message-1");
+    });
+    it("falls back to issue target metadata for issue-backed runs", () => {
+        const run = toAgentRun(heartbeatRun({
+            invocationSource: "assignment",
+            triggerDetail: "manual",
+            contextSnapshot: {
+                issueId: "issue-1",
+            },
+        }));
+        expect(run.scene).toBe("issue");
+        expect(run.triggerKind).toBe("manual");
+        expect(run.targetType).toBe("issue");
+        expect(run.targetId).toBe("issue-1");
+    });
+    it("normalizes timer invocations to the heartbeat scene", () => {
+        const run = toAgentRun(heartbeatRun({
+            invocationSource: "timer",
+            triggerDetail: "system",
+            contextSnapshot: {
+                wakeReason: "heartbeat_timer",
+            },
+        }));
+        expect(run.scene).toBe("heartbeat");
+        expect(run.triggerKind).toBe("system");
+        expect(run.targetType).toBe("manual");
+        expect(run.targetId).toBeNull();
+    });
+});
+//# sourceMappingURL=agent-run.test.js.map

package/dist/agent-run.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.test.js","sourceRoot":"","sources":["../src/agent-run.test.ts"],"names":[],"mappings":"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"}

package/dist/api.d.ts

@@ -13,6 +13,7 @@ export declare const API: {
     readonly secrets: "/api/secrets";
     readonly costs: "/api/costs";
     readonly activity: "/api/activity";
+    readonly agentRuns: "/api/agent-runs";
     readonly dashboard: "/api/dashboard";
     readonly sidebarBadges: "/api/sidebar-badges";
     readonly invites: "/api/invites";

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;CAoBN,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBN,CAAC"}

package/dist/api.js

@@ -13,6 +13,7 @@ export const API = {
     secrets: `${API_PREFIX}/secrets`,
     costs: `${API_PREFIX}/costs`,
     activity: `${API_PREFIX}/activity`,
+    agentRuns: `${API_PREFIX}/agent-runs`,
     dashboard: `${API_PREFIX}/dashboard`,
     sidebarBadges: `${API_PREFIX}/sidebar-badges`,
     invites: `${API_PREFIX}/invites`,

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AAEjC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,aAAa,EAAE,GAAG,UAAU,OAAO;IACnC,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,aAAa,EAAE,GAAG,UAAU,iBAAiB;IAC7C,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,YAAY,EAAE,GAAG,UAAU,gBAAgB;IAC3C,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,KAAK,EAAE,GAAG,UAAU,QAAQ;CACpB,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AAEjC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,aAAa,EAAE,GAAG,UAAU,OAAO;IACnC,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,MAAM,EAAE,GAAG,UAAU,SAAS;IAC9B,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,KAAK,EAAE,GAAG,UAAU,QAAQ;IAC5B,QAAQ,EAAE,GAAG,UAAU,WAAW;IAClC,SAAS,EAAE,GAAG,UAAU,aAAa;IACrC,SAAS,EAAE,GAAG,UAAU,YAAY;IACpC,aAAa,EAAE,GAAG,UAAU,iBAAiB;IAC7C,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,YAAY,EAAE,GAAG,UAAU,gBAAgB;IAC3C,OAAO,EAAE,GAAG,UAAU,UAAU;IAChC,KAAK,EAAE,GAAG,UAAU,QAAQ;CACpB,CAAC"}

package/dist/config-schema.d.ts

@@ -5,12 +5,12 @@ export declare const configMetaSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     source: z.ZodEnum<["onboard", "configure", "doctor"]>;
 }, "strip", z.ZodTypeAny, {
-    version: 1;
     updatedAt: string;
+    version: 1;
     source: "onboard" | "configure" | "doctor";
 }, {
-    version: 1;
     updatedAt: string;
+    version: 1;
     source: "onboard" | "configure" | "doctor";
 }>;
 export declare const llmConfigSchema: z.ZodObject<{
@@ -150,16 +150,16 @@ export declare const storageS3ConfigSchema: z.ZodObject<{
     prefix: z.ZodDefault<z.ZodString>;
     forcePathStyle: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    bucket: string;
     region: string;
     prefix: string;
+    bucket: string;
     forcePathStyle: boolean;
     endpoint?: string | undefined;
 }, {
-    bucket?: string | undefined;
     region?: string | undefined;
-    endpoint?: string | undefined;
     prefix?: string | undefined;
+    bucket?: string | undefined;
+    endpoint?: string | undefined;
     forcePathStyle?: boolean | undefined;
 }>;
 export declare const storageConfigSchema: z.ZodObject<{
@@ -178,23 +178,23 @@ export declare const storageConfigSchema: z.ZodObject<{
         prefix: z.ZodDefault<z.ZodString>;
         forcePathStyle: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        bucket: string;
         region: string;
         prefix: string;
+        bucket: string;
         forcePathStyle: boolean;
         endpoint?: string | undefined;
     }, {
-        bucket?: string | undefined;
         region?: string | undefined;
-        endpoint?: string | undefined;
         prefix?: string | undefined;
+        bucket?: string | undefined;
+        endpoint?: string | undefined;
         forcePathStyle?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     s3: {
-        bucket: string;
         region: string;
         prefix: string;
+        bucket: string;
         forcePathStyle: boolean;
         endpoint?: string | undefined;
     };
@@ -204,10 +204,10 @@ export declare const storageConfigSchema: z.ZodObject<{
     };
 }, {
     s3?: {
-        bucket?: string | undefined;
         region?: string | undefined;
-        endpoint?: string | undefined;
         prefix?: string | undefined;
+        bucket?: string | undefined;
+        endpoint?: string | undefined;
         forcePathStyle?: boolean | undefined;
     } | undefined;
     provider?: "local_disk" | "s3" | undefined;
@@ -255,14 +255,14 @@ export declare const langfuseConfigSchema: z.ZodObject<{
     enabled: boolean;
     baseUrl: string;
     publicKey?: string | undefined;
-    secretKey?: string | undefined;
     environment?: string | undefined;
+    secretKey?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     baseUrl?: string | undefined;
     publicKey?: string | undefined;
-    secretKey?: string | undefined;
     environment?: string | undefined;
+    secretKey?: string | undefined;
 }>;
 export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
     $meta: z.ZodObject<{
@@ -270,12 +270,12 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         updatedAt: z.ZodString;
         source: z.ZodEnum<["onboard", "configure", "doctor"]>;
     }, "strip", z.ZodTypeAny, {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     }, {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     }>;
     llm: z.ZodOptional<z.ZodObject<{
@@ -398,23 +398,23 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
             prefix: z.ZodDefault<z.ZodString>;
             forcePathStyle: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
-            bucket: string;
             region: string;
             prefix: string;
+            bucket: string;
             forcePathStyle: boolean;
             endpoint?: string | undefined;
         }, {
-            bucket?: string | undefined;
             region?: string | undefined;
-            endpoint?: string | undefined;
             prefix?: string | undefined;
+            bucket?: string | undefined;
+            endpoint?: string | undefined;
             forcePathStyle?: boolean | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         s3: {
-            bucket: string;
             region: string;
             prefix: string;
+            bucket: string;
             forcePathStyle: boolean;
             endpoint?: string | undefined;
         };
@@ -424,10 +424,10 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         };
     }, {
         s3?: {
-            bucket?: string | undefined;
             region?: string | undefined;
-            endpoint?: string | undefined;
             prefix?: string | undefined;
+            bucket?: string | undefined;
+            endpoint?: string | undefined;
             forcePathStyle?: boolean | undefined;
         } | undefined;
         provider?: "local_disk" | "s3" | undefined;
@@ -468,14 +468,14 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         enabled: boolean;
         baseUrl: string;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         baseUrl?: string | undefined;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     database: {
@@ -492,8 +492,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         connectionString?: string | undefined;
     };
     $meta: {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     };
     logging: {
@@ -515,9 +515,9 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     storage: {
         s3: {
-            bucket: string;
             region: string;
             prefix: string;
+            bucket: string;
             forcePathStyle: boolean;
             endpoint?: string | undefined;
         };
@@ -541,8 +541,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         enabled: boolean;
         baseUrl: string;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     } | undefined;
 }, {
     database: {
@@ -559,8 +559,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     };
     $meta: {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     };
     logging: {
@@ -586,10 +586,10 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     storage?: {
         s3?: {
-            bucket?: string | undefined;
             region?: string | undefined;
-            endpoint?: string | undefined;
             prefix?: string | undefined;
+            bucket?: string | undefined;
+            endpoint?: string | undefined;
             forcePathStyle?: boolean | undefined;
         } | undefined;
         provider?: "local_disk" | "s3" | undefined;
@@ -608,8 +608,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         enabled?: boolean | undefined;
         baseUrl?: string | undefined;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     } | undefined;
 }>, {
     database: {
@@ -626,8 +626,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         connectionString?: string | undefined;
     };
     $meta: {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     };
     logging: {
@@ -649,9 +649,9 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     storage: {
         s3: {
-            bucket: string;
             region: string;
             prefix: string;
+            bucket: string;
             forcePathStyle: boolean;
             endpoint?: string | undefined;
         };
@@ -675,8 +675,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         enabled: boolean;
         baseUrl: string;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     } | undefined;
 }, {
     database: {
@@ -693,8 +693,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     };
     $meta: {
-        version: 1;
         updatedAt: string;
+        version: 1;
         source: "onboard" | "configure" | "doctor";
     };
     logging: {
@@ -720,10 +720,10 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     storage?: {
         s3?: {
-            bucket?: string | undefined;
             region?: string | undefined;
-            endpoint?: string | undefined;
             prefix?: string | undefined;
+            bucket?: string | undefined;
+            endpoint?: string | undefined;
             forcePathStyle?: boolean | undefined;
         } | undefined;
         provider?: "local_disk" | "s3" | undefined;
@@ -742,8 +742,8 @@ export declare const rudderConfigSchema: z.ZodEffects<z.ZodObject<{
         enabled?: boolean | undefined;
         baseUrl?: string | undefined;
         publicKey?: string | undefined;
-        secretKey?: string | undefined;
         environment?: string | undefined;
+        secretKey?: string | undefined;
     } | undefined;
 }>;
 export type RudderConfig = z.infer<typeof rudderConfigSchema>;

package/dist/constants.d.ts

@@ -15,6 +15,10 @@ export type AgentStatus = (typeof AGENT_STATUSES)[number];
 export declare const AGENT_RUN_CONCURRENCY_DEFAULT = 3;
 export declare const AGENT_RUN_CONCURRENCY_MIN = 1;
 export declare const AGENT_RUN_CONCURRENCY_MAX = 10;
+export declare const AGENT_RUN_SCENES: readonly ["issue", "chat", "automation", "review", "manual", "heartbeat"];
+export type AgentRunScene = (typeof AGENT_RUN_SCENES)[number];
+export declare const AGENT_RUN_TARGET_TYPES: readonly ["issue", "chat_conversation", "chat_message", "automation_run", "wakeup_request", "manual"];
+export type AgentRunTargetType = (typeof AGENT_RUN_TARGET_TYPES)[number];
 export declare const AGENT_RUNTIME_TYPES: readonly ["process", "http", "claude_local", "codex_local", "gemini_local", "opencode_local", "pi_local", "cursor", "openclaw_gateway", "hermes_local"];
 export type AgentRuntimeType = (typeof AGENT_RUNTIME_TYPES)[number];
 export declare const AGENT_ROLES: readonly ["ceo", "cto", "cmo", "cfo", "engineer", "designer", "pm", "qa", "devops", "researcher", "general"];
@@ -169,7 +173,7 @@ export type PermissionKey = (typeof PERMISSION_KEYS)[number];
  * Increment this value whenever a breaking change is made to the plugin API
  * so that the host can reject incompatible plugin manifests.
  *
- * @see PLUGIN_SPEC.md §4 — Versioning
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Versioning
  */
 export declare const PLUGIN_API_VERSION: 1;
 /**
@@ -180,7 +184,7 @@ export declare const PLUGIN_API_VERSION: 1;
  * upgrade_pending → ready | error | uninstalled, uninstalled → installed (reinstall).
  *
  * @see {@link PluginStatus} — inferred union type
- * @see PLUGIN_SPEC.md §21.3 `plugins.status`
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugins.status`
  */
 export declare const PLUGIN_STATUSES: readonly ["installed", "ready", "disabled", "error", "upgrade_pending", "uninstalled"];
 export type PluginStatus = (typeof PLUGIN_STATUSES)[number];
@@ -188,7 +192,7 @@ export type PluginStatus = (typeof PLUGIN_STATUSES)[number];
  * Plugin classification categories. A plugin declares one or more categories
  * in its manifest to describe its primary purpose.
  *
- * @see PLUGIN_SPEC.md §6.2
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md
  */
 export declare const PLUGIN_CATEGORIES: readonly ["connector", "workspace", "automation", "ui"];
 export type PluginCategory = (typeof PLUGIN_CATEGORIES)[number];
@@ -200,7 +204,7 @@ export type PluginCategory = (typeof PLUGIN_CATEGORIES)[number];
  * Grouped into: Data Read, Data Write, Plugin State, Runtime/Integration,
  * Agent Tools, and UI.
  *
- * @see PLUGIN_SPEC.md §15 — Capability Model
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capability Model
  */
 export declare const PLUGIN_CAPABILITIES: readonly ["organizations.read", "projects.read", "project.workspaces.read", "issues.read", "issue.comments.read", "agents.read", "goals.read", "goals.create", "goals.update", "activity.read", "costs.read", "issues.create", "issues.update", "issue.comments.create", "agents.pause", "agents.resume", "agents.invoke", "agent.sessions.create", "agent.sessions.list", "agent.sessions.send", "agent.sessions.close", "activity.log.write", "metrics.write", "plugin.state.read", "plugin.state.write", "events.subscribe", "events.emit", "jobs.schedule", "webhooks.receive", "http.outbound", "secrets.read-ref", "agent.tools.register", "instance.settings.register", "ui.sidebar.register", "ui.page.register", "ui.detailTab.register", "ui.dashboardWidget.register", "ui.commentAnnotation.register", "ui.action.register"];
 export type PluginCapability = (typeof PLUGIN_CAPABILITIES)[number];
@@ -208,7 +212,7 @@ export type PluginCapability = (typeof PLUGIN_CAPABILITIES)[number];
  * UI extension slot types. Each slot type corresponds to a mount point in the
  * Rudder UI where plugin components can be rendered.
  *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
  */
 export declare const PLUGIN_UI_SLOT_TYPES: readonly ["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"];
 export type PluginUiSlotType = (typeof PLUGIN_UI_SLOT_TYPES)[number];
@@ -247,7 +251,7 @@ export type PluginLauncherRenderEnvironment = (typeof PLUGIN_LAUNCHER_RENDER_ENV
 /**
  * Entity types that a `detailTab` UI slot can attach to.
  *
- * @see PLUGIN_SPEC.md §19.3 — Detail Tabs
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Detail Tabs
  */
 export declare const PLUGIN_UI_SLOT_ENTITY_TYPES: readonly ["project", "issue", "agent", "goal", "run", "comment"];
 export type PluginUiSlotEntityType = (typeof PLUGIN_UI_SLOT_ENTITY_TYPES)[number];
@@ -255,7 +259,7 @@ export type PluginUiSlotEntityType = (typeof PLUGIN_UI_SLOT_ENTITY_TYPES)[number
  * Scope kinds for plugin state storage. Determines the granularity at which
  * a plugin stores key-value state data.
  *
- * @see PLUGIN_SPEC.md §21.3 `plugin_state.scope_kind`
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_state.scope_kind`
  */
 export declare const PLUGIN_STATE_SCOPE_KINDS: readonly ["instance", "organization", "project", "project_workspace", "agent", "issue", "goal", "run"];
 export type PluginStateScopeKind = (typeof PLUGIN_STATE_SCOPE_KINDS)[number];
@@ -275,14 +279,14 @@ export type PluginWebhookDeliveryStatus = (typeof PLUGIN_WEBHOOK_DELIVERY_STATUS
  * Core domain event types that plugins can subscribe to via the
  * `events.subscribe` capability.
  *
- * @see PLUGIN_SPEC.md §16 — Event System
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Event System
  */
 export declare const PLUGIN_EVENT_TYPES: readonly ["organization.created", "organization.updated", "project.created", "project.updated", "project.workspace_created", "project.workspace_updated", "project.workspace_deleted", "issue.created", "issue.updated", "issue.comment.created", "agent.created", "agent.updated", "agent.status_changed", "agent.run.started", "agent.run.finished", "agent.run.failed", "agent.run.cancelled", "goal.created", "goal.updated", "approval.created", "approval.decided", "cost_event.created", "activity.logged"];
 export type PluginEventType = (typeof PLUGIN_EVENT_TYPES)[number];
 /**
  * Error codes returned by the plugin bridge when a UI → worker call fails.
  *
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
  */
 export declare const PLUGIN_BRIDGE_ERROR_CODES: readonly ["WORKER_UNAVAILABLE", "CAPABILITY_DENIED", "WORKER_ERROR", "TIMEOUT", "UNKNOWN"];
 export type PluginBridgeErrorCode = (typeof PLUGIN_BRIDGE_ERROR_CODES)[number];