@makaio/framework 1.0.0-dev-1779051654000 → 1.0.0-dev-1781023871421

package/dist/{index-C_kS2aqV2.d.mts → index-DGBu6bHi2.d.mts}

@@ -1,7 +1,7 @@
 import { IMakaioBus } from "@makaio/framework/bus";
-import { IMakaioSession, MakaioSessionAgent, Message, MessageInput, SessionContext, TurnInitiator } from "@makaio/framework/contracts";
+import { IMakaioSession, MakaioSessionAgent, Message, MessageInput, ResponseSchemaDescriptor, SessionContext, TurnInitiator } from "@makaio/framework/contracts";
 
-//#region packages/services/core/src/session/entities/turn.d.ts
+//#region services/core/src/session/entities/turn.d.ts
 /**
  * Result of a completed turn.
  */
@@ -172,7 +172,7 @@ declare class Turn$1 {
   private checkCompletion;
 }
 //#endregion
-//#region packages/services/core/src/session/session-turn-manager.d.ts
+//#region services/core/src/session/session-turn-manager.d.ts
 /**
  * Result of a completed turn.
  */
@@ -313,7 +313,7 @@ declare class SessionTurnManager {
   private bufferUsageDuringCompletion;
 }
 //#endregion
-//#region packages/services/core/src/session/handlers/abandon-handler.d.ts
+//#region services/core/src/session/handlers/abandon-handler.d.ts
 /**
  * Registers the session.abandon RPC handler.
  *
@@ -323,7 +323,7 @@ declare class SessionTurnManager {
  */
 declare function registerAbandonHandler(bus: IMakaioBus): () => void;
 //#endregion
-//#region packages/services/core/src/session/handlers/attach-handler.d.ts
+//#region services/core/src/session/handlers/attach-handler.d.ts
 /**
  * Registers the session.agent.attach RPC handler.
  *
@@ -340,7 +340,7 @@ declare function registerAbandonHandler(bus: IMakaioBus): () => void;
  */
 declare function registerAttachHandler(bus: IMakaioBus, activeTurns: Map<string, Turn$1>, machineId?: string): () => void;
 //#endregion
-//#region packages/services/core/src/session/handlers/compress-handler.d.ts
+//#region services/core/src/session/handlers/compress-handler.d.ts
 /**
  * Registers the session.compress RPC handler.
  *
@@ -352,7 +352,7 @@ declare function registerAttachHandler(bus: IMakaioBus, activeTurns: Map<string,
  */
 declare function registerCompressHandler(bus: IMakaioBus): () => void;
 //#endregion
-//#region packages/services/core/src/session/handlers/fork-handler.d.ts
+//#region services/core/src/session/handlers/fork-handler.d.ts
 /**
  * Registers the session.fork RPC handler.
  *
@@ -363,7 +363,7 @@ declare function registerCompressHandler(bus: IMakaioBus): () => void;
  */
 declare function registerForkHandler(bus: IMakaioBus): () => void;
 //#endregion
-//#region packages/services/core/src/session/handlers/merge-handler.d.ts
+//#region services/core/src/session/handlers/merge-handler.d.ts
 /**
  * Registers the session.merge RPC handler.
  *
@@ -373,7 +373,7 @@ declare function registerForkHandler(bus: IMakaioBus): () => void;
  */
 declare function registerMergeHandler(bus: IMakaioBus): () => void;
 //#endregion
-//#region packages/services/core/src/session/handlers/route-to-agents.d.ts
+//#region services/core/src/session/handlers/route-to-agents.d.ts
 /**
  * Interface for turn context enrichment.
  * Implemented by TurnContextEnricher in orchestration package.
@@ -408,14 +408,14 @@ interface CwdSwapMeta {
  * @param swappedAgentIds - Set of agent IDs that swapped connector due to cwd mismatch
  * @param swappedAgentCwd - Previous/new cwd metadata keyed by agent ID
  * @param freshMessageHistory - Curated history for agents forced into fresh mode
- * @param responseSchema - Optional JSON schema for structured responses
+ * @param responseSchema - Optional structured output descriptor for the turn
  */
 declare function routeToAgents(bus: IMakaioBus, session: IMakaioSession, agents: MakaioSessionAgent[], message: MessageInput, messageId: string, turn: Turn$1, deliveryMode: 'enqueue' | 'immediate' | undefined, onTurnComplete: (turn: Turn$1, result: {
   success: boolean;
   errors: string[];
-}) => Promise<void>, sessionContext?: SessionContext, turnContextEnricher?: ITurnContextEnricher, isNewTurn?: boolean, recoveryContext?: SessionContext, recoveredAgentIds?: ReadonlySet<string>, swappedAgentIds?: ReadonlySet<string>, swappedAgentCwd?: ReadonlyMap<string, CwdSwapMeta>, freshMessageHistory?: Message[], responseSchema?: Record<string, unknown>): Promise<void>;
+}) => Promise<void>, sessionContext?: SessionContext, turnContextEnricher?: ITurnContextEnricher, isNewTurn?: boolean, recoveryContext?: SessionContext, recoveredAgentIds?: ReadonlySet<string>, swappedAgentIds?: ReadonlySet<string>, swappedAgentCwd?: ReadonlyMap<string, CwdSwapMeta>, freshMessageHistory?: Message[], responseSchema?: ResponseSchemaDescriptor): Promise<void>;
 //#endregion
-//#region packages/services/core/src/session/handlers/route-to-agents-core.d.ts
+//#region services/core/src/session/handlers/route-to-agents-core.d.ts
 /**
  * Route a message to target agents using a single shared session context.
  *
@@ -431,8 +431,8 @@ declare function routeToAgents(bus: IMakaioBus, session: IMakaioSession, agents:
  * @param deliveryMode - How to deliver the message to the agent
  * @param onTurnComplete - Callback invoked when the turn completes (all agents done)
  * @param sessionContext - Optional shared session context forwarded to all agents
- * @param responseSchema - Optional JSON schema for structured responses
+ * @param responseSchema - Optional structured output descriptor for the turn
  */
-declare function routeToAgentsCore(bus: IMakaioBus, session: IMakaioSession, agents: MakaioSessionAgent[], message: MessageInput, messageId: string, turn: Turn$1, deliveryMode: 'enqueue' | 'immediate' | undefined, onTurnComplete: TurnCompleteCallback, sessionContext?: SessionContext, responseSchema?: Record<string, unknown>): Promise<void>;
+declare function routeToAgentsCore(bus: IMakaioBus, session: IMakaioSession, agents: MakaioSessionAgent[], message: MessageInput, messageId: string, turn: Turn$1, deliveryMode: 'enqueue' | 'immediate' | undefined, onTurnComplete: TurnCompleteCallback, sessionContext?: SessionContext, responseSchema?: ResponseSchemaDescriptor): Promise<void>;
 //#endregion
 export { registerCompressHandler as a, SessionTurnManager as c, Turn$1 as d, TurnConfig as f, TurnStateChange as h, registerForkHandler as i, TurnCompleteCallback as l, TurnResult as m, routeToAgents as n, registerAttachHandler as o, TurnContext as p, registerMergeHandler as r, registerAbandonHandler as s, routeToAgentsCore as t, TurnCompletionResult as u };

package/dist/index-DKC62dY5.d.mts

@@ -0,0 +1,146 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region core/contracts/src/telemetry/namespace.d.ts
+/** Framework contract namespace for sanitized bus subject telemetry facts. */
+declare const SubjectTelemetryNamespace: _$_makaio_core0.BusNamespaceDefinition<"subject-telemetry", {
+  fact: _$_makaio_core0.CollectorOnlySubjectSchema<_$zod.ZodObject<{
+    factId: _$zod.ZodString;
+    observedAt: _$zod.ZodNumber;
+    machineId: _$zod.ZodOptional<_$zod.ZodString>;
+    namespace: _$zod.ZodString;
+    subject: _$zod.ZodString;
+    messageType: _$zod.ZodEnum<{
+      request: "request";
+      event: "event";
+      broadcast: "broadcast";
+    }>;
+    direction: _$zod.ZodEnum<{
+      local: "local";
+      outbound: "outbound";
+      inbound: "inbound";
+    }>;
+    messageId: _$zod.ZodString;
+    correlationId: _$zod.ZodOptional<_$zod.ZodString>;
+    attributes: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean, _$zod.ZodNull, _$zod.ZodArray<_$zod.ZodString>, _$zod.ZodArray<_$zod.ZodNumber>, _$zod.ZodArray<_$zod.ZodBoolean>, _$zod.ZodArray<_$zod.ZodNull>]>>;
+  }, _$zod_v4_core0.$strict>>;
+}>;
+/** Typed subjects for sanitized bus subject telemetry facts. */
+declare const SubjectTelemetrySubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"subject-telemetry", {
+  fact: _$_makaio_core0.CollectorOnlySubjectSchema<_$zod.ZodObject<{
+    factId: _$zod.ZodString;
+    observedAt: _$zod.ZodNumber;
+    machineId: _$zod.ZodOptional<_$zod.ZodString>;
+    namespace: _$zod.ZodString;
+    subject: _$zod.ZodString;
+    messageType: _$zod.ZodEnum<{
+      request: "request";
+      event: "event";
+      broadcast: "broadcast";
+    }>;
+    direction: _$zod.ZodEnum<{
+      local: "local";
+      outbound: "outbound";
+      inbound: "inbound";
+    }>;
+    messageId: _$zod.ZodString;
+    correlationId: _$zod.ZodOptional<_$zod.ZodString>;
+    attributes: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean, _$zod.ZodNull, _$zod.ZodArray<_$zod.ZodString>, _$zod.ZodArray<_$zod.ZodNumber>, _$zod.ZodArray<_$zod.ZodBoolean>, _$zod.ZodArray<_$zod.ZodNull>]>>;
+  }, _$zod_v4_core0.$strict>>;
+}>, "subject-telemetry">;
+//#endregion
+//#region core/contracts/src/telemetry/schemas.d.ts
+/**
+ * Scalar attribute value allowed in a telemetry fact.
+ *
+ * Restricted to primitives and homogeneous primitive arrays so that the
+ * telemetry sink can safely serialize without inspecting arbitrary objects.
+ */
+declare const SubjectTelemetryAttributeValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodNull>]>;
+/** Inferred TypeScript type for a sanitized attribute value. */
+type SubjectTelemetryAttributeValue = z.infer<typeof SubjectTelemetryAttributeValueSchema>;
+/**
+ * Bus message kind projected into a telemetry fact.
+ * Covers local bus API entrypoints observed by this MVP.
+ */
+declare const SubjectTelemetryMessageTypeSchema: z.ZodEnum<{
+  request: "request";
+  event: "event";
+  broadcast: "broadcast";
+}>;
+/**
+ * Flow direction of the observed message at the source runtime.
+ *
+ * - `local` — originated and consumed within the same runtime.
+ * - `outbound` — dispatched to a remote peer.
+ * - `inbound` — received from a remote peer.
+ */
+declare const SubjectTelemetryDirectionSchema: z.ZodEnum<{
+  local: "local";
+  outbound: "outbound";
+  inbound: "inbound";
+}>;
+/**
+ * Sanitized bus subject telemetry fact schema.
+ *
+ * A fact captures the observable, non-sensitive metadata of a single bus
+ * message. All payload content is excluded; only correlation handles and
+ * namespace-approved scalar attributes are present.
+ */
+declare const SubjectTelemetryFactSchema: z.ZodObject<{
+  factId: z.ZodString;
+  observedAt: z.ZodNumber;
+  machineId: z.ZodOptional<z.ZodString>;
+  namespace: z.ZodString;
+  subject: z.ZodString;
+  messageType: z.ZodEnum<{
+    request: "request";
+    event: "event";
+    broadcast: "broadcast";
+  }>;
+  direction: z.ZodEnum<{
+    local: "local";
+    outbound: "outbound";
+    inbound: "inbound";
+  }>;
+  messageId: z.ZodString;
+  correlationId: z.ZodOptional<z.ZodString>;
+  attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodNull>]>>;
+}, z.core.$strict>;
+/** Inferred TypeScript type for a sanitized bus subject telemetry fact. */
+type SubjectTelemetryFact = z.infer<typeof SubjectTelemetryFactSchema>;
+/**
+ * Subject telemetry domain bus schemas aggregate.
+ *
+ * Each key becomes a subject identifier as `subject-telemetry.<key>`.
+ */
+declare const SubjectTelemetrySchemas: {
+  /**
+   * A single sanitized telemetry fact emitted by the projection layer.
+   * Event: transport-ingestable by collectors, never laterally relayed.
+   */
+  fact: _$_makaio_core0.CollectorOnlySubjectSchema<z.ZodObject<{
+    factId: z.ZodString;
+    observedAt: z.ZodNumber;
+    machineId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodString;
+    subject: z.ZodString;
+    messageType: z.ZodEnum<{
+      request: "request";
+      event: "event";
+      broadcast: "broadcast";
+    }>;
+    direction: z.ZodEnum<{
+      local: "local";
+      outbound: "outbound";
+      inbound: "inbound";
+    }>;
+    messageId: z.ZodString;
+    correlationId: z.ZodOptional<z.ZodString>;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodNull>]>>;
+  }, z.core.$strict>>;
+};
+//#endregion
+export { SubjectTelemetryFactSchema as a, SubjectTelemetryNamespace as c, SubjectTelemetryFact as i, SubjectTelemetrySubjects as l, SubjectTelemetryAttributeValueSchema as n, SubjectTelemetryMessageTypeSchema as o, SubjectTelemetryDirectionSchema as r, SubjectTelemetrySchemas as s, SubjectTelemetryAttributeValue as t };

package/dist/{index-7sXlairn2.d.mts → index-DKia0MX1.d.mts}

@@ -1,7 +1,7 @@
 import { IMakaioBus } from "@makaio/framework/bus";
 import { BaseService } from "@makaio/framework/service-base";
 
-//#region packages/services/core/src/tray-menu/tray-menu-service.d.ts
+//#region services/core/src/tray-menu/tray-menu-service.d.ts
 /**
  * In-memory registry for package-contributed tray menu entries.
  *

package/dist/{index-E8d_RwaF.d.mts → index-DMKnON5s.d.mts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-//#region packages/contracts/src/timeout/schemas.d.ts
+//#region core/contracts/src/timeout/schemas.d.ts
 /**
  * Categories of timeouts in the adapter lifecycle.
  */