@makaio/framework 1.0.0-dev-1785409369816 → 1.0.0-dev-1786014320559

package/dist/contracts/workflow/index.mjs

@@ -1 +1 @@
-import{$ as e,$t as t,A as n,At as r,B as i,Bt as a,C as o,Cn as s,Ct as c,D as l,Dt as u,E as d,Et as f,F as p,Ft as m,G as h,Gt as g,H as _,Ht as v,I as y,It as b,J as x,Jt as S,K as C,Kt as w,L as T,Lt as E,M as D,Mt as O,N as k,Nt as A,O as j,Ot as M,P as N,Pt as P,Q as F,Qt as I,R as L,Rt as R,S as z,Sn as B,St as V,T as H,Tn as U,Tt as W,U as G,Ut as K,V as q,Vt as J,W as Y,Wt as X,X as Z,Xt as Q,Y as $,Yt as ee,Z as te,Zt as ne,_ as re,_n as ie,_t as ae,a as oe,an as se,at as ce,b as le,bn as ue,bt as de,c as fe,cn as pe,ct as me,d as he,dn as ge,dt as _e,en as ve,et as ye,f as be,fn as xe,ft as Se,g as Ce,gn as we,gt as Te,h as Ee,hn as De,ht as Oe,i as ke,in as Ae,it as je,j as Me,jt as Ne,k as Pe,kt as Fe,l as Ie,ln as Le,lt as Re,m as ze,mn as Be,mt as Ve,n as He,nn as Ue,nt as We,o as Ge,on as Ke,ot as qe,p as Je,pn as Ye,pt as Xe,q as Ze,qt as Qe,r as $e,rn as et,rt as tt,s as nt,sn as rt,st as it,t as at,tn as ot,tt as st,u as ct,un as lt,ut,v as dt,vn as ft,vt as pt,w as mt,wn as ht,wt as gt,x as _t,xn as vt,xt as yt,y as bt,yn as xt,yt as St,z as Ct,zt as wt}from"../../workflow-BfDbgtIQ.mjs";export{h as ArtifactPublishTargetSchema,C as ArtifactQuerySourceSchema,Ze as BusEventPublishTargetSchema,de as BusEventTriggerSchema,Ce as BusEventWorkflowTrigger,x as BusRequestSourceSchema,l as CompleteExternalExecutionRequestSchema,$ as ContextBundleSchema,Z as ContextPublishTargetSchema,te as ContextSourceSchema,re as CronWorkflowTrigger,yt as EXECUTIONS_BY_ARTIFACT_REFS_DEFAULT_LIMIT_PER_REF,V as EXECUTIONS_BY_ARTIFACT_REFS_MAX_LIMIT_PER_REF,c as EXECUTIONS_BY_ARTIFACT_REFS_MAX_REFS,gt as EXECUTION_LIST_DEFAULT_LIMIT,W as EXECUTION_LIST_MAX_LIMIT,f as EXECUTION_LIST_MIN_LIMIT,j as EXTERNAL_EXECUTION_ID_PREFIX,We as ExecutionLinkListQuerySchema,tt as ExecutionLinkSchema,je as ExecutionLinkTypeSchema,u as ExecutionListCursorSchema,M as ExecutionListQuerySchema,Fe as ExecutionStatusSchema,r as ExecutionsByArtifactRefsQuerySchema,dt as ExtensionWorkflowTrigger,Ne as ExtensionWorkflowTriggerSchema,Pe as ExternalExecutionFrameCompletionSchema,n as ExternalExecutionFrameStartSchema,O as GateInstanceListQuerySchema,e as JsonPatchOperationSchema,A as LoopGateOutcomeSchema,bt as ManualWorkflowTrigger,Me as RegisterExternalExecutionRequestSchema,F as ResolvedContextEntrySchema,ce as SpanRecordSchema,qe as SpanStatusSchema,it as StepCancelPayloadSchema,me as StepRunConfigSchema,Re as StepRunResultSchema,ut as StepRunnerBusAuthSchema,_e as StepRunnerPlatformDefaultsSchema,Se as StepTelemetrySchema,Xe as TokenUsageSchema,at as TransitionActionInvocationSchema,He as TransitionConditionSchema,$e as TransitionEventTypeSchema,ke as TransitionRuleDefinitionSchema,Ve as WORKFLOW_CANCELLED_REASON,le as WebhookWorkflowTrigger,D as WorkLogArtifactWriteSchema,k as WorkLogDynamicNodeMaterializationSchema,N as WorkLogExecutionSummarySchema,p as WorkLogFrameEntrySchema,y as WorkLogGateEventSchema,T as WorkLogStatsSchema,L as WorkLogUsageSummarySchema,i as WorkerContributionManifestSchema,P as WorkflowArtifactBindingSchema,s as WorkflowArtifactRefSchema,m as WorkflowArtifactWriteDeclarationSchema,Oe as WorkflowCancelPayloadSchema,b as WorkflowConditionSchema,E as WorkflowDefinitionProvenanceSchema,R as WorkflowDefinitionSchema,wt as WorkflowDelegateAgentNodeSchema,lt as WorkflowDelegateEconomicsSchema,ge as WorkflowDelegateResultFinalizationGatewayRequestSchema,xe as WorkflowDelegateResultFinalizationRequestSchema,Ye as WorkflowDelegateResultFinalizationResponseSchema,Be as WorkflowDelegateResultFinalizerIdSchema,a as WorkflowDelegateRoleNodeSchema,De as WorkflowDelegateToolObservationSchema,J as WorkflowDynamicRegionSchema,ye as WorkflowError,st as WorkflowErrorCode,v as WorkflowExecutionSchema,K as WorkflowExecutionScopeSchema,we as WorkflowFinalizationClaimSchema,ie as WorkflowFinalizationDeliveryResultSchema,ft as WorkflowFinalizationIntentSchema,xt as WorkflowFinalizerIdSchema,X as WorkflowFrameStateSchema,g as WorkflowGateInstanceSchema,w as WorkflowGateNodeSchema,Qe as WorkflowGateStatusSchema,S as WorkflowIterateChainNodeSchema,ee as WorkflowIterateNodeSchema,Q as WorkflowListQuerySchema,ne as WorkflowLoopNodeSchema,o as WorkflowNamespace,I as WorkflowNodeBaseSchema,t as WorkflowNodeSchema,ve as WorkflowNodeTypeSchema,ot as WorkflowParallelModeSchema,Ue as WorkflowParallelNodeSchema,mt as WorkflowProgressUpdateSchema,et as WorkflowResolvedAgentSchema,Ae as WorkflowResolvedRoleSchema,Ct as WorkflowRunContextSchema,q as WorkflowRunResultSchema,Te as WorkflowRunnerStepTypeSchema,H as WorkflowSchemas,se as WorkflowSequenceNodeSchema,Ke as WorkflowSourceLocationSchema,rt as WorkflowStateDefinitionSchema,pe as WorkflowStationNodeSchema,ae as WorkflowStepTypeSchema,d as WorkflowSubjects,ue as WorkflowTerminalStatusSchema,Le as WorkflowTriggerSchema,_ as WorkflowWorkerBusAuthSchema,G as WorkflowWorkerConfigSchema,Y as WorkflowWorkerSourceSchema,pt as createStepCancelSubject,St as createWorkflowCancelSubject,vt as createWorkflowDelegateResultFinalizerNamespace,B as createWorkflowFinalizerNamespace,Ge as defineWorkflow,oe as defineWorkflowBundle,nt as delegateToAgent,fe as delegateToRole,Ie as gate,ct as iterate,he as iterateChain,be as loop,ht as parseArtifactRef,_t as projectWorkflowGraph,U as serializeArtifactRef,Je as station,Ee as validateNoNestedLoops,z as walkWorkflowDefinition,ze as zodSchemaToJsonRecord};
+import{$ as e,$t as t,A as n,At as r,B as i,Bt as a,C as o,Cn as s,Ct as c,D as l,Dt as u,E as d,Et as f,F as p,Ft as m,G as h,Gt as g,H as _,Ht as v,I as y,It as b,J as x,Jt as S,K as C,Kt as w,L as T,Lt as E,M as D,Mt as O,N as k,Nt as A,O as j,Ot as M,P as N,Pt as P,Q as F,Qt as I,R as L,Rt as R,S as z,Sn as B,St as V,T as H,Tn as U,Tt as W,U as G,Ut as K,V as q,Vt as J,W as Y,Wt as X,X as Z,Xt as Q,Y as $,Yt as ee,Z as te,Zt as ne,_ as re,_n as ie,_t as ae,a as oe,an as se,at as ce,b as le,bn as ue,bt as de,c as fe,cn as pe,ct as me,d as he,dn as ge,dt as _e,en as ve,et as ye,f as be,fn as xe,ft as Se,g as Ce,gn as we,gt as Te,h as Ee,hn as De,ht as Oe,i as ke,in as Ae,it as je,j as Me,jt as Ne,k as Pe,kt as Fe,l as Ie,ln as Le,lt as Re,m as ze,mn as Be,mt as Ve,n as He,nn as Ue,nt as We,o as Ge,on as Ke,ot as qe,p as Je,pn as Ye,pt as Xe,q as Ze,qt as Qe,r as $e,rn as et,rt as tt,s as nt,sn as rt,st as it,t as at,tn as ot,tt as st,u as ct,un as lt,ut,v as dt,vn as ft,vt as pt,w as mt,wn as ht,wt as gt,x as _t,xn as vt,xt as yt,y as bt,yn as xt,yt as St,z as Ct,zt as wt}from"../../workflow-Hzc5jlnV.mjs";export{Ze as ArtifactPublishTargetSchema,x as ArtifactQuerySourceSchema,Ee as AutomationWorkflowTrigger,Ce as BUS_EVENT_AUTOMATION_TRIGGER_KIND,$ as BusEventPublishTargetSchema,re as BusEventWorkflowTrigger,Z as BusRequestSourceSchema,dt as CRON_AUTOMATION_TRIGGER_KIND,j as CompleteExternalExecutionRequestSchema,te as ContextBundleSchema,F as ContextPublishTargetSchema,e as ContextSourceSchema,bt as CronAutomationTriggerParamsSchema,le as CronWorkflowTrigger,_t as DEFAULT_CRON_TIMEZONE,V as EXECUTIONS_BY_ARTIFACT_REFS_DEFAULT_LIMIT_PER_REF,c as EXECUTIONS_BY_ARTIFACT_REFS_MAX_LIMIT_PER_REF,gt as EXECUTIONS_BY_ARTIFACT_REFS_MAX_REFS,W as EXECUTION_LIST_DEFAULT_LIMIT,f as EXECUTION_LIST_MAX_LIMIT,u as EXECUTION_LIST_MIN_LIMIT,Pe as EXTERNAL_EXECUTION_ID_PREFIX,je as ExecutionLinkListQuerySchema,ce as ExecutionLinkSchema,qe as ExecutionLinkTypeSchema,M as ExecutionListCursorSchema,Fe as ExecutionListQuerySchema,r as ExecutionStatusSchema,Ne as ExecutionsByArtifactRefsQuerySchema,n as ExternalExecutionFrameCompletionSchema,Me as ExternalExecutionFrameStartSchema,O as GateInstanceListQuerySchema,st as JsonPatchOperationSchema,A as LoopGateOutcomeSchema,D as RegisterExternalExecutionRequestSchema,ye as ResolvedContextEntrySchema,it as SpanRecordSchema,me as SpanStatusSchema,Re as StepCancelPayloadSchema,ut as StepRunConfigSchema,_e as StepRunResultSchema,Se as StepRunnerBusAuthSchema,Xe as StepRunnerPlatformDefaultsSchema,Ve as StepTelemetrySchema,Oe as TokenUsageSchema,at as TransitionActionInvocationSchema,He as TransitionConditionSchema,$e as TransitionEventTypeSchema,ke as TransitionRuleDefinitionSchema,Te as WORKFLOW_CANCELLED_REASON,k as WorkLogArtifactWriteSchema,N as WorkLogDynamicNodeMaterializationSchema,p as WorkLogExecutionSummarySchema,y as WorkLogFrameEntrySchema,T as WorkLogGateEventSchema,L as WorkLogStatsSchema,Ct as WorkLogUsageSummarySchema,q as WorkerContributionManifestSchema,P as WorkflowArtifactBindingSchema,s as WorkflowArtifactRefSchema,m as WorkflowArtifactWriteDeclarationSchema,b as WorkflowAutomationTriggerBindingSchema,ae as WorkflowCancelPayloadSchema,E as WorkflowConditionSchema,R as WorkflowDefinitionProvenanceSchema,wt as WorkflowDefinitionSchema,a as WorkflowDelegateAgentNodeSchema,lt as WorkflowDelegateEconomicsSchema,ge as WorkflowDelegateResultFinalizationGatewayRequestSchema,xe as WorkflowDelegateResultFinalizationRequestSchema,Ye as WorkflowDelegateResultFinalizationResponseSchema,Be as WorkflowDelegateResultFinalizerIdSchema,J as WorkflowDelegateRoleNodeSchema,De as WorkflowDelegateToolObservationSchema,v as WorkflowDynamicRegionSchema,We as WorkflowError,tt as WorkflowErrorCode,K as WorkflowExecutionSchema,X as WorkflowExecutionScopeSchema,we as WorkflowFinalizationClaimSchema,ie as WorkflowFinalizationDeliveryResultSchema,ft as WorkflowFinalizationIntentSchema,xt as WorkflowFinalizerIdSchema,g as WorkflowFrameStateSchema,w as WorkflowGateInstanceSchema,Qe as WorkflowGateNodeSchema,S as WorkflowGateStatusSchema,ee as WorkflowIterateChainNodeSchema,Q as WorkflowIterateNodeSchema,ne as WorkflowListQuerySchema,I as WorkflowLoopNodeSchema,mt as WorkflowNamespace,t as WorkflowNodeBaseSchema,ve as WorkflowNodeSchema,ot as WorkflowNodeTypeSchema,Ue as WorkflowParallelModeSchema,et as WorkflowParallelNodeSchema,H as WorkflowProgressUpdateSchema,Ae as WorkflowResolvedAgentSchema,se as WorkflowResolvedRoleSchema,i as WorkflowRunContextSchema,_ as WorkflowRunResultSchema,pt as WorkflowRunnerStepTypeSchema,d as WorkflowSchemas,Ke as WorkflowSequenceNodeSchema,rt as WorkflowSourceLocationSchema,pe as WorkflowStateDefinitionSchema,Le as WorkflowStationNodeSchema,St as WorkflowStepTypeSchema,l as WorkflowSubjects,ue as WorkflowTerminalStatusSchema,G as WorkflowTriggerModeSchema,Y as WorkflowWorkerBusAuthSchema,h as WorkflowWorkerConfigSchema,C as WorkflowWorkerSourceSchema,de as createStepCancelSubject,yt as createWorkflowCancelSubject,vt as createWorkflowDelegateResultFinalizerNamespace,B as createWorkflowFinalizerNamespace,Ge as defineWorkflow,oe as defineWorkflowBundle,nt as delegateToAgent,fe as delegateToRole,Ie as gate,ct as iterate,he as iterateChain,be as loop,ht as parseArtifactRef,z as projectWorkflowGraph,U as serializeArtifactRef,Je as station,ze as validateNoNestedLoops,o as walkWorkflowDefinition};

package/dist/contribution-BH-wKsWI.d.mts

@@ -0,0 +1,35 @@
+import { l as AutomationTriggerType } from "./definition-BYgHlmMw.mjs";
+import { n as NodeExtensionContext, t as ExtensionContext } from "./extension-context-CqfddWXs.mjs";
+
+//#region core/contracts/src/automation-trigger/contribution.d.ts
+/**
+ * Executable automation trigger contribution surface declared by an extension.
+ *
+ * The runtime calls `createAutomationTriggers(ctx)` during extension activation
+ * and registers the returned {@link AutomationTriggerType}s with the trigger
+ * registry. The registry enforces that each trigger's `kind` is prefixed with
+ * the contributing extension's name.
+ *
+ * Trigger definitions carry live Zod parameter and event schemas and a trusted
+ * `activate` factory — they are runtime values and must never be included in
+ * serializable descriptor metadata. Use {@link createAutomationTriggerDescriptor}
+ * to produce the serializable representation for Builder discovery.
+ * @typeParam THostContext - Concrete context shape supplied by the host runtime.
+ *   Defaults to {@link NodeExtensionContext} because the current framework hosts
+ *   are Node-based.
+ */
+interface ExtensionAutomationTriggersContribution<THostContext extends ExtensionContext = NodeExtensionContext> {
+  /**
+   * Factory that produces the automation trigger definitions for this extension.
+   *
+   * Called during extension activation. The returned list is the extension's
+   * complete trigger batch and atomically replaces any prior batch registered
+   * under this extension's name. Returning a `Promise` allows async resource
+   * acquisition (e.g. lazy loading or config resolution).
+   * @param context - Per-extension runtime context supplied by the host.
+   * @returns Trigger definitions or a promise that resolves to them.
+   */
+  readonly createAutomationTriggers: (context: THostContext) => readonly AutomationTriggerType[] | Promise<readonly AutomationTriggerType[]>;
+}
+//#endregion
+export { ExtensionAutomationTriggersContribution as t };

package/dist/core/index.d.mts

@@ -831,6 +831,65 @@ declare function nestSubjectDefinitions<Domain extends string, T extends Record<
  */
 declare function getFullSubjectForSubjectDefinition(subject: SubjectDefinition): string;
 //#endregion
+//#region core/makaio-core/src/subject-helpers/namespace-wildcard-subject.d.ts
+/**
+ * Builds the namespace-level wildcard subject definition for one namespace.
+ *
+ * This is the canonical construction of the `$all` wildcard: a namespace exposes
+ * exactly one, and every consumer that needs to observe a whole namespace —
+ * including code that derives a wildcard from a concrete subject key — must build
+ * it through this helper rather than re-stating the literal. The wildcard is
+ * always an event subject and never local or channel-bound, because it stands for
+ * "every event in this namespace" rather than for any one subject's routing.
+ *
+ * A wildcard subject resolves to the full subject key `<namespace>.*`, which the
+ * bus's subscription matching reads as "every subject directly in this
+ * namespace". It deliberately does not cross a `:` namespace-hierarchy boundary.
+ * @typeParam Namespace - Namespace the wildcard belongs to.
+ * @param namespace - Namespace to build the wildcard for, e.g. `git` or
+ *   `storage:workflow`.
+ * @returns The wildcard subject definition of that namespace.
+ */
+declare function createNamespaceWildcardSubject<Namespace extends string>(namespace: Namespace): WildcardSubjectDefinition<Namespace>;
+//#endregion
+//#region core/makaio-core/src/subject-helpers/split-subject-key.d.ts
+/** The two segments a full bus subject key decomposes into. */
+interface SubjectKeySegments {
+  /**
+   * Namespace part of the key.
+   *
+   * Everything before the **first** dot, colons included: `:` is a namespace
+   * *hierarchy* boundary, not a namespace/subject separator, so
+   * `storage:workflow.list` has namespace `storage:workflow`.
+   */
+  readonly namespace: string;
+  /** Subject part of the key: everything after the first dot. */
+  readonly subject: string;
+}
+/**
+ * Splits a full bus subject key into its namespace and subject segments.
+ *
+ * A full subject key is always `<namespace>.<subject>` with both segments
+ * non-empty. `.event`, `event.`, and a key with no dot at all are all equally
+ * unaddressable — none of them names a namespace-and-subject pair any emitter can
+ * produce — so all three are rejected rather than reported as a partial split.
+ *
+ * Returning `undefined` instead of throwing keeps the decision at the call site:
+ * a subject *pattern* being validated wants a domain error naming the pattern,
+ * while a subject the framework itself constructed wants an assertion. Neither
+ * wants this helper's phrasing.
+ * @param key - Full bus subject key or namespace-level wildcard pattern.
+ * @returns The two segments, or `undefined` when `key` is not a full subject key.
+ * @example
+ * ```typescript
+ * splitSubjectKey('git.worktree'); // { namespace: 'git', subject: 'worktree' }
+ * splitSubjectKey('storage:workflow.list'); // { namespace: 'storage:workflow', subject: 'list' }
+ * splitSubjectKey('github.*'); // { namespace: 'github', subject: '*' }
+ * splitSubjectKey('nodot'); // undefined
+ * ```
+ */
+declare function splitSubjectKey(key: string): SubjectKeySegments | undefined;
+//#endregion
 //#region core/makaio-core/src/subject-helpers/is-request-schema.d.ts
 /**
  * Type guard to check if a schema is a request schema.
@@ -1335,4 +1394,4 @@ declare const observability: {
   attribute<TSchema extends z.ZodType>(schema: TSchema, attributeName?: string): TSchema;
 };
 //#endregion
-export { type AnyHandler, type AnyMessageContext, AuthenticationError, type BaseMessageContext, type BaseSubjectSchema, type BusNamespaceDefinition, type BusSubjects, type ChannelSubjectSchema, type CollectorOnlySubjectSchema, ConfigError, type ContextForSubjectDefinition, type CreateBusNamespaceOptions, type DefaultTransportsSubjectSchema, DirectoryNotFoundError, type EventContext, type EventHandler, type EventMessagePayload, type EventSchema, type ExtractSubjectPayload, type ExtractSubjectResponse, type FilterOperator, type FilterPayloadFromSchemas, type FilterablePayloadIntersection, type FlatSubjectDefinitions, type HandlerForSubjectDefinition, type HostLocalRequestSubjectSchema, type IConfigStorage, type InferSchemaPayload, type InferSubjectMeta, InvalidModelError, type LocalSubjectSchema, type MakaioBusLike, type MakaioContext, MakaioError, type MessageOrigin, type MessagePayload, ModelUnavailableError, type NamespaceRegistrationOptions, type NestedSubjectDefinitions, OBSERVABILITY_META_KEY, type ObservabilityFieldPolicy, type ObservabilityFieldVisibility, type ObservabilitySchemaPolicy, type OptionalResult, type PayloadFilter, type PrincipalContext, QuotaExceededError, RateLimitError, type RegistrableBusNamespaceDefinition, type RequestContext, type RequestHandler, type RequestMessagePayload, type RequestSchema, type SchemaRecord, type SchemaViolationReport, type ScopedSubjectDefinition, type SubjectDefinition, type SubjectRecord, type SubjectRecordFromSchemaRecord, type SubjectSchema, type TransportPeerContext, type TransportReceiveContext, type TransportRoutingDefault, type TypedPayloadFilter, type WildcardContext, type WildcardSubject, type WildcardSubjectDefinition, WildcardSubjectKey, type WildcardUnifiedHandler, channelSubject, collectorOnlySubject, createBusNamespace, createMakaioContext, defaultTransports, getFullSubjectForSubjectDefinition, getObservabilityFieldPolicy, getObservabilitySchemaPolicy, hostLocalRequest, isChannelSchema, isCollectorOnlySchema, isDefaultTransportsSchema, isHostLocalRequestSchema, isLocalSchema, isOperatorObject, isRequestSchema, localSubject, nestSubjectDefinitions, observability, unwrapSchema };
+export { type AnyHandler, type AnyMessageContext, AuthenticationError, type BaseMessageContext, type BaseSubjectSchema, type BusNamespaceDefinition, type BusSubjects, type ChannelSubjectSchema, type CollectorOnlySubjectSchema, ConfigError, type ContextForSubjectDefinition, type CreateBusNamespaceOptions, type DefaultTransportsSubjectSchema, DirectoryNotFoundError, type EventContext, type EventHandler, type EventMessagePayload, type EventSchema, type ExtractSubjectPayload, type ExtractSubjectResponse, type FilterOperator, type FilterPayloadFromSchemas, type FilterablePayloadIntersection, type FlatSubjectDefinitions, type HandlerForSubjectDefinition, type HostLocalRequestSubjectSchema, type IConfigStorage, type InferSchemaPayload, type InferSubjectMeta, InvalidModelError, type LocalSubjectSchema, type MakaioBusLike, type MakaioContext, MakaioError, type MessageOrigin, type MessagePayload, ModelUnavailableError, type NamespaceRegistrationOptions, type NestedSubjectDefinitions, OBSERVABILITY_META_KEY, type ObservabilityFieldPolicy, type ObservabilityFieldVisibility, type ObservabilitySchemaPolicy, type OptionalResult, type PayloadFilter, type PrincipalContext, QuotaExceededError, RateLimitError, type RegistrableBusNamespaceDefinition, type RequestContext, type RequestHandler, type RequestMessagePayload, type RequestSchema, type SchemaRecord, type SchemaViolationReport, type ScopedSubjectDefinition, type SubjectDefinition, type SubjectKeySegments, type SubjectRecord, type SubjectRecordFromSchemaRecord, type SubjectSchema, type TransportPeerContext, type TransportReceiveContext, type TransportRoutingDefault, type TypedPayloadFilter, type WildcardContext, type WildcardSubject, type WildcardSubjectDefinition, WildcardSubjectKey, type WildcardUnifiedHandler, channelSubject, collectorOnlySubject, createBusNamespace, createMakaioContext, createNamespaceWildcardSubject, defaultTransports, getFullSubjectForSubjectDefinition, getObservabilityFieldPolicy, getObservabilitySchemaPolicy, hostLocalRequest, isChannelSchema, isCollectorOnlySchema, isDefaultTransportsSchema, isHostLocalRequestSchema, isLocalSchema, isOperatorObject, isRequestSchema, localSubject, nestSubjectDefinitions, observability, splitSubjectKey, unwrapSchema };

package/dist/core/index.mjs

@@ -1 +1 @@
-import{z as e}from"zod";function t(e){if(typeof e!=`object`||!e)return!1;let t=e;return`$in`in t||`$ne`in t||`$exists`in t||`$startsWith`in t||`$endsWith`in t}const n=`*`;function r(t){return typeof t==`object`&&!!t&&`request`in t&&`response`in t&&t.request instanceof e.ZodType&&t.response instanceof e.ZodType}function i(e){return typeof e==`object`&&!!e&&`__channel`in e&&e.__channel===!0&&`schema`in e}function a(e){return{__channel:!0,schema:e}}function o(e){return typeof e==`object`&&!!e&&`__local`in e&&e.__local===!0&&`schema`in e}function s(e){return{__local:!0,schema:e}}function c(e){return typeof e==`object`&&!!e&&`__hostLocalRequest`in e&&e.__hostLocalRequest===!0&&`schema`in e}function l(e){return{__hostLocalRequest:!0,schema:e}}function u(e){return typeof e==`object`&&!!e&&`__defaultTransports`in e&&(e.__defaultTransports===`all`||e.__defaultTransports===`local-only`)&&`schema`in e}function d(e,t){return{__defaultTransports:t,schema:e}}function f(e){return typeof e==`object`&&!!e&&`__collectorOnly`in e&&e.__collectorOnly===!0&&`schema`in e}function p(e){return{__collectorOnly:!0,schema:e}}function m(e){return o(e)||f(e)||i(e)||c(e)||u(e)?e.schema:e}function h(e,t,n){let a={};for(let[s,l]of Object.entries(t)){let t=s.split(`.`),d=a;for(let e=0;e<t.length-1;e++)d[t[e]]??={},d=d[t[e]];let f=o(l),p=i(l),h=c(l),g=u(l)?l.__defaultTransports:n,_={subject:s,$meta:{namespace:e,isRequest:r(m(l)),local:f,channel:p,...h&&{hostLocalRequest:h},...g!==void 0&&{defaultTransports:g}}};d[t[t.length-1]]=_}return a.$all={subject:`*`,$meta:{namespace:e,isRequest:!1,local:!1,channel:!1}},a}function g(e){return`${e.$meta.namespace}.${e.subject}`}function _(e,t,n){let r=n?.defaultTransports,i;if(n!==void 0){let{defaultTransports:e,...t}=n;i=Object.keys(t).length>0?t:void 0}return{name:e,subjects:h(e,t,r),schemas:t,...i===void 0?{}:{options:i},...r===void 0?{}:{defaultTransports:r}}}e.object({cwd:e.string(),env:e.record(e.string(),e.string()),platform:e.enum([`posix`,`windows`]),signal:e.custom().optional(),constraints:e.record(e.string(),e.unknown()).optional(),sessionId:e.string().optional(),subagentId:e.string().optional(),subagentDepth:e.number().optional()});function v(){return typeof process>`u`?`posix`:process.platform===`win32`?`windows`:`posix`}const y=[`API_KEY`,`APIKEY`,`SECRET`,`TOKEN`,`PASSWORD`,`CREDENTIAL`,`PRIVATE_KEY`,`PRIVATEKEY`,`AUTH`,`BEARER`,`ACCESS_KEY`,`ACCESSKEY`];function b(e){let t=e.toUpperCase();return y.some(e=>t.includes(e))}function x(e){let t={};for(let[n,r]of Object.entries(e))r!==void 0&&!b(n)&&(t[n]=r);return t}function S(e){let t=typeof process<`u`?process.cwd():`/`,n=typeof process<`u`?x(process.env):{};return{cwd:e?.cwd??t,env:e?.env??n,platform:e?.platform??v(),signal:e?.signal,constraints:e?.constraints,sessionId:e?.sessionId,subagentId:e?.subagentId,subagentDepth:e?.subagentDepth}}var C=class extends Error{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},w=class extends C{subject;constructor(e,t){super(`Invalid model specified: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},T=class extends C{subject;constructor(e,t){super(`Directory does not exist: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},E=class extends C{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},D=class extends C{code=`rate_limit`},O=class extends C{code=`auth`},k=class extends C{code=`model_unavailable`},A=class extends C{code=`quota_exceeded`};const j=`makaio.observability`;function M(e){let t=e.meta()?.[j];if(typeof t!=`object`||!t)return;let n=t;return n.kind===`schema`||n.kind===`field`?n:void 0}function N(e,t){return e.meta({...e.meta(),[j]:t})}function P(t){if(t instanceof e.ZodOptional||t instanceof e.ZodNullable||t instanceof e.ZodDefault||t instanceof e.ZodCatch||t instanceof e.ZodReadonly)return t.unwrap()}function F(e){let t=e;for(;t;){let e=M(t);if(e?.kind===`field`)return e;t=P(t)}}function I(e){let t=M(e);if(t?.kind===`schema`)return{traceAll:t.traceAll}}function L(e){let t=F(e);if(t)return{visibility:t.visibility,attributeName:t.attributeName}}const R={schema(e,t){return N(e,{kind:`schema`,traceAll:t.traceAll})},field(e,t){return N(e,{kind:`field`,visibility:t.visibility,attributeName:t.attributeName})},hidden(e){return N(e,{kind:`field`,visibility:`hidden`})},count(e,t){return N(e,{kind:`field`,visibility:`count`,attributeName:t})},attribute(e,t){return N(e,{kind:`field`,visibility:`attribute`,attributeName:t})}};export{O as AuthenticationError,E as ConfigError,T as DirectoryNotFoundError,w as InvalidModelError,C as MakaioError,k as ModelUnavailableError,j as OBSERVABILITY_META_KEY,A as QuotaExceededError,D as RateLimitError,n as WildcardSubjectKey,a as channelSubject,p as collectorOnlySubject,_ as createBusNamespace,S as createMakaioContext,d as defaultTransports,g as getFullSubjectForSubjectDefinition,L as getObservabilityFieldPolicy,I as getObservabilitySchemaPolicy,l as hostLocalRequest,i as isChannelSchema,f as isCollectorOnlySchema,u as isDefaultTransportsSchema,c as isHostLocalRequestSchema,o as isLocalSchema,t as isOperatorObject,r as isRequestSchema,s as localSubject,h as nestSubjectDefinitions,R as observability,m as unwrapSchema};
+import{z as e}from"zod";function t(e){if(typeof e!=`object`||!e)return!1;let t=e;return`$in`in t||`$ne`in t||`$exists`in t||`$startsWith`in t||`$endsWith`in t}const n=`*`;function r(e){return{subject:`*`,$meta:{namespace:e,isRequest:!1,payload:{},local:!1,channel:!1}}}function i(t){return typeof t==`object`&&!!t&&`request`in t&&`response`in t&&t.request instanceof e.ZodType&&t.response instanceof e.ZodType}function a(e){return typeof e==`object`&&!!e&&`__channel`in e&&e.__channel===!0&&`schema`in e}function o(e){return{__channel:!0,schema:e}}function s(e){return typeof e==`object`&&!!e&&`__local`in e&&e.__local===!0&&`schema`in e}function c(e){return{__local:!0,schema:e}}function l(e){return typeof e==`object`&&!!e&&`__hostLocalRequest`in e&&e.__hostLocalRequest===!0&&`schema`in e}function u(e){return{__hostLocalRequest:!0,schema:e}}function d(e){return typeof e==`object`&&!!e&&`__defaultTransports`in e&&(e.__defaultTransports===`all`||e.__defaultTransports===`local-only`)&&`schema`in e}function f(e,t){return{__defaultTransports:t,schema:e}}function p(e){return typeof e==`object`&&!!e&&`__collectorOnly`in e&&e.__collectorOnly===!0&&`schema`in e}function m(e){return{__collectorOnly:!0,schema:e}}function h(e){return s(e)||p(e)||a(e)||l(e)||d(e)?e.schema:e}function g(e,t,n){let o={};for(let[r,c]of Object.entries(t)){let t=r.split(`.`),u=o;for(let e=0;e<t.length-1;e++)u[t[e]]??={},u=u[t[e]];let f=s(c),p=a(c),m=l(c),g=d(c)?c.__defaultTransports:n,_={subject:r,$meta:{namespace:e,isRequest:i(h(c)),local:f,channel:p,...m&&{hostLocalRequest:m},...g!==void 0&&{defaultTransports:g}}};u[t[t.length-1]]=_}return o.$all=r(e),o}function _(e){return`${e.$meta.namespace}.${e.subject}`}function v(e){let t=e.indexOf(`.`);if(!(t<=0||t===e.length-1))return{namespace:e.slice(0,t),subject:e.slice(t+1)}}function y(e,t,n){let r=n?.defaultTransports,i;if(n!==void 0){let{defaultTransports:e,...t}=n;i=Object.keys(t).length>0?t:void 0}return{name:e,subjects:g(e,t,r),schemas:t,...i===void 0?{}:{options:i},...r===void 0?{}:{defaultTransports:r}}}e.object({cwd:e.string(),env:e.record(e.string(),e.string()),platform:e.enum([`posix`,`windows`]),signal:e.custom().optional(),constraints:e.record(e.string(),e.unknown()).optional(),sessionId:e.string().optional(),subagentId:e.string().optional(),subagentDepth:e.number().optional()});function b(){return typeof process>`u`?`posix`:process.platform===`win32`?`windows`:`posix`}const x=[`API_KEY`,`APIKEY`,`SECRET`,`TOKEN`,`PASSWORD`,`CREDENTIAL`,`PRIVATE_KEY`,`PRIVATEKEY`,`AUTH`,`BEARER`,`ACCESS_KEY`,`ACCESSKEY`];function S(e){let t=e.toUpperCase();return x.some(e=>t.includes(e))}function C(e){let t={};for(let[n,r]of Object.entries(e))r!==void 0&&!S(n)&&(t[n]=r);return t}function w(e){let t=typeof process<`u`?process.cwd():`/`,n=typeof process<`u`?C(process.env):{};return{cwd:e?.cwd??t,env:e?.env??n,platform:e?.platform??b(),signal:e?.signal,constraints:e?.constraints,sessionId:e?.sessionId,subagentId:e?.subagentId,subagentDepth:e?.subagentDepth}}var T=class extends Error{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},E=class extends T{subject;constructor(e,t){super(`Invalid model specified: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},D=class extends T{subject;constructor(e,t){super(`Directory does not exist: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},O=class extends T{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},k=class extends T{code=`rate_limit`},A=class extends T{code=`auth`},j=class extends T{code=`model_unavailable`},M=class extends T{code=`quota_exceeded`};const N=`makaio.observability`;function P(e){let t=e.meta()?.[N];if(typeof t!=`object`||!t)return;let n=t;return n.kind===`schema`||n.kind===`field`?n:void 0}function F(e,t){return e.meta({...e.meta(),[N]:t})}function I(t){if(t instanceof e.ZodOptional||t instanceof e.ZodNullable||t instanceof e.ZodDefault||t instanceof e.ZodCatch||t instanceof e.ZodReadonly)return t.unwrap()}function L(e){let t=e;for(;t;){let e=P(t);if(e?.kind===`field`)return e;t=I(t)}}function R(e){let t=P(e);if(t?.kind===`schema`)return{traceAll:t.traceAll}}function z(e){let t=L(e);if(t)return{visibility:t.visibility,attributeName:t.attributeName}}const B={schema(e,t){return F(e,{kind:`schema`,traceAll:t.traceAll})},field(e,t){return F(e,{kind:`field`,visibility:t.visibility,attributeName:t.attributeName})},hidden(e){return F(e,{kind:`field`,visibility:`hidden`})},count(e,t){return F(e,{kind:`field`,visibility:`count`,attributeName:t})},attribute(e,t){return F(e,{kind:`field`,visibility:`attribute`,attributeName:t})}};export{A as AuthenticationError,O as ConfigError,D as DirectoryNotFoundError,E as InvalidModelError,T as MakaioError,j as ModelUnavailableError,N as OBSERVABILITY_META_KEY,M as QuotaExceededError,k as RateLimitError,n as WildcardSubjectKey,o as channelSubject,m as collectorOnlySubject,y as createBusNamespace,w as createMakaioContext,r as createNamespaceWildcardSubject,f as defaultTransports,_ as getFullSubjectForSubjectDefinition,z as getObservabilityFieldPolicy,R as getObservabilitySchemaPolicy,u as hostLocalRequest,a as isChannelSchema,p as isCollectorOnlySchema,d as isDefaultTransportsSchema,l as isHostLocalRequestSchema,s as isLocalSchema,t as isOperatorObject,i as isRequestSchema,c as localSubject,g as nestSubjectDefinitions,B as observability,v as splitSubjectKey,h as unwrapSchema};

package/dist/definition-BYgHlmMw.d.mts

@@ -0,0 +1,375 @@
+import { a as JsonValue$1 } from "./json-value-C1RGgS0a.mjs";
+import { z } from "zod";
+import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
+
+//#region core/contracts/src/automation-trigger/schemas.d.ts
+/** Dot-separated local portion of an automation trigger kind. */
+declare const AutomationTriggerLocalNameSchema$1: z.ZodString;
+declare const AutomationTriggerKindSchema: z.ZodString;
+/**
+ * Serializable descriptor advertising a contributed automation trigger.
+ *
+ * Carries only discoverable metadata and derived JSON Schema representations of
+ * the parameter and event shapes. The live Zod schemas and activate function are
+ * never serialized — runtime truth is always the live {@link AutomationTriggerType}
+ * contributed by the owning extension.
+ */
+declare const AutomationTriggerDescriptorSchema: z.ZodObject<{
+  kind: z.ZodString;
+  label: z.ZodString;
+  description: z.ZodString;
+  categories: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+  parameterSchema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+  eventSchema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+  workflowCompatible: z.ZodBoolean;
+}, z.core.$strip>;
+/** Serializable descriptor advertising a contributed automation trigger. */
+type AutomationTriggerDescriptor$1 = z.infer<typeof AutomationTriggerDescriptorSchema>;
+/**
+ * Serializable binding reference linking an active automation trigger to its
+ * configuration parameters.
+ *
+ * Validated as a JSON-safe record so bindings stay serializable and can be
+ * persisted in workflow definitions.
+ */
+declare const AutomationTriggerBindingSchema: z.ZodObject<{
+  kind: z.ZodString;
+  params: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
+}, z.core.$strip>;
+//#endregion
+//#region core/contracts/src/automation-trigger/definition.d.ts
+/**
+ * JSON-compatible parameter map passed to a trigger's {@link AutomationTriggerType.activate}
+ * function.
+ */
+type AutomationTriggerParams = Readonly<Record<string, JsonValue$1>>;
+/**
+ * JSON-compatible payload produced by a trigger's live event schema and
+ * delivered to listeners after an {@link AutomationTriggerActivationContext.emit}
+ * call.
+ */
+type AutomationTriggerPayload = JsonValue$1;
+/**
+ * Cleanup function returned by {@link AutomationTriggerType.activate}.
+ *
+ * Called by the runtime when the trigger binding is detached or the runtime
+ * shuts down. May be synchronous or asynchronous.
+ *
+ * **Lifecycle ordering invariant:** the runtime aborts the activation
+ * {@link AutomationTriggerActivationContext.signal} and then awaits this
+ * cleanup. Implementations must be idempotent — the runtime calls this at most
+ * once, but implementations should tolerate a double-disposal without error to
+ * allow defensive guard callers. Use the returned cleanup as the primary
+ * teardown mechanism; use `signal` only for cancelling in-flight async work.
+ */
+type AutomationTriggerCleanup$1 = () => void | Promise<void>;
+/**
+ * Listener registered for automation trigger events.
+ *
+ * Called each time the active trigger emits via its activation context.
+ * @param event - Fully typed trigger event envelope.
+ * @returns `void` or a `Promise<void>` to allow async side-effects.
+ */
+type AutomationTriggerListener$1 = (event: AutomationTriggerEvent) => void | Promise<void>;
+/**
+ * Serializable reference to an active trigger binding.
+ *
+ * Stores the canonical trigger {@link kind} and the JSON-safe parameter input
+ * that the runtime parses before calling {@link AutomationTriggerType.activate}.
+ * Bindings are persisted in workflow definitions; runtime truth is always the
+ * live trigger.
+ */
+interface AutomationTriggerBinding$1 {
+  /** Canonical trigger kind, optionally owned by an npm-scoped extension. */
+  readonly kind: string;
+  /** JSON-safe parameter schema input for this binding. */
+  readonly params: Readonly<Record<string, JsonValue$1>>;
+}
+/**
+ * Event envelope emitted by an active automation trigger.
+ *
+ * Produced by the trigger's activation context {@link AutomationTriggerActivationContext.emit}
+ * and delivered to registered {@link AutomationTriggerListener}s.
+ * @typeParam TPayload - JSON-compatible event payload shape.
+ */
+interface AutomationTriggerEvent<TPayload extends JsonValue$1 = JsonValue$1> {
+  /** Canonical trigger kind that emitted this event. */
+  readonly kind: string;
+  /** Event payload validated by the trigger's live `eventSchema`. */
+  readonly payload: Readonly<TPayload>;
+  /**
+   * UNIX epoch milliseconds when the trigger observed the underlying event.
+   *
+   * Stamped by the binding runtime when it accepts the emitted value; used for
+   * ordering and diagnostics.
+   */
+  readonly observedAt: number;
+  /**
+   * Optional propagated correlation identifier.
+   *
+   * Present when the triggering source carries correlation context
+   * (e.g. a webhook request with a trace header).
+   */
+  readonly correlationId?: string;
+}
+/**
+ * Context supplied to a trigger's {@link AutomationTriggerType.activate} function.
+ *
+ * Provides the activation's identity, lifecycle management (via `signal`), and
+ * the typed emit channel for delivering events to the runtime's event bus.
+ * @typeParam TPayloadInput - Input accepted by the trigger's live `eventSchema`.
+ *   The runtime parses this value before listeners receive its JSON-safe output.
+ */
+interface AutomationTriggerActivationContext<TPayloadInput = JsonValue$1> {
+  /**
+   * Canonical sharing key of the activation this context belongs to.
+   *
+   * Supplied by the runtime, which derived it from `<kind>` and the parsed,
+   * canonicalized parameters — the same key that decides which bindings share this
+   * activation. A trigger that has to name its activation to a collaborator (a
+   * scheduler being handed a job, a log line attributing a failure) reports this
+   * value instead of re-deriving one, which is what keeps a trigger's notion of
+   * its own identity from drifting from the runtime's.
+   *
+   * **Not a unique index over time:** the runtime may briefly hold a retiring and
+   * a fresh activation of the same key, so a collaborator must key its own state
+   * on the activation it was handed, not on this string.
+   */
+  readonly bindingKey: string;
+  /**
+   * Abort signal that is aborted when the trigger binding is detached or the
+   * runtime shuts down.
+   *
+   * **Lifecycle ordering invariant:** the runtime aborts this signal first,
+   * then awaits the {@link AutomationTriggerCleanup} returned by
+   * {@link AutomationTriggerType.activate}. Implementations should use
+   * `signal` only for cancelling in-flight async work (e.g. passing it to
+   * `fetch`). Use the returned cleanup as the primary teardown mechanism for
+   * releasing subscriptions or handles.
+   */
+  readonly signal: AbortSignal;
+  /**
+   * Emits a trigger event to the runtime's event bus.
+   * @param payload - Event payload input validated and transformed by the
+   *   trigger's live `eventSchema`.
+   * @param metadata - Optional envelope metadata to attach to the emitted event.
+   * @returns Resolves when the event has been accepted by the bus.
+   */
+  readonly emit: (payload: TPayloadInput, metadata?: {
+    readonly correlationId?: string;
+  }) => Promise<void>;
+}
+/**
+ * Handle representing a currently active trigger subscription.
+ *
+ * Returned by the trigger registry's `subscribe` method. Callers retain this
+ * to detach the subscription cleanly.
+ */
+interface AutomationTriggerSubscription$1 {
+  /** Stable key identifying this binding instance. */
+  readonly bindingKey: string;
+  /**
+   * Detaches the subscription, stopping the trigger and releasing resources.
+   * @returns Resolves when the trigger cleanup is complete.
+   */
+  readonly detach: () => Promise<void>;
+}
+/**
+ * Type-erased automation trigger stored in the registry.
+ *
+ * This is the shape that contribution processors and the trigger registry
+ * consume after generic types are erased. Typed authoring happens through
+ * {@link DefinedAutomationTrigger} and {@link defineAutomationTrigger}.
+ *
+ * The live `paramsSchema`, `eventSchema`, and `activate` are function-carrying
+ * runtime values and must never be included in serializable descriptor
+ * metadata — {@link createAutomationTriggerDescriptor} produces the only
+ * serializable representation.
+ */
+interface AutomationTriggerType$1 {
+  /** Canonical trigger kind, optionally owned by an npm-scoped extension. */
+  readonly kind: string;
+  /** Human-readable label shown in the Builder UI. */
+  readonly label: string;
+  /** Human-readable description of what this trigger emits and when. */
+  readonly description: string;
+  /** Categorization tags for grouping triggers in the Builder UI. */
+  readonly categories: readonly string[];
+  /**
+   * Live Zod schema for the trigger's activation parameters.
+   *
+   * The runtime validates binding params against this schema before calling
+   * {@link activate}.
+   */
+  readonly paramsSchema: z.ZodType<Record<string, JsonValue$1>>;
+  /**
+   * Live Zod schema for the trigger's emitted event payload.
+   *
+   * The activation context validates emitted payloads against this schema
+   * before delivering them to listeners.
+   *
+   * The activation context accepts the schema's input type. The runtime parses
+   * each emitted value exactly once and delivers the schema's JSON-compatible
+   * output to listeners, so transforms may change the payload shape.
+   */
+  readonly eventSchema: z.ZodType<JsonValue$1>;
+  /**
+   * Activates the trigger with the supplied binding parameters.
+   *
+   * Called by the runtime after validating `params` through {@link paramsSchema}.
+   * The implementation must return a cleanup function that stops the trigger
+   * when called.
+   * Declared as a readonly **property** rather than a method so that
+   * `strictFunctionTypes` checks its parameters contravariantly: a trigger that
+   * declares narrower `params` than the registry-boundary contract (for example
+   * `params: { repo: string }` alongside `paramsSchema: z.object({})`) must not
+   * type-check as an `AutomationTriggerType`. Method shorthand would make the
+   * parameters bivariant and silently admit that mismatch.
+   * @param context - Activation context with lifecycle signal and emit channel.
+   * @param params - Schema-validated binding parameters.
+   * @returns Cleanup function called on trigger deactivation.
+   */
+  readonly activate: (context: AutomationTriggerActivationContext<unknown>, params: AutomationTriggerParams) => Promise<AutomationTriggerCleanup$1>;
+}
+/**
+ * Typed automation trigger definition authored by an extension.
+ *
+ * Preserves typed `paramsSchema`, `eventSchema`, and `activate` through the
+ * authoring surface before generics are erased to {@link AutomationTriggerType}
+ * at the registry boundary. Extensions declare triggers using
+ * {@link defineAutomationTrigger}, which validates and caches the descriptor
+ * at definition time.
+ * @typeParam TParamsSchema - Live Zod schema for the parameter shape.
+ * @typeParam TEventSchema - Live Zod schema for the emitted event payload.
+ */
+interface DefinedAutomationTrigger<TParamsSchema extends z.ZodType<AutomationTriggerParams>, TEventSchema extends z.ZodType<AutomationTriggerPayload>> extends Omit<AutomationTriggerType$1, 'paramsSchema' | 'eventSchema' | 'activate'> {
+  /** Live Zod schema for the trigger's activation parameters. */
+  readonly paramsSchema: TParamsSchema;
+  /**
+   * Live Zod schema for the trigger's emitted event payload.
+   *
+   * Schema input is accepted by the typed emit channel; schema output must be
+   * JSON-compatible for listener delivery.
+   */
+  readonly eventSchema: TEventSchema;
+  /**
+   * Activates the trigger with the supplied typed binding parameters.
+   * @param context - Activation context with typed emit channel.
+   * @param params - Schema-validated binding parameters matching `TParamsSchema`.
+   * @returns Cleanup function called on trigger deactivation.
+   */
+  readonly activate: (context: AutomationTriggerActivationContext<z.input<TEventSchema>>, params: z.output<TParamsSchema>) => Promise<AutomationTriggerCleanup$1>;
+}
+/**
+ * Minimal trigger-like shape required to produce an
+ * {@link AutomationTriggerDescriptor}.
+ *
+ * Both {@link AutomationTriggerType} and
+ * {@link DefinedAutomationTrigger} satisfy this interface because descriptor
+ * production only requires the presentation fields and the two live schemas —
+ * not the `activate` function.
+ */
+interface AutomationTriggerDescriptorSource {
+  readonly kind: string;
+  readonly label: string;
+  readonly description: string;
+  readonly categories: readonly string[];
+  readonly paramsSchema: z.ZodType<AutomationTriggerParams>;
+  readonly eventSchema: z.ZodType<AutomationTriggerPayload>;
+}
+/**
+ * Creates a validated, serializable {@link AutomationTriggerDescriptor} from a
+ * trigger definition.
+ *
+ * This is the only supported path for producing serializable trigger
+ * metadata. Extensions do NOT implement a `toDescriptor()` method — the
+ * framework derives the descriptor from the live schemas to guarantee that
+ * Builder metadata cannot drift from runtime truth.
+ *
+ * Results are cached on the trigger object and returned as detached clones so
+ * mutations by callers never affect subsequent discovery.
+ * @param trigger - Trigger definition or type-erased registry entry.
+ * @returns A detached {@link AutomationTriggerDescriptor} snapshot.
+ * @throws When the trigger's `kind` fails {@link AutomationTriggerKindSchema}
+ *   or either schema cannot be projected to JSON Schema.
+ */
+declare function createAutomationTriggerDescriptor$1(trigger: AutomationTriggerDescriptorSource): AutomationTriggerDescriptor$1;
+/**
+ * Defines a typed automation trigger and validates it at definition time.
+ *
+ * The returned definition is the typed authoring representation; it preserves
+ * typed `paramsSchema`, `eventSchema`, and `activate` until the caller erases
+ * generics to {@link AutomationTriggerType} at the registry boundary.
+ *
+ * Validation steps performed eagerly:
+ * 1. {@link AutomationTriggerKindSchema} rejects invalid kind formats.
+ * 2. {@link createAutomationTriggerDescriptor} validates that both schemas can
+ *    be projected to JSON Schema and caches the result, so discovery never fails.
+ * @typeParam TParamsSchema - Live Zod schema for the parameter shape.
+ * @typeParam TEventSchema - Live Zod schema for the emitted event payload.
+ * @param definition - Full typed trigger definition authored by the extension.
+ * @returns The same `definition` object, frozen and type-preserved for the
+ *   contribution surface. The returned object is shallowly frozen so that
+ *   mutations to `label`, schemas, or other fields after definition time cannot
+ *   silently diverge from the eagerly cached descriptor.
+ * @throws When `kind` is not a valid canonical trigger kind string, or when either
+ *   schema cannot be projected to a JSON-safe JSON Schema record.
+ * @example
+ * ```ts
+ * export const profileChangedTrigger = defineAutomationTrigger({
+ *   kind: 'makaio.profile-changed',
+ *   label: 'Profile Changed',
+ *   description: 'Fires when the authenticated user profile changes.',
+ *   categories: ['Identity'],
+ *   paramsSchema: z.object({}),
+ *   eventSchema: z.object({ userId: z.string() }),
+ *   activate: async (ctx) => {
+ *     // Prefer returning a cleanup function as the primary teardown mechanism.
+ *     // Use ctx.signal only for cancelling in-flight async work.
+ *     const off = bus.on('profile.changed', (e) => {
+ *       void ctx.emit({ userId: e.userId });
+ *     });
+ *     // Return the cleanup — the runtime awaits it after aborting ctx.signal.
+ *     return off;
+ *   },
+ * });
+ * ```
+ */
+declare function defineAutomationTrigger$1<TParamsSchema extends z.ZodType<AutomationTriggerParams>, TEventSchema extends z.ZodType<AutomationTriggerPayload>>(definition: DefinedAutomationTrigger<TParamsSchema, TEventSchema>): DefinedAutomationTrigger<TParamsSchema, TEventSchema>;
+/**
+ * Erases the typed generics on a {@link DefinedAutomationTrigger} to the
+ * registry-boundary {@link AutomationTriggerType}.
+ *
+ * **How the erasure compiles.** `DefinedAutomationTrigger.activate` accepts the
+ * narrow `z.output<TParamsSchema>` while `AutomationTriggerType.activate`
+ * accepts the wide `AutomationTriggerParams`. Both are readonly properties, so
+ * `strictFunctionTypes` compares them contravariantly and correctly rejects the
+ * narrow signature as a direct assignment — that strictness is deliberate: it
+ * is what stops a hand-written trigger from declaring narrower `params` than its
+ * own `paramsSchema` produces. The erasure is therefore expressed as an
+ * overload: this public signature accepts the typed definition, while the
+ * implementation signature below is the wide {@link AutomationTriggerType}, so
+ * the widening happens in the signature relation rather than through a type
+ * assertion. Keeping the erasure here means no extension author casts — or even
+ * mentions the erased type — at their own call site.
+ *
+ * **Why the erasure is safe at runtime.** The binding runtime parses binding
+ * parameters through `paramsSchema` (and projects them through the shared JSON
+ * schemas) before calling `activate`, and parses every emitted payload through
+ * `eventSchema` before fanning it out to listeners. The narrow typed signature
+ * is therefore only ever invoked with values its own schema produced.
+ *
+ * **Object identity is preserved:** the returned value IS the same object
+ * reference. The {@link descriptorCache} WeakMap in
+ * {@link createAutomationTriggerDescriptor} is keyed on object identity; a
+ * spread copy would defeat the definition-time descriptor caching and break the
+ * fail-fast guarantee that discovery can never throw.
+ * @typeParam TParamsSchema - Live Zod schema for the parameter shape.
+ * @typeParam TEventSchema - Live Zod schema for the emitted event payload.
+ * @param definition - A typed trigger definition produced by
+ *   {@link defineAutomationTrigger}.
+ * @returns The same object reference, widened to {@link AutomationTriggerType}.
+ */
+declare function toAutomationTriggerType$1<TParamsSchema extends z.ZodType<AutomationTriggerParams>, TEventSchema extends z.ZodType<AutomationTriggerPayload>>(definition: DefinedAutomationTrigger<TParamsSchema, TEventSchema>): AutomationTriggerType$1;
+//#endregion
+export { AutomationTriggerKindSchema as _, AutomationTriggerListener$1 as a, AutomationTriggerSubscription$1 as c, createAutomationTriggerDescriptor$1 as d, defineAutomationTrigger$1 as f, AutomationTriggerDescriptorSchema as g, AutomationTriggerDescriptor$1 as h, AutomationTriggerEvent as i, AutomationTriggerType$1 as l, AutomationTriggerBindingSchema as m, AutomationTriggerBinding$1 as n, AutomationTriggerParams as o, toAutomationTriggerType$1 as p, AutomationTriggerCleanup$1 as r, AutomationTriggerPayload as s, AutomationTriggerActivationContext as t, DefinedAutomationTrigger as u, AutomationTriggerLocalNameSchema$1 as v };

package/dist/{definition-CJfiv8xm.mjs → definition-CDg-Jq1T.mjs}

@@ -1 +1 @@
-import{t as e}from"./json-value-DmU8ibo_.mjs";import{i as t,t as n}from"./visibility-qhGWmpSJ.mjs";import{f as r}from"./definitions-xrrY0wgz.mjs";import{z as i}from"zod";const a=i.enum([`anthropic`,`openai`]),o=i.object({anthropic:i.string().url(),openai:i.string().url()}).partial().refine(e=>Object.keys(e).length>0,{message:`At least one protocol endpoint must be specified`}),s=e,c=i.object({id:i.string().min(1),name:i.string().min(1),description:i.string().optional(),endpoints:o.optional(),defaultModel:i.string().optional(),fastModel:i.string().optional(),primaryTestModel:i.string().optional(),secondaryTestModel:i.string().optional(),availableModels:i.array(t).default([]),defaultModelFilterMode:n.optional(),authMethods:r,capabilities:s.optional()}).strict();export{c as i,a as n,s as r,o as t};
+import{t as e}from"./json-value-D57aJhVn.mjs";import{i as t,t as n}from"./visibility-Dl1o2I01.mjs";import{f as r}from"./definitions-CF6YmEhL.mjs";import{z as i}from"zod";const a=i.enum([`anthropic`,`openai`]),o=i.object({anthropic:i.string().url(),openai:i.string().url()}).partial().refine(e=>Object.keys(e).length>0,{message:`At least one protocol endpoint must be specified`}),s=e,c=i.object({id:i.string().min(1),name:i.string().min(1),description:i.string().optional(),endpoints:o.optional(),defaultModel:i.string().optional(),fastModel:i.string().optional(),primaryTestModel:i.string().optional(),secondaryTestModel:i.string().optional(),availableModels:i.array(t).default([]),defaultModelFilterMode:n.optional(),authMethods:r,capabilities:s.optional()}).strict();export{c as i,a as n,s as r,o as t};

package/dist/{detached-extension-handle-Ddfquy5_.mjs → detached-extension-handle-DKd17UB6.mjs}

@@ -1 +1 @@
-import{t as e}from"./descriptor-to-package-DvF08krT.mjs";import{t}from"./jsonl-transport-bQl3JwIu.mjs";import{z as n}from"zod";import{createBusNamespace as r}from"@makaio/framework/core";const i={idle:[`starting`],starting:[`running`,`crashed`,`stopping`],running:[`stopping`,`crashed`],stopping:[`stopped`],stopped:[`starting`],crashed:[`starting`,`stopped`]};function a(e,t){if(!i[e].includes(t))throw Error(`Invalid state transition: ${e} → ${t}`)}function o(e){return new Promise(t=>{if(e.exitCode!==null||e.signalCode!==null){t(!0);return}e.once(`exit`,()=>t(!0))})}function s(e){let{spawn:n,healthTimeoutMs:r=3e4,shutdownTimeoutMs:i=5e3,restartPolicy:s=`none`,onReady:c,onExit:l,onStateChange:u}=e,d=`idle`,f;function p(e){a(d,e),d=e,u?.(d)}function m(e){let t=f;if(f=void 0,t?.close(),d===`stopping`){p(`stopped`),l?.(e);return}if(d===`running`){if(e!==0){p(`crashed`),l?.(e),(s===`on-crash`||s===`always`)&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)});return}p(`stopping`),p(`stopped`),l?.(e),s===`always`&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)})}}async function h(){p(`starting`);let e=t(n);f=e;let i=e.process;await new Promise((t,a)=>{let o=!1;function s(e){o||(o=!0,clearTimeout(u),d(),i.off(`exit`,h),e())}let u=setTimeout(()=>{s(()=>{e.close(),f=void 0;try{p(`crashed`)}catch{}a(Error(`Process health timeout after ${r}ms: ${n.processName??n.command}`))})},r),d=e.onMessage(()=>{s(()=>{try{p(`running`)}catch(e){a(e);return}c?.(),i.once(`exit`,m),t()})});function h(e){s(()=>{f=void 0;try{p(`crashed`)}catch{}l?.(e),a(Error(`Process exited with code ${String(e)} before signaling readiness`))})}i.once(`exit`,h)})}async function g(){if(d===`stopped`||d===`idle`)return;if(d===`crashed`){f?.close(),f=void 0,p(`stopped`);return}if(d!==`stopping`&&p(`stopping`),!f){d===`stopping`&&p(`stopped`);return}let e=f,t=e.process;if(t.exitCode!==null){e.close(),f===e&&(f=void 0),d===`stopping`&&p(`stopped`);return}t.kill(`SIGTERM`);let n;await Promise.race([o(t).then(()=>(clearTimeout(n),!0)),new Promise(e=>{n=setTimeout(()=>e(!1),i)})])||(t.kill(`SIGKILL`),await o(t)),d===`stopping`&&p(`stopped`),e.close(),f===e&&(f=void 0)}return{get transport(){return f},get state(){return d},start:h,stop:g}}const c=n.object({dataDir:n.string().optional(),machineId:n.string().optional(),makaioHome:n.string().optional(),platform:n.string().optional(),username:n.string().optional()}),l={init:{request:n.object({config:n.unknown().optional(),context:c.optional()}),response:n.object({ready:n.boolean()})},ready:n.object({ready:n.boolean(),config:n.unknown().optional(),context:c.optional()}).passthrough(),destroy:{request:n.object({reason:n.string().optional()}),response:n.object({stopped:n.boolean()})},stopped:n.object({stopped:n.boolean()}).passthrough()};function u(e,t){return e.bus.registerNamespace(r(`extension.${t}`,l)).subjects}function d(e,t){let n;return()=>(n??=u(e,t),n)}function f(e){return{dataDir:e.dataDir,machineId:e.machineId,makaioHome:e.makaioHome,platform:e.platform,username:e.username}}var p=class{descriptor;ctx;extensionPath;getLifecycleSubjects;transport=null;unregister=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{StdioServerTransport:e}=await import(`./src-DD0v-nIj.mjs`),{transport:t}=this.descriptor,n=this.getLifecycleSubjects(),r=new e({name:this.descriptor.name,spawn:{command:t.command,args:t.args,cwd:this.extensionPath,env:t.env,processName:this.descriptor.name}}),i=null;try{let e=this.ctx.bus.registerTransport(r);i=e.unregister,await r.connect(),await r.ready,await e.ready,this.transport=r,this.unregister=i,await this.ctx.bus.request(n.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:t.healthTimeoutMs})}catch(e){throw i?.(),await r.disconnect(),this.transport=null,this.unregister=null,e}}async destroy(){if(this.transport!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before disconnect:`,e instanceof Error?e.message:e)}}this.unregister?.(),this.unregister=null,await this.transport?.disconnect(),this.transport=null}},m=class{descriptor;ctx;extensionPath;getLifecycleSubjects;lifecycle=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{transport:e}=this.descriptor;if(!this.ctx.busUrl)throw Error(`[extensions] ${this.descriptor.name}: bus-websocket transport requires NodeExtensionContext.busUrl`);let t=this.getLifecycleSubjects();this.lifecycle=s({spawn:{command:e.command,args:e.args,cwd:this.extensionPath,env:{...e.env,MAKAIO_BUS_TRANSPORT:`websocket`,MAKAIO_BUS_URL:this.ctx.busUrl,MAKAIO_EXTENSION_NAME:this.descriptor.name},processName:this.descriptor.name},healthTimeoutMs:e.healthTimeoutMs,shutdownTimeoutMs:e.shutdownTimeoutMs,restartPolicy:`restartPolicy`in e?e.restartPolicy:void 0});try{await this.lifecycle.start(),await this.ctx.bus.request(t.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:e.healthTimeoutMs})}catch(e){throw await this.lifecycle.stop(),this.lifecycle=null,e}}async destroy(){if(this.lifecycle!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before process stop:`,e instanceof Error?e.message:e)}await this.lifecycle.stop(),this.lifecycle=null}}},h=class{descriptor;ctx;extensionPath;bridge=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n}async init(){let{startMcpClientBridge:e}=await import(`@makaio/framework/mcp-http-server`),{transport:t}=this.descriptor;this.bridge=await e({command:t.command,args:t.args,env:t.env,cwd:this.extensionPath,extensionName:this.descriptor.name,bus:this.ctx.bus})}async destroy(){this.bridge!==null&&(await this.bridge.close(),this.bridge=null)}};function g(t,n){return{...e(t),create(e){return t.transport.type===`bus-stdio`?new p(t,e,n):t.transport.type===`mcp-stdio`?new h(t,e,n):new m(t,e,n)}}}export{g as createDetachedExtensionPackage};
+import{t as e}from"./descriptor-to-package-BecVCopf.mjs";import{t}from"./jsonl-transport-Bp_6pB2a.mjs";import{z as n}from"zod";import{createBusNamespace as r}from"@makaio/framework/core";const i={idle:[`starting`],starting:[`running`,`crashed`,`stopping`],running:[`stopping`,`crashed`],stopping:[`stopped`],stopped:[`starting`],crashed:[`starting`,`stopped`]};function a(e,t){if(!i[e].includes(t))throw Error(`Invalid state transition: ${e} → ${t}`)}function o(e){return new Promise(t=>{if(e.exitCode!==null||e.signalCode!==null){t(!0);return}e.once(`exit`,()=>t(!0))})}function s(e){let{spawn:n,healthTimeoutMs:r=3e4,shutdownTimeoutMs:i=5e3,restartPolicy:s=`none`,onReady:c,onExit:l,onStateChange:u}=e,d=`idle`,f;function p(e){a(d,e),d=e,u?.(d)}function m(e){let t=f;if(f=void 0,t?.close(),d===`stopping`){p(`stopped`),l?.(e);return}if(d===`running`){if(e!==0){p(`crashed`),l?.(e),(s===`on-crash`||s===`always`)&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)});return}p(`stopping`),p(`stopped`),l?.(e),s===`always`&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)})}}async function h(){p(`starting`);let e=t(n);f=e;let i=e.process;await new Promise((t,a)=>{let o=!1;function s(e){o||(o=!0,clearTimeout(u),d(),i.off(`exit`,h),e())}let u=setTimeout(()=>{s(()=>{e.close(),f=void 0;try{p(`crashed`)}catch{}a(Error(`Process health timeout after ${r}ms: ${n.processName??n.command}`))})},r),d=e.onMessage(()=>{s(()=>{try{p(`running`)}catch(e){a(e);return}c?.(),i.once(`exit`,m),t()})});function h(e){s(()=>{f=void 0;try{p(`crashed`)}catch{}l?.(e),a(Error(`Process exited with code ${String(e)} before signaling readiness`))})}i.once(`exit`,h)})}async function g(){if(d===`stopped`||d===`idle`)return;if(d===`crashed`){f?.close(),f=void 0,p(`stopped`);return}if(d!==`stopping`&&p(`stopping`),!f){d===`stopping`&&p(`stopped`);return}let e=f,t=e.process;if(t.exitCode!==null){e.close(),f===e&&(f=void 0),d===`stopping`&&p(`stopped`);return}t.kill(`SIGTERM`);let n;await Promise.race([o(t).then(()=>(clearTimeout(n),!0)),new Promise(e=>{n=setTimeout(()=>e(!1),i)})])||(t.kill(`SIGKILL`),await o(t)),d===`stopping`&&p(`stopped`),e.close(),f===e&&(f=void 0)}return{get transport(){return f},get state(){return d},start:h,stop:g}}const c=n.object({dataDir:n.string().optional(),machineId:n.string().optional(),makaioHome:n.string().optional(),platform:n.string().optional(),username:n.string().optional()}),l={init:{request:n.object({config:n.unknown().optional(),context:c.optional()}),response:n.object({ready:n.boolean()})},ready:n.object({ready:n.boolean(),config:n.unknown().optional(),context:c.optional()}).passthrough(),destroy:{request:n.object({reason:n.string().optional()}),response:n.object({stopped:n.boolean()})},stopped:n.object({stopped:n.boolean()}).passthrough()};function u(e,t){return e.bus.registerNamespace(r(`extension.${t}`,l)).subjects}function d(e,t){let n;return()=>(n??=u(e,t),n)}function f(e){return{dataDir:e.dataDir,machineId:e.machineId,makaioHome:e.makaioHome,platform:e.platform,username:e.username}}var p=class{descriptor;ctx;extensionPath;getLifecycleSubjects;transport=null;unregister=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{StdioServerTransport:e}=await import(`./src-xbmzokNe.mjs`),{transport:t}=this.descriptor,n=this.getLifecycleSubjects(),r=new e({name:this.descriptor.name,spawn:{command:t.command,args:t.args,cwd:this.extensionPath,env:t.env,processName:this.descriptor.name}}),i=null;try{let e=this.ctx.bus.registerTransport(r);i=e.unregister,await r.connect(),await r.ready,await e.ready,this.transport=r,this.unregister=i,await this.ctx.bus.request(n.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:t.healthTimeoutMs})}catch(e){throw i?.(),await r.disconnect(),this.transport=null,this.unregister=null,e}}async destroy(){if(this.transport!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before disconnect:`,e instanceof Error?e.message:e)}}this.unregister?.(),this.unregister=null,await this.transport?.disconnect(),this.transport=null}},m=class{descriptor;ctx;extensionPath;getLifecycleSubjects;lifecycle=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{transport:e}=this.descriptor;if(!this.ctx.busUrl)throw Error(`[extensions] ${this.descriptor.name}: bus-websocket transport requires NodeExtensionContext.busUrl`);let t=this.getLifecycleSubjects();this.lifecycle=s({spawn:{command:e.command,args:e.args,cwd:this.extensionPath,env:{...e.env,MAKAIO_BUS_TRANSPORT:`websocket`,MAKAIO_BUS_URL:this.ctx.busUrl,MAKAIO_EXTENSION_NAME:this.descriptor.name},processName:this.descriptor.name},healthTimeoutMs:e.healthTimeoutMs,shutdownTimeoutMs:e.shutdownTimeoutMs,restartPolicy:`restartPolicy`in e?e.restartPolicy:void 0});try{await this.lifecycle.start(),await this.ctx.bus.request(t.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:e.healthTimeoutMs})}catch(e){throw await this.lifecycle.stop(),this.lifecycle=null,e}}async destroy(){if(this.lifecycle!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before process stop:`,e instanceof Error?e.message:e)}await this.lifecycle.stop(),this.lifecycle=null}}},h=class{descriptor;ctx;extensionPath;bridge=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n}async init(){let{startMcpClientBridge:e}=await import(`@makaio/framework/mcp-http-server`),{transport:t}=this.descriptor;this.bridge=await e({command:t.command,args:t.args,env:t.env,cwd:this.extensionPath,extensionName:this.descriptor.name,bus:this.ctx.bus})}async destroy(){this.bridge!==null&&(await this.bridge.close(),this.bridge=null)}};function g(t,n){return{...e(t),create(e){return t.transport.type===`bus-stdio`?new p(t,e,n):t.transport.type===`mcp-stdio`?new h(t,e,n):new m(t,e,n)}}}export{g as createDetachedExtensionPackage};