@brivioio/api-server-types 7.46.0 → 7.47.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './candidateEmailMessages.types';
 export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
+export * from './liveActivity.types';
 export * from './meetingBots.types';
 export * from './organizationDomains.types';
 export * from './organizationUsers.types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './candidateEmailMessages.types';
 export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
+export * from './liveActivity.types';
 export * from './meetingBots.types';
 export * from './organizationDomains.types';
 export * from './organizationUsers.types';

package/dist/liveActivity.types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Wire DTOs for the super-admin "Live Activity" feature: a real-time view of
+ * every agent run executing in this (single) process, plus the graceful
+ * drain / kill-switch lifecycle.
+ *
+ * These are pure transport shapes (serialized over SSE / JSON), so all
+ * timestamps are ISO strings and all ids are strings — there are no mongoose
+ * types here on purpose.
+ */
+/** The distinct kinds of Agent-SDK work that can run in the process. */
+export declare enum EAgentRunKind {
+    JOB_ROLE_CHAT = "JOB_ROLE_CHAT",
+    CANDIDATE_SOURCING = "CANDIDATE_SOURCING",
+    CANDIDATE_OUTREACH = "CANDIDATE_OUTREACH",
+    CANDIDATE_EVALUATION = "CANDIDATE_EVALUATION",
+    ORGANIZATION_DEEP_PROFILE = "ORGANIZATION_DEEP_PROFILE",
+    SLACK_CHANNEL_SIGNALS = "SLACK_CHANNEL_SIGNALS"
+}
+/** Severity for a single line in the live activity log. */
+export declare enum EActivityLogLevel {
+    INFO = "INFO",
+    SUCCESS = "SUCCESS",
+    WARN = "WARN",
+    ERROR = "ERROR"
+}
+/** Whether the process is serving normally or draining toward shutdown. */
+export declare enum EServerLifecycle {
+    RUNNING = "RUNNING",
+    DRAINING = "DRAINING"
+}
+/**
+ * A subagent currently executing inside a parent run. Detected from the SDK
+ * stream via `Task`/`Agent` tool-use blocks; closed when the matching
+ * tool_result arrives.
+ */
+export interface IActiveSubagent {
+    toolUseId: string;
+    subagentType: string;
+    description: string;
+    startedAt: string;
+    /** Last tool the subagent invoked, surfaced as a human line. */
+    currentActivity: string | null;
+}
+/** Optional kind-specific live metrics shown on a run card. */
+export interface IAgentRunMetrics {
+    searchesRun?: number;
+    poolSize?: number;
+    shortlistSize?: number;
+    emailsSent?: number;
+}
+/** A single agent run that is currently in flight. */
+export interface IActiveAgentRun {
+    runId: string;
+    kind: EAgentRunKind;
+    organizationId: string | null;
+    organizationName: string | null;
+    jobRoleId: string | null;
+    jobRoleTitle: string | null;
+    /** Short human label, e.g. "Sourcing · Senior Backend Engineer". */
+    label: string;
+    /** Live one-line detail of what the run is doing right now. */
+    detail: string;
+    startedAt: string;
+    lastActivityAt: string;
+    toolCallCount: number;
+    activeSubagents: IActiveSubagent[];
+    metrics: IAgentRunMetrics;
+}
+/** A single timestamped line in the rolling activity log. */
+export interface IActivityLogEntry {
+    id: string;
+    at: string;
+    level: EActivityLogLevel;
+    kind: EAgentRunKind | null;
+    runId: string | null;
+    organizationName: string | null;
+    jobRoleTitle: string | null;
+    message: string;
+}
+/** State of an in-progress drain (kill switch). Null when serving normally. */
+export interface IDrainState {
+    startedAt: string;
+    initiatedByEmail: string | null;
+    /** How many runs were in flight when drain began. */
+    activeRunsAtStart: number;
+    /** How many runs are still in flight right now. */
+    activeRunsRemaining: number;
+    /** True once a force-quit has been requested (don't wait for runs). */
+    forceRequested: boolean;
+    /** True once the process teardown has actually been triggered. */
+    exiting: boolean;
+}
+/** Full point-in-time picture, sent on connect and on demand. */
+export interface ILiveActivitySnapshot {
+    serverLifecycle: EServerLifecycle;
+    drain: IDrainState | null;
+    activeRuns: IActiveAgentRun[];
+    recentLog: IActivityLogEntry[];
+    /** The count that gates the deploy-safety banner. */
+    activeRunCount: number;
+    generatedAt: string;
+}
+/** SSE envelope pushed to the dashboard. */
+export type TLiveActivityStreamEvent = {
+    type: 'snapshot';
+    payload: ILiveActivitySnapshot;
+} | {
+    type: 'run_started';
+    payload: IActiveAgentRun;
+} | {
+    type: 'run_updated';
+    payload: IActiveAgentRun;
+} | {
+    type: 'run_ended';
+    payload: {
+        runId: string;
+    };
+} | {
+    type: 'log';
+    payload: IActivityLogEntry;
+} | {
+    type: 'drain';
+    payload: {
+        lifecycle: EServerLifecycle;
+        drain: IDrainState | null;
+    };
+} | {
+    type: 'heartbeat';
+    payload: {
+        at: string;
+    };
+};
+//# sourceMappingURL=liveActivity.types.d.ts.map

package/dist/liveActivity.types.d.ts.map

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

package/dist/liveActivity.types.js

@@ -0,0 +1,33 @@
+/**
+ * Wire DTOs for the super-admin "Live Activity" feature: a real-time view of
+ * every agent run executing in this (single) process, plus the graceful
+ * drain / kill-switch lifecycle.
+ *
+ * These are pure transport shapes (serialized over SSE / JSON), so all
+ * timestamps are ISO strings and all ids are strings — there are no mongoose
+ * types here on purpose.
+ */
+/** The distinct kinds of Agent-SDK work that can run in the process. */
+export var EAgentRunKind;
+(function (EAgentRunKind) {
+    EAgentRunKind["JOB_ROLE_CHAT"] = "JOB_ROLE_CHAT";
+    EAgentRunKind["CANDIDATE_SOURCING"] = "CANDIDATE_SOURCING";
+    EAgentRunKind["CANDIDATE_OUTREACH"] = "CANDIDATE_OUTREACH";
+    EAgentRunKind["CANDIDATE_EVALUATION"] = "CANDIDATE_EVALUATION";
+    EAgentRunKind["ORGANIZATION_DEEP_PROFILE"] = "ORGANIZATION_DEEP_PROFILE";
+    EAgentRunKind["SLACK_CHANNEL_SIGNALS"] = "SLACK_CHANNEL_SIGNALS";
+})(EAgentRunKind || (EAgentRunKind = {}));
+/** Severity for a single line in the live activity log. */
+export var EActivityLogLevel;
+(function (EActivityLogLevel) {
+    EActivityLogLevel["INFO"] = "INFO";
+    EActivityLogLevel["SUCCESS"] = "SUCCESS";
+    EActivityLogLevel["WARN"] = "WARN";
+    EActivityLogLevel["ERROR"] = "ERROR";
+})(EActivityLogLevel || (EActivityLogLevel = {}));
+/** Whether the process is serving normally or draining toward shutdown. */
+export var EServerLifecycle;
+(function (EServerLifecycle) {
+    EServerLifecycle["RUNNING"] = "RUNNING";
+    EServerLifecycle["DRAINING"] = "DRAINING";
+})(EServerLifecycle || (EServerLifecycle = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brivioio/api-server-types",
-  "version": "7.46.0",
+  "version": "7.47.0",
   "description": "TypeScript type definitions for Brivio API Server",
   "type": "module",
   "main": "dist/index.js",