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

package/dist/{definition-DB7bbFSa.d.mts → definition-BLCdXGzh.d.mts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-//#region packages/contracts/src/version/primitives.d.ts
+//#region core/contracts/src/version/primitives.d.ts
 /**
  * npm semver range syntax (e.g. `">=1.0.0 <2.0.0"`, `"^1.5.0"`).
  *
@@ -37,7 +37,7 @@ declare function isUniversalRange(range: string): boolean;
 /** Validates that the string is an exact semver version. */
 declare const VersionLiteralSchema: z.ZodString;
 //#endregion
-//#region packages/contracts/src/client/definition.d.ts
+//#region core/contracts/src/client/definition.d.ts
 /**
  * Schema for a capability annotation attached to a native client tool.
  *
@@ -91,6 +91,10 @@ type LogSourceDefinition = z.infer<typeof LogSourceDefinitionSchema>;
 declare const ClientHookEventDeclarationSchema: z.ZodObject<{
   name: z.ZodString;
   frameworkSubject: z.ZodOptional<z.ZodString>;
+  mode: z.ZodDefault<z.ZodEnum<{
+    request: "request";
+    event: "event";
+  }>>;
 }, z.core.$strip>;
 type ClientHookEventDeclaration = z.infer<typeof ClientHookEventDeclarationSchema>;
 /**
@@ -229,6 +233,10 @@ declare const ClientRuntimeCapabilitiesSchema: z.ZodObject<{
   hookEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     frameworkSubject: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<{
+      request: "request";
+      event: "event";
+    }>>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 type ClientRuntimeCapabilities = z.infer<typeof ClientRuntimeCapabilitiesSchema>;
@@ -285,8 +293,8 @@ declare const ClientDefinitionSchema: z.ZodObject<{
     }, z.core.$strip>>>;
   }, z.core.$strip>>>;
   defaultApprovalPolicy: z.ZodEnum<{
-    "always-ask": "always-ask";
     reject: "reject";
+    "always-ask": "always-ask";
     "full-access": "full-access";
   }>;
   logSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -304,6 +312,10 @@ declare const ClientDefinitionSchema: z.ZodObject<{
     hookEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
       name: z.ZodString;
       frameworkSubject: z.ZodOptional<z.ZodString>;
+      mode: z.ZodDefault<z.ZodEnum<{
+        request: "request";
+        event: "event";
+      }>>;
     }, z.core.$strip>>>;
   }, z.core.$strip>>, z.ZodTransform<{
     supportsHooks: boolean;
@@ -312,6 +324,7 @@ declare const ClientDefinitionSchema: z.ZodObject<{
     supportsManagedBinary: boolean;
     hookEvents: {
       name: string;
+      mode: "request" | "event";
       frameworkSubject?: string | undefined;
     }[];
   }, {
@@ -321,6 +334,7 @@ declare const ClientDefinitionSchema: z.ZodObject<{
     supportsManagedBinary: boolean;
     hookEvents: {
       name: string;
+      mode: "request" | "event";
       frameworkSubject?: string | undefined;
     }[];
   } | undefined>>;

package/dist/definition-CrgHIpTK.d.mts

@@ -0,0 +1,60 @@
+import { l as SurfaceBindingRegistration } from "./schemas-wg_6PAdV.mjs";
+
+//#region core/contracts/src/materialization/definition.d.ts
+/**
+ * A surface binding definition with a serializable registration record.
+ *
+ * Created by {@link defineSurfaceBinding}. The definition retains the original
+ * options and produces a bus-transportable {@link SurfaceBindingRegistration}
+ * via `toRegistration()`.
+ *
+ * The interface is intentionally opaque: only `id` is exposed directly so
+ * that callers have a stable, lightweight handle. All other properties are
+ * accessible exclusively through `toRegistration()`, keeping the contract
+ * aligned with the bus registration shape.
+ */
+interface SurfaceBindingDefinition {
+  /** Stable identifier for this surface binding (e.g. `'github.status.field'`). */
+  readonly id: string;
+  /**
+   * Produces a serializable registration record suitable for bus transport.
+   * @returns A {@link SurfaceBindingRegistration} snapshot with `target`
+   *   deep-cloned and all array fields copied to prevent shared-reference
+   *   mutation.
+   */
+  readonly toRegistration: () => SurfaceBindingRegistration;
+}
+/**
+ * Options for {@link defineSurfaceBinding}.
+ *
+ * Structurally identical to {@link SurfaceBindingRegistration} — every field
+ * is included in the serializable registration output.
+ */
+type DefineSurfaceBindingOptions = SurfaceBindingRegistration;
+/**
+ * Creates a surface binding definition with a serializable registration.
+ *
+ * The returned definition exposes the `id` identifier directly and produces
+ * a bus-transportable {@link SurfaceBindingRegistration} via `toRegistration()`.
+ * The `target` object is deep-cloned via `structuredClone` (consistent with
+ * how {@link SurfaceBindingRegistry} clones at storage boundaries), and array
+ * fields (`appliesTo`) are defensively copied so callers cannot mutate the
+ * registration snapshot.
+ * @param options - Surface binding registration options including provider,
+ *   namespace, target, and entity classes the binding applies to.
+ * @returns A {@link SurfaceBindingDefinition} with a `toRegistration` method.
+ * @example
+ * ```ts
+ * export const githubStatusFieldBinding = defineSurfaceBinding({
+ *   id: 'github.status.field',
+ *   provider: 'github',
+ *   namespace: 'status',
+ *   target: { kind: 'field', name: 'Status' },
+ *   appliesTo: ['workpiece'],
+ *   valueMapping: { pending: 'In Progress', completed: 'Done' },
+ * });
+ * ```
+ */
+declare function defineSurfaceBinding(options: DefineSurfaceBindingOptions): SurfaceBindingDefinition;
+//#endregion
+export { defineSurfaceBinding as n, SurfaceBindingDefinition as t };

package/dist/{definition-DkYy1PZz.mjs → definition-DZMXOnjX.mjs}

@@ -1 +1 @@
-import{i as e,t}from"./visibility-CZu8ooOA.mjs";import{z as n}from"zod";const r=n.enum([`anthropic`,`openai`]),i=n.object({anthropic:n.string().url(),openai:n.string().url()}).partial().refine(e=>Object.keys(e).length>0,{message:`At least one protocol endpoint must be specified`}),a=n.object({id:n.string().min(1),name:n.string().min(1),description:n.string().optional(),endpoints:i.optional(),defaultModel:n.string().optional(),fastModel:n.string().optional(),primaryTestModel:n.string().optional(),secondaryTestModel:n.string().optional(),availableModels:n.array(e).default([]),defaultModelFilterMode:t.optional(),credentialEnvVars:n.record(n.string(),n.string()).optional()});export{r as n,a as r,i as t};
+import{i as e,t}from"./visibility-Cb62p9bv.mjs";import{z as n}from"zod";const r=n.enum([`anthropic`,`openai`]),i=n.object({anthropic:n.string().url(),openai:n.string().url()}).partial().refine(e=>Object.keys(e).length>0,{message:`At least one protocol endpoint must be specified`}),a=n.object({id:n.string().min(1),name:n.string().min(1),description:n.string().optional(),endpoints:i.optional(),defaultModel:n.string().optional(),fastModel:n.string().optional(),primaryTestModel:n.string().optional(),secondaryTestModel:n.string().optional(),availableModels:n.array(e).default([]),defaultModelFilterMode:t.optional(),credentialEnvVars:n.record(n.string(),n.string()).optional()});export{r as n,a as r,i as t};

package/dist/{definition-DtUNiGom.d.mts → definition-pkJ6szUl.d.mts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-//#region packages/contracts/src/provider/definition.d.ts
+//#region core/contracts/src/provider/definition.d.ts
 /**
  * Wire protocol identifiers supported by Makaio adapters.
  *

package/dist/drizzle-Eq8W1EbD.mjs

@@ -0,0 +1 @@
+import{and as e,eq as t,getTableColumns as n,inArray as r,sql as i}from"drizzle-orm";import{didAffectRows as a}from"@makaio/framework/storage/drizzle";function o(e,t){return{[e]:t}}function s(e,t,r){let i=n(e);if(!r)return i[t];let a=r(e);if(a.length===0)throw Error(`createDrizzleCrudHandlers: conflictTarget returned an empty array. Provide at least one column for the conflict target.`);return a}function c(e,r,i){let{table:a,idField:s,singularKey:c,mapper:l,getSubject:u}=i;return e.on(u,async e=>{let{id:i}=e.payload,u=n(a)[s],[d]=await r.select().from(a).where(t(u,i)).limit(1);e.setResult(o(c,d?l(d):null))})}function l(e,r,a){let{table:o,idField:s,singularKey:c,mapper:l,toDbValues:u,setSubject:d,resolvedConflictTarget:f,lifecycle:p}=a;return e.on(d,async a=>{let d=a.payload[c],m=d[s],h=Date.now(),g=n(o),_=u(d),v={..._,[s]:m,createdAt:h,updatedAt:h};if(!p){await r.insert(o).values(v).onConflictDoUpdate({target:f,set:{..._,[s]:m,updatedAt:h,createdAt:i`COALESCE(${g.createdAt}, excluded.created_at)`}}),a.setResult({id:m});return}let y=await r.insert(o).values(v).onConflictDoNothing({target:f}).returning();if(y.length>0){await e.emit(p.created,l(y[0])),a.setResult({id:m});return}let[b]=await r.update(o).set({..._,updatedAt:h}).where(t(g[s],m)).returning();b&&await e.emit(p.updated,l(b)),a.setResult({id:m})})}function u(e,r,i){let{table:o,idField:s,deleteSubject:c}=i;return e.on(c,async e=>{let{id:i}=e.payload,c=n(o)[s],l=await r.delete(o).where(t(c,i));e.setResult({deleted:a(l)})})}function d(e,r,i){let{table:a,idField:o,singularKey:s,getSubject:c,deleteSubject:l,lifecycle:u}=i;return e.on(l,async i=>{let{id:l}=i.payload,d=n(a)[o],[f]=await r.select({id:d}).from(a).where(t(d,l)).limit(1);await i.next(),f&&((await e.request(c,{id:l}))[s]||await e.emit(u.deleted,{id:l}))})}function f(e){if(e.conflictTarget&&e.lifecycle)throw Error(`createDrizzleCrudHandlers: conflictTarget is not yet compatible with lifecycle events. The lifecycle path uses a PK-based UPDATE fallback that cannot resolve rows by natural key.`);let{table:t,subjects:n,idField:r,singularKey:i,mapper:a,toDbValues:o,conflictTarget:f,lifecycle:p}=e,m=s(t,r,f);return(e,s)=>{let f=[];return f.push(c(e,s,{table:t,idField:r,singularKey:i,mapper:a,getSubject:n.get})),f.push(l(e,s,{table:t,idField:r,singularKey:i,mapper:a,toDbValues:o,setSubject:n.set,resolvedConflictTarget:m,lifecycle:p})),p&&f.push(d(e,s,{table:t,idField:r,singularKey:i,getSubject:n.get,deleteSubject:n.delete,lifecycle:p})),f.push(u(e,s,{table:t,idField:r,deleteSubject:n.delete})),()=>f.forEach(e=>e())}}function p(t){let{table:n,subject:r,pluralKey:i,mapper:a,buildPredicates:o}=t;return(t,s)=>{let c=(e,t)=>({[e]:t});return t.on(r,async t=>{let r=o(t.payload,n),l=r.length>0?e(...r):void 0,u=l?await s.select().from(n).where(l):await s.select().from(n);t.setResult(c(i,u.map(a)))})}}function m(e,n){return n?[r(e.scope,[`default`,n])]:[t(e.scope,`default`)]}export{p as n,f as r,m as t};

package/dist/event-Ca2yUf5i.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=e.object({repoPath:e.string().optional()}),n=e.object({path:e.string()}),r=e.object({root:e.string().nullable()}),ee=t,i=e.object({current:e.string(),isDetached:e.boolean()}),a=t.extend({ref:e.string().optional()}),o=e.object({hash:e.string(),message:e.string(),author:e.string(),email:e.string(),date:e.string()}),s=t.extend({hash:e.string()}),c=e.object({path:e.string(),oldPath:e.string().optional(),status:e.string(),additions:e.number(),deletions:e.number()}),l=e.object({totalAdditions:e.number(),totalDeletions:e.number(),changedFiles:e.number()}),u=e.object({files:e.array(c),stats:l}),d=t,f=e.object({path:e.string(),oldPath:e.string().optional(),additions:e.number(),deletions:e.number()}),te=e.object({staged:e.array(f),unstaged:e.array(f),untracked:e.array(f),conflicted:e.array(f),stats:l}),ne=t,re=e.object({staged:e.array(e.string()),modified:e.array(e.string()),untracked:e.array(e.string()),conflicted:e.array(e.string())}),p=t,m=e.object({path:e.string(),branch:e.string(),commit:e.string(),isMain:e.boolean()}),h=e.object({worktrees:e.array(m)}),g=t,_=e.object({name:e.string(),fetchUrl:e.string(),pushUrl:e.string()}),v=e.object({remotes:e.array(_)}),y=t,b=e.object({branch:e.string()}),x=e.object({branches:e.array(e.string()).optional(),branchMode:e.enum([`all`,`specific`]).optional(),baseBranch:e.string().optional(),paths:e.array(e.string()).optional(),author:e.string().optional(),since:e.string().optional(),until:e.string().optional(),searchQuery:e.string().optional(),selectedWorktree:e.string().optional()}),S=t.extend({limit:e.number().min(1).max(1e4).optional(),ref:e.string().optional(),filters:x.optional()}),C=e.object({hash:e.string(),shortHash:e.string(),message:e.string(),author:e.string(),email:e.string(),date:e.string(),parents:e.array(e.string())}),w=e.object({branches:e.record(e.string(),e.string()),remoteBranches:e.record(e.string(),e.string()),tags:e.record(e.string(),e.string()),HEAD:e.string()}),T=e.object({commits:e.array(C),refs:w,truncated:e.boolean()}),E=t.extend({path:e.string(),ref:e.string()}),D=e.object({content:e.string(),isBinary:e.boolean()}),O=t.extend({ref:e.string().optional(),staged:e.boolean().optional(),unified:e.number().int().min(0).max(10).optional(),paths:e.array(e.string()).optional()}),k=e.object({diff:e.string()}),A=e.object({branchName:e.string(),repoPath:e.string().optional()}),j=e.object({commitHashes:e.array(e.string())}),M=e.object({repoPath:e.string().optional(),worktreePath:e.string()}),N=e.object({success:e.boolean(),error:e.string().optional()}),P=e.object({repoPath:e.string().optional(),path:e.string(),ref:e.string().optional()}),F=e.object({startLine:e.number(),endLine:e.number(),shortHash:e.string(),hash:e.string(),author:e.string(),date:e.string(),message:e.string()}),I=e.object({content:e.string(),lines:e.array(F)}),L=t.extend({filePath:e.string(),commitHash:e.string()}),R=e.object({content:e.string().nullable(),isBinary:e.boolean()}),z=t.extend({filePath:e.string(),commitHash:e.string()}),B=e.object({blobHash:e.string().nullable()}),V=e.object({repoPath:e.string(),include:e.array(e.string()),exclude:e.array(e.string()),worktree:e.string().optional()}),H=e.object({hash:e.string(),commitSha:e.string(),changedPaths:e.array(e.string()),timestamp:e.string()}),U=e.object({repoPath:e.string().optional(),message:e.string().min(1),allowEmpty:e.boolean().optional(),amend:e.boolean().optional()}),W=e.object({success:e.boolean(),hash:e.string().optional(),branch:e.string().optional(),error:e.string().optional()}),G=e.enum([`merge`,`squash`,`fast-forward-only`]),K=e.object({repoPath:e.string().optional(),source:e.string(),approach:G.optional(),message:e.string().optional(),abortOnConflict:e.boolean().optional()}),q=e.object({success:e.boolean(),hash:e.string().optional(),fastForward:e.boolean().optional(),conflicts:e.array(e.string()).optional(),error:e.string().optional()}),J=e.object({repoPath:e.string().optional()}),Y=e.object({success:e.boolean(),error:e.string().optional()}),X=e.object({repoPath:e.string().optional(),onto:e.string(),abort:e.boolean().optional(),continueRebase:e.boolean().optional()}),ie=e.object({success:e.boolean(),hash:e.string().optional(),conflicts:e.array(e.string()).optional(),error:e.string().optional()}),Z=e.enum([`push`,`pop`,`apply`,`drop`,`list`]),ae=e.object({repoPath:e.string().optional(),operation:Z,message:e.string().optional(),includeUntracked:e.boolean().optional(),index:e.number().int().min(0).optional()}),Q=e.object({index:e.number(),message:e.string(),branch:e.string(),date:e.string()}),oe=e.object({success:e.boolean(),entries:e.array(Q).optional(),error:e.string().optional()}),se=e.object({repoPath:e.string().optional(),name:e.string(),startPoint:e.string().optional(),checkout:e.boolean().optional()}),ce=e.object({success:e.boolean(),name:e.string().optional(),error:e.string().optional()}),le=e.object({repoPath:e.string().optional(),name:e.string(),force:e.boolean().optional()}),ue=e.object({success:e.boolean(),error:e.string().optional()}),de=e.object({repoPath:e.string().optional(),oldName:e.string(),newName:e.string()}),fe=e.object({success:e.boolean(),error:e.string().optional()}),pe=e.object({repoPath:e.string().optional(),ref:e.string(),createBranch:e.boolean().optional(),startPoint:e.string().optional()}),me=e.object({success:e.boolean(),ref:e.string().optional(),error:e.string().optional()}),he=e.object({repoPath:e.string().optional(),remote:e.string().optional(),branch:e.string().optional(),setUpstream:e.boolean().optional(),force:e.boolean().optional()}),ge=e.object({success:e.boolean(),remote:e.string().optional(),branch:e.string().optional(),error:e.string().optional()}),_e=e.object({repoPath:e.string().optional(),remote:e.string().optional(),branch:e.string().optional(),rebase:e.boolean().optional()}),ve=e.object({success:e.boolean(),conflicts:e.array(e.string()).optional(),error:e.string().optional()}),ye=e.object({repoPath:e.string().optional(),remote:e.string().optional(),prune:e.boolean().optional()}),be=e.object({success:e.boolean(),error:e.string().optional()}),xe=e.object({repoPath:e.string().optional(),paths:e.array(e.string()).min(1)}),Se=e.object({success:e.boolean(),error:e.string().optional()}),Ce=e.object({repoPath:e.string(),hash:e.string(),message:e.string(),author:e.string(),email:e.string(),branch:e.string(),timestamp:e.string(),worktree:e.string().optional()}),we=e.object({repoPath:e.string(),previousBranch:e.string().optional(),currentBranch:e.string(),timestamp:e.string(),worktree:e.string().optional()}),Te=e.object({repoPath:e.string(),staged:e.array(e.string()),timestamp:e.string(),worktree:e.string().optional()}),Ee=e.object({repoPath:e.string(),sourceBranch:e.string(),targetBranch:e.string(),mergeCommit:e.string(),timestamp:e.string(),worktree:e.string().optional()}),$=e.enum([`started`,`completed`,`aborted`]),De=e.object({repoPath:e.string(),branch:e.string(),onto:e.string(),status:$,timestamp:e.string(),worktree:e.string().optional()}),Oe=e.object({repoPath:e.string(),name:e.string(),path:e.string(),branch:e.string(),event:e.enum([`added`,`removed`]),timestamp:e.string()}),ke=e.object({repoPath:e.string()}),Ae=e.object({success:e.boolean(),error:e.string().optional()}),je=e.object({repoPath:e.string()}),Me=e.object({success:e.boolean()}),Ne=e.object({path:e.string(),defaultBranch:e.string().optional()}),Pe=e.object({success:e.boolean(),path:e.string(),defaultBranch:e.string()}),Fe=e.object({repoPath:e.string(),path:e.string(),branch:e.string(),baseBranch:e.string().optional(),createBranch:e.boolean().optional()}),Ie=e.object({success:e.boolean(),path:e.string(),branch:e.string(),error:e.string().optional()}),Le=e.object({repoPath:e.string(),path:e.string(),force:e.boolean().optional(),deleteBranch:e.boolean().optional()}),Re=e.object({success:e.boolean(),error:e.string().optional()}),ze=e.object({repoPath:e.string().optional(),paths:e.array(e.string()).min(1)}),Be=e.object({success:e.boolean(),error:e.string().optional()}),Ve=e.object({repoPath:e.string().optional(),paths:e.array(e.string()).min(1)}),He=e.object({success:e.boolean(),error:e.string().optional()});export{j as $,le as A,v as At,ve as B,m as Bt,Y as C,C as Ct,ce as D,w as Dt,se as E,T as Et,be as F,M as Ft,de as G,ge as H,h as Ht,G as I,N as It,Z as J,fe as K,K as L,d as Lt,xe as M,r as Mt,Se as N,ne as Nt,U as O,_ as Ot,ye as P,re as Pt,A as Q,q as R,te as Rt,J as S,H as St,me as T,S as Tt,X as U,he as V,p as Vt,ie as W,oe as X,ae as Y,t as Z,Be as _,R as _t,Fe as a,ee as at,He as b,c as bt,Pe as c,s as ct,$ as d,o as dt,F as et,je as f,y as ft,ze as g,L as gt,Re as h,k as ht,Ce as i,B as it,ue as j,n as jt,W as k,g as kt,Ee as l,u as lt,Le as m,O as mt,Ae as n,I as nt,Ie as o,i as ot,Me as p,b as pt,Q as q,we as r,z as rt,Ne as s,l as st,ke as t,P as tt,De as u,a as ut,Te as v,E as vt,pe as w,x as wt,Oe as x,V as xt,Ve as y,D as yt,_e as z,f as zt};

package/dist/execution-target-CRPTfZlc.mjs

@@ -0,0 +1 @@
+import"./services/execution-target/schemas.mjs";import"./services/execution-target/namespace.mjs";import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";const n=e.object({busAuthSecret:e.string().optional(),relayPeer:e.object({id:e.string().min(1),signingPublicKey:e.string().min(1)}).optional(),relayIdentity:e.object({id:e.string().min(1),signingPublicKey:e.string().min(1),signingPrivateKeyPem:e.string().min(1)}).optional(),gitToken:e.string().optional(),credentialEnv:e.record(e.string(),e.string()).optional(),providerEnv:e.record(e.string(),e.string()).optional()}),r=e.enum([`simple`,`full`]),i=e.enum([`created`,`running`,`stopped`,`destroyed`]),a=e.object({sessionId:e.string(),executionId:e.string().optional(),adapter:e.string(),runtime:r.default(`simple`),image:e.string().optional(),env:e.record(e.string(),e.string()).optional(),bootstrapConfig:n.optional()}),o=a.extend({mode:e.literal(`container-local`),repoPath:e.string(),baseBranch:e.string(),worktreeBranch:e.string().optional()}),s=a.extend({mode:e.literal(`container-isolated`),repoUrl:e.string(),branch:e.string().optional(),busMode:e.enum([`host`,`relay`]),relayUrl:e.string().optional()}),c=e.discriminatedUnion(`mode`,[o,s]),l=e.object({containerId:e.string(),worktreePath:e.string().optional(),worktreeBranch:e.string().optional()}),u=e.object({containerId:e.string(),deleteBranch:e.boolean().default(!1)}),d=e.object({success:e.boolean()}),f=e.object({containerId:e.string()}),p=e.object({state:i,sessionId:e.string(),worktreePath:e.string().optional()}),m=e.object({containerId:e.string(),sessionId:e.string(),worktreePath:e.string().optional()}),h=e.object({containerId:e.string(),sessionId:e.string(),worktreePath:e.string().optional()}),g=e.object({containerId:e.string(),sessionId:e.string(),exitCode:e.number()}),_=e.object({containerId:e.string(),sessionId:e.string()}),v=t(`docker`,{"container.spawn":{request:c,response:l},"container.stop":{request:u,response:d},"container.status":{request:f,response:p},"container.created":m,"container.started":h,"container.stopped":g,"container.destroyed":_}),y=v.subjects,b=v,x=y;export{p as _,n as a,s as c,h as d,i as f,f as g,l as h,y as i,o as l,c as m,x as n,m as o,g as p,v as r,_ as s,b as t,r as u,u as v,d as y};

package/dist/extension-C-4BHMRI.mjs

@@ -0,0 +1 @@
+import{n as e}from"./window-registry-DW-dKRjQ.mjs";import{o as t,t as n}from"./schema-introspection-Dn1jWQs1.mjs";import{n as r}from"./extension-namespace-cMh_mMiL.mjs";import{z as i}from"zod";import a from"node:path";import{createBusNamespace as o}from"@makaio/framework/core";import{ProviderDefinitionSchema as s,versionSatisfies as c}from"@makaio/framework/contracts";import{ToastSubjects as l}from"@makaio/framework/contracts/toast";import{ExtensionWarningSchema as u,getExtensionWarningActionLabel as d}from"@makaio/framework/contracts/extension";import{TrayMenuSubjects as f}from"@makaio/framework/services/tray-menu";const p=i.object({name:i.string(),displayName:i.string()}),m=o(`kernel:boot`,{getState:{request:i.object({}),response:i.object({complete:i.boolean(),completedCount:i.number(),totalCount:i.number(),currentService:i.string().optional(),failedServices:i.array(i.string()),skippedServices:i.array(i.string()).default([]),totalDurationMs:i.number().optional()})},"service.starting":p,"service.ready":p.extend({durationMs:i.number().int().nonnegative()}),"service.failed":p.extend({errorMessage:i.string()}),"service.skipped":p.extend({reason:i.string()}),progress:i.object({completedCount:i.number(),totalCount:i.number(),currentService:i.string().optional()}),complete:i.object({totalDurationMs:i.number(),failedServices:i.array(i.string())})}),h=m.subjects;var g=class extends Error{reason;constructor(e){super(e),this.name=`ServiceSkipError`,this.reason=e}};function _(e){return{name:e.name,displayName:e.displayName}}var v=class{bus;state;cleanup;constructor(e,t){this.bus=e,this.state={complete:!1,completedCount:0,totalCount:t,failedServices:[],skippedServices:[],startedAt:Date.now()},this.cleanup=this.bus.on(h.getState,e=>{e.setResult({complete:this.state.complete,completedCount:this.state.completedCount,totalCount:this.state.totalCount,...this.state.currentService===void 0?{}:{currentService:this.state.currentService},failedServices:[...this.state.failedServices],skippedServices:[...this.state.skippedServices],...this.state.totalDurationMs===void 0?{}:{totalDurationMs:this.state.totalDurationMs}})})}dispose(){this.cleanup()}starting(e){let t=_(e);this.state.currentService=t.displayName,this.state.currentServiceStartedAt=Date.now(),this.bus.emit(h.service.starting,t).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.starting emit failed for "${t.name}":`,e)})}ready(e){let t=_(e);this.state.completedCount+=1;let n=this.state.currentServiceStartedAt===void 0?0:Math.max(0,Date.now()-this.state.currentServiceStartedAt);this.bus.emit(h.service.ready,{...t,durationMs:n}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.ready emit failed for "${t.name}":`,e)}),this.emitProgress()}failed(e,t){let n=_(e);this.state.completedCount+=1,this.state.failedServices.push(n.name),this.bus.emit(h.service.failed,{...n,errorMessage:t}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.failed emit failed for "${n.name}":`,e)}),this.emitProgress()}skipped(e,t){let n=_(e);this.state.completedCount+=1,this.state.skippedServices.push(n.name),this.bus.emit(h.service.skipped,{...n,reason:t}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.skipped emit failed for "${n.name}":`,e)}),this.emitProgress()}complete(){this.state.complete=!0,delete this.state.currentService,delete this.state.currentServiceStartedAt,this.state.totalDurationMs=Date.now()-this.state.startedAt,this.bus.emit(h.complete,{totalDurationMs:this.state.totalDurationMs,failedServices:[...this.state.failedServices]}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.complete emit failed:`,e)})}emitProgress(){this.bus.emit(h.progress,{completedCount:this.state.completedCount,totalCount:this.state.totalCount,...this.state.currentService===void 0?{}:{currentService:this.state.currentService}}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.progress emit failed:`,e)})}};function ee(e){return{subject:`wiring.apply`,$meta:{namespace:`client:${e}`,isRequest:!0,local:!1,channel:!1,payload:{request:{},response:{}}}}}const y=`action`;function b(e,t){return`${e}:${t}`}function te(e,t,n){return e.on(l.interacted,r=>{let{toastId:i,actionId:a}=r.payload,o=b(i,a),s=t.get(o);s&&x(e,s,i,n).catch(e=>{console.error(`[ExtensionCoordinator] Warning action dispatch failed for toast "${i}":`,e)})})}async function x(e,t,n,r){switch(t.kind){case`configure-integration`:await C(e,t.clientId,n,r);break;case`open-url`:console.info(`[ExtensionCoordinator] Toast "${n}" open-url action not routable from runtime layer: ${t.url}`);break;case`run-command`:console.info(`[ExtensionCoordinator] Toast "${n}" run-command action not routable from runtime layer: ${t.command}`);break;case`install-extension`:console.info(`[ExtensionCoordinator] Toast "${n}" install-extension action not routable from runtime layer: ${t.extensionName}`);break;default:S(t)}}function S(e){throw Error(`[ExtensionCoordinator] Unsupported warning action: ${JSON.stringify(e)}`)}async function C(e,t,n,r){let i=ee(t),a=await e.requestOptional(i,{scope:`user`,makaioCommand:r});if(!a.handled){console.warn(`[ExtensionCoordinator] Toast "${n}" configure-integration: no wiring handler for client "${t}". Is the client package loaded?`);return}let{applied:o,skipped:s}=a.data;console.info(`[ExtensionCoordinator] Toast "${n}" configure-integration: wired client "${t}" — ${o} applied, ${s} skipped.`)}function w(e){return e.map(e=>({name:e.name,description:e.description,hasInteractive:!!e.interactive,subcommands:e.subcommands.map(e=>({name:e.name,description:e.description,args:n(e.schema)}))}))}async function T(e,t,n){let{command:r,subcommand:i,args:a}=e,o=t.find(e=>e.name===r);if(!o)return{exitCode:1,stdout:[],stderr:[`Unknown command: ${r}`]};let s=o.subcommands.find(e=>e.name===i);if(!s)return{exitCode:1,stdout:[],stderr:[`Unknown subcommand: ${i}`]};let c=s.schema.safeParse(a??{});if(!c.success)return{exitCode:1,stdout:[],stderr:[`Validation failed:`,...c.error.issues.map(e=>`  ${e.path.join(`.`)||`(root)`}: ${e.message}`)]};if(o.beforeRun)try{let e=await o.beforeRun({subcommandName:i,args:c.data??{},bus:n});if(!e.proceed)return{exitCode:e.exitCode??1,stdout:[],stderr:[e.message]}}catch(e){return{exitCode:1,stdout:[],stderr:[`beforeRun hook failed: ${e instanceof Error?e.message:String(e)}`]}}let l=[],u=[],d={write:e=>l.push(e),error:e=>u.push(e)},f=0,p=new AbortController().signal;try{await s.handler({args:c.data,bus:n,output:d,signal:p,setExitCode:e=>{f=e}})}catch(e){f===0&&(f=1),u.push(e instanceof Error?e.message:String(e))}return{exitCode:f,stdout:l,stderr:u}}function E(e){let{pkg:t,state:n,error:r,enabled:i}=e;return{name:t.name,displayName:t.displayName,state:n,...t.surface===void 0?{}:{surface:t.surface},enabled:i,...t.browser===void 0?{}:{browser:t.browser},...r===void 0?{}:{error:r}}}function D(e){let n=[];return n.push(e.bus.on(r.list,t=>{t.setResult({extensions:e.list()})})),n.push(e.bus.on(r.get,t=>{let n=e.entries.get(t.payload.name);t.setResult({extension:n?E(n):null})})),n.push(e.bus.on(r.setEnabled,async t=>{let n=await e.handleSetEnabled(t.payload.name,t.payload.enabled);t.setResult({success:n})})),n.push(e.bus.on(r.contributions.catalog,t=>{let n=[],r=[];for(let[t,i]of e.entries)if(i.state===`active`){for(let e of i.pkg.providers??[])n.push({packageName:t,definition:s.parse(e)});for(let e of i.pkg.clients??[])r.push({packageName:t,definition:e})}t.setResult({providers:n,clients:r})})),n.push(e.bus.on(t.listContributions,t=>{t.setResult({contributions:w(e.cliContributions)})})),n.push(e.bus.on(t.execute,async t=>{t.setResult(await T(t.payload,e.cliContributions,e.bus))})),n.push(e.bus.on(r.warnings.list,t=>{let{extensionName:n}=t.payload;if(n!==void 0){let r=e.entries.get(n),i=r&&r.warnings.length>0?[{extensionName:n,warnings:[...r.warnings]}]:[];t.setResult({entries:i});return}let r=[];for(let[t,n]of e.entries)n.warnings.length>0&&r.push({extensionName:t,warnings:[...n.warnings]});t.setResult({entries:r})})),n}async function ne(e){for(let[t,n]of e.entries)n.state===`active`&&await k(e,t,n)}function re(e){if(e&&O(e))return[{id:y,label:d(e)}]}function O(e){return e.kind===`configure-integration`}function ie(e,t){let n=`${t}:`;for(let t of e.keys())t.startsWith(n)&&e.delete(t)}async function k(e,t,n){ie(e.warningActionMap,t);let r=n.warnings.filter(e=>e.severity===`degraded`);if(r.length!==0)for(let i=0;i<r.length;i++){let a=r[i];console.warn(`[${t}] ⚠ ${a.title}: ${a.message}`);let o=`${t}:${a.title}:${i}`,s=re(a.action);try{await e.bus.emit(l.show,{level:`warning`,title:a.title,message:`${n.pkg.displayName}: ${a.message}`,toastId:o,durationMs:null,...s&&{actions:s}}),a.action&&O(a.action)&&e.warningActionMap.set(b(o,y),a.action)}catch(e){console.warn(`[${t}] toast emission failed for warning "${a.title}":`,e)}}}function ae(e){return Object.freeze({extensionName:e})}function oe(e,t,n,r){if(!t)return;let i={...n??{},...r??{}};try{return t.parse(i)}catch(n){console.warn(`[ExtensionCoordinator] Config parse failed for "${e}", starting with schema defaults:`,n instanceof Error?n.message:n);try{return t.parse({})}catch{console.warn(`[ExtensionCoordinator] Fallback config parse also failed for "${e}" — config will be absent`);return}}}function A(e,t,n){let r;if(n.pkg.configSchema)try{r=e.loadConfig?.(t)}catch(e){console.error(`[ExtensionCoordinator] loadConfig threw for "${t}":`,e)}return oe(t,n.pkg.configSchema,n.configDefaults,r)}function j(e,t,n){if(!e.extensionContextBase)throw Error(`ExtensionCoordinator: extensionContextBase is required to start extensions with a create factory. Provide it via the constructor.`);return{...e.extensionContextBase,bus:e.bus,identity:t.identity,dataDir:a.join(e.extensionContextBase.makaioHome,t.identity.extensionName),getService:t=>e.getExtensionService(t.name),signal:e.signal,hasExtension:e.hasActiveExtension,...n===void 0?{}:{config:n}}}function M(e){return{adapters:!!e.adapters?.length,tools:!!e.tools,triggers:!!e.triggers,providers:!!e.providers?.length,clients:!!e.clients?.length,ui:!!e.ui,storage:!!e.storage,sessionEventActions:!!e.sessionEventActions}}function N(e,t,n){let i=t.state;t.state=n,e.emit(r.stateChanged,{name:t.pkg.name,displayName:t.pkg.displayName,from:i,to:n,...t.error===void 0?{}:{error:t.error},contributes:M(t.pkg)}).catch(e=>{console.error(`[ExtensionCoordinator] stateChanged emit failed for "${t.pkg.name}":`,e)})}async function P(e,t,n,r,i){i===`activated`?await F(e,t,n,r):await I(e,n)}async function F(e,t,n,r){let i=[];try{for(let a of e){if(a.filter&&!a.filter(r.pkg))continue;let e=j(t,r,A(t,n,r));await a.processActivated(n,r.pkg,e),i.push(a)}}catch(e){for(let e of i.reverse())if(e.processStopped)try{await e.processStopped(n)}catch(e){console.error(`[ExtensionCoordinator] Contribution processor rollback error for "${n}":`,e)}throw e}}async function I(e,t){for(let n of[...e].reverse())if(n.processStopped)try{await n.processStopped(t)}catch(e){console.error(`[ExtensionCoordinator] Contribution processor error (stopped) for "${t}":`,e)}}async function L(e,t,n){let i=e.entries.get(t);if(!i)return!1;let a=n?await R(e,t,i):await z(e,t,i),o=i.enabled===n;return!a&&!o||(await e.persistEnabled?.(t,n),!a)?!1:(e.bus.emit(r.enabledChanged,{name:t,enabled:n}).catch(e=>{console.error(`[ExtensionCoordinator] enabledChanged emit failed for "${t}":`,e)}),!0)}async function R(e,t,n){if(n.state!==`stopped`&&n.state!==`failed`&&n.state!==`skipped`)return!1;let{pkg:r}=n,i,a=(r.dependencies??[]).filter(t=>{if(t.optional)return!1;let n=e.entries.get(t.name);return!n||n.state!==`active`});if(a.length>0)return n.error=`Required dependencies not active: ${a.map(e=>e.name).join(`, `)}`,console.error(`[ExtensionCoordinator] Cannot re-enable "${t}":`,n.error),N(e.bus,n,`failed`),!1;n.enabled=!0,n.error=void 0,N(e.bus,n,`initializing`);let o=A(e,t,n);if(r.storage?.registerHandlers&&e.db!==void 0)try{let t=j(e,n,o),a=r.storage.registerHandlers(e.bus,e.db,t);typeof a==`function`&&(i=a,n.storageCleanup=a)}catch(r){return n.error=r instanceof Error?r.message:String(r),console.error(`[ExtensionCoordinator] Extension "${t}" storage re-registration failed:`,r),N(e.bus,n,`failed`),!1}if(r.create){let a;try{let t=j(e,n,o);a=await r.create(t),await a.init?.(),n.service=a}catch(r){return await B(t,a,i,n),r instanceof g?n.pkg.critical?(n.error=`Critical extension cannot skip startup: ${r.reason}`,console.error(`[ExtensionCoordinator] Extension "${t}" failed to re-initialize:`,n.error),N(e.bus,n,`failed`),!1):(n.error=r.reason,N(e.bus,n,`skipped`),!1):(n.error=r instanceof Error?r.message:String(r),console.error(`[ExtensionCoordinator] Extension "${t}" failed to re-initialize:`,r),N(e.bus,n,`failed`),!1)}}try{await P(e.contributionProcessors,e,t,n,`activated`)}catch(r){return await B(t,n.service,i,n),n.service=void 0,n.error=r instanceof Error?r.message:String(r),console.error(`[ExtensionCoordinator] Extension "${t}" contribution processing failed:`,r),N(e.bus,n,`failed`),!1}return N(e.bus,n,`active`),await e.runHealthCheck(t),await e.emitWarningsForEntry(t,n),!0}async function z(e,t,n){if(n.state!==`active`)return!1;let i=Array.from(e.entries.entries()).filter(([e,n])=>e===t||n.state!==`active`?!1:n.pkg.dependencies?.some(e=>!e.optional&&e.name===t)??!1).map(([e])=>e);if(i.length>0)return n.error=`Cannot disable "${t}" while active dependents remain: ${i.join(`, `)}`,console.error(`[ExtensionCoordinator] ${n.error}`),!1;if(n.enabled=!1,n.error=void 0,await P(e.contributionProcessors,e,t,n,`stopped`),n.service)try{await n.service.destroy?.()}catch(e){console.error(`[ExtensionCoordinator] Error during disable destroy of "${t}":`,e)}finally{n.service=void 0}if(n.storageCleanup)try{n.storageCleanup()}catch(e){console.error(`[ExtensionCoordinator] Storage cleanup error during disable of "${t}":`,e)}finally{n.storageCleanup=void 0}N(e.bus,n,`stopped`),n.warnings=[];try{await e.bus.emit(r.warnings.changed,{extensionName:t,warnings:[]})}catch(e){console.error(`[ExtensionCoordinator] warnings.changed emit failed for "${t}":`,e)}return!0}async function B(e,t,n,r){try{await t?.destroy?.()}catch(t){console.error(`[ExtensionCoordinator] Service cleanup error after failed enable of "${e}":`,t)}try{n?.()}catch(t){console.error(`[ExtensionCoordinator] Storage cleanup error after failed enable of "${e}":`,t)}finally{r.storageCleanup=void 0}}function V(e){let t=new Map;for(let n of e)t.has(n.name)&&(console.info(`[ExtensionCoordinator] Extension "${n.name}" overrides an earlier registration`),t.delete(n.name)),t.set(n.name,n);return[...t.values()]}function H(e,t,n){let r=new Set(e.map(e=>e.name)),i=e.filter(e=>U(e,t,n)),a=new Map(i.map(e=>[e.name,e])),o=new Set(a.keys()),s=!0;for(;s;){s=!1;for(let e of o)(a.get(e).dependencies??[]).some(e=>!e.optional&&r.has(e.name)&&!o.has(e.name))&&(o.delete(e),s=!0)}return i.filter(e=>o.has(e.name))}function U(e,t,n){if(!G(e,t))return!1;let r=e.requires;return!r||r.length===0||!n?!0:r.every(e=>{switch(e.type){case`host`:return n.hosts.has(e.id);case`capability`:return n.capabilities.has(e.id)?e.version===void 0?!0:W(n,e.id,e.version):!1}})}function W(e,t,n){let r=e.capabilityVersions?.get(t);return r!==void 0&&c(r,n)}function G(e,t){return e.surface===void 0||e.surface===`any`||e.surface===t}function K(e){let t=q(e);return se(e,t,new Map(e.map(e=>[e.name,e]))),ue(t,le(e,t))}function q(e){let t=new Set;for(let n of e){if(t.has(n.name))throw Error(`ExtensionCoordinator: duplicate package name detected: "${n.name}"`);t.add(n.name)}return t}function se(e,t,n){for(let r of e)ce(r,t,n)}function ce(e,t,n){let r=e.dependencies??[],i=r.filter(e=>!e.optional&&!t.has(e.name));if(i.length>0)throw Error(`ExtensionCoordinator: package "${e.name}" declares missing dependencies: ${i.map(e=>e.name).join(`, `)}`);for(let t of r){let r=n.get(t.name);if(r===void 0)continue;let i=r.version;if(!c(i,t.version))throw Error(`ExtensionCoordinator: package "${e.name}" dependency "${t.name}" version ${i} does not satisfy ${t.version}`)}}function le(e,t){let n=new Map;for(let r of e){let e=(r.dependencies??[]).filter(e=>t.has(e.name)).map(e=>e.name);n.set(r.name,new Set(e))}return n}function ue(e,t){let n=[];for(let[e,r]of t)r.size===0&&n.push(e);let r=[],i=new Set;for(;n.length>0;){let e=n.shift();if(!i.has(e)){i.add(e),r.push(e);for(let[r,a]of t)a.has(e)&&(a.delete(e),a.size===0&&!i.has(r)&&n.push(r))}}if(r.length!==e.size){let t=[...e].filter(e=>!i.has(e));throw Error(`ExtensionCoordinator: circular dependency detected among: ${t.join(`, `)}`)}return r}async function de(e){if(!e.runMigrations)return;let t=[];for(let n of e.loadOrder){let r=e.entries.get(n);if(!r)throw Error(`Extension "${n}" is in loadOrder but missing from entries`);let i=r.pkg.storage?.migrations;if(!i)continue;let a=fe(n,r.pkg,i);t.push({name:n,migrationsPath:a,migrationSourceId:r.pkg.storage?.migrationSourceId??a})}t.length!==0&&await e.runMigrations(t)}function fe(e,t,n){if(a.isAbsolute(n))return n;let r=t.storage?.packageRoot;if(!r)throw Error(`Extension "${e}" declares relative storage.migrations "${n}" without storage.packageRoot`);let i=a.resolve(r),o=a.resolve(i,n),s=a.relative(i,o);if(s.startsWith(`..`)||a.isAbsolute(s))throw Error(`Extension "${e}" declares storage.migrations "${n}" outside storage.packageRoot`);return o}async function J(e,t){let n=e.entries.get(t);if(!n?.service||n.state!==`active`)return;let{checkHealth:i}=n.service;if(!i)return;let a;try{let e=await i.call(n.service),r=u.array().safeParse(e);r.success?a=r.data:(console.error(`[ExtensionCoordinator] checkHealth for "${t}" returned invalid data:`,r.error),a=[])}catch(e){console.error(`[ExtensionCoordinator] checkHealth threw for "${t}":`,e),a=[]}n.warnings=a;try{await e.bus.emit(r.warnings.changed,{extensionName:t,warnings:[...a]})}catch(e){console.error(`[ExtensionCoordinator] warnings.changed emit failed for "${t}":`,e)}}function pe(e,t){if(t.windows)for(let n of t.windows)e.windowRegistry.register(t.name,t.displayName,n);if(t.tray&&e.trayEntries.push({...t.tray,packageName:t.name}),t.cli){let n=t.cli;`subcommands`in n&&e.cliContributions.push(n)}}function me(e){return Array.from(e.values()).filter(e=>e.enabled).map(e=>e.pkg).filter(e=>!!e.http)}async function he(e){let t=[...e.loadOrder].reverse();for(let n of t){let t=e.entries.get(n);if(t){if(t.state===`active`&&await P(e.contributionProcessors,e.contextHost,n,t,`stopped`),t.service)try{await t.service.destroy?.()}catch(e){console.error(`[ExtensionCoordinator] Error during shutdown of "${n}":`,e)}finally{t.service=void 0}if(t.storageCleanup)try{t.storageCleanup()}catch(e){console.error(`[ExtensionCoordinator] Storage cleanup error for "${n}":`,e)}finally{t.storageCleanup=void 0}t.state===`active`&&N(e.contextHost.bus,t,`stopped`)}}}async function ge(e,t){if(!t.tray)return;let n=_e(t);await e.request(f.register,{entry:n})}function _e(e){let t=e.tray;if(!t)throw Error(`[tray-menu-entry-bridge] extension "${e.name}" does not declare a tray entry`);return{packageName:e.name,entryId:t.opensWindow??t.action??`default`,label:t.label,section:t.section??`views`,priority:50,enabled:!0,metadata:t.opensWindow?{registrationId:`${e.name}:${t.opensWindow}`}:t.action?{action:t.action}:void 0}}async function Y(e,t,n){if(!n.enabled){N(e.bus,n,`skipped`),e.bootProgress.skipped(n.pkg,`disabled`);return}let r=(n.pkg.dependencies??[]).filter(t=>t.optional?!1:e.entries.get(t.name)?.state!==`active`);if(r.length>0){let i=`Required dependencies not active: ${r.map(e=>e.name).join(`, `)}`;if(Q(e,t,n,i),n.pkg.critical)throw Error(`Critical package "${t}" failed: ${i}`);return}e.bootProgress.starting(n.pkg),N(e.bus,n,`initializing`);let i=A(e.contextHost,t,n);if(be(e,t,n,i)){if(!n.pkg.create){await ve(e,t,n);return}await ye(e,t,n,i)}}async function ve(e,t,n){try{await P(e.contributionProcessors,e.contextHost,t,n,`activated`)}catch(r){if(Z(t,n),X(e,t,n,r))return;if(Q(e,t,n,r instanceof Error?r.message:String(r)),n.pkg.critical)throw r;return}N(e.bus,n,`active`),e.bootProgress.ready(n.pkg),await $(e.bus,t,n)}async function ye(e,t,n,r){let i;try{let a=j(e.contextHost,n,r);i=await n.pkg.create(a),await i.init?.(),n.service=i,await P(e.contributionProcessors,e.contextHost,t,n,`activated`),N(e.bus,n,`active`),e.bootProgress.ready(n.pkg),await $(e.bus,t,n)}catch(r){try{await i?.destroy?.()}catch(e){console.error(`[ExtensionCoordinator] Service cleanup error after failed start of "${t}":`,e)}if(n.service=void 0,Z(t,n),X(e,t,n,r))return;if(Q(e,t,n,r instanceof Error?r.message:String(r)),n.pkg.critical)throw r}}function X(e,t,n,r){if(!(r instanceof g))return!1;if(n.pkg.critical){let i=`Critical package cannot skip startup: ${r.reason}`;throw Q(e,t,n,i),Error(`Critical package "${t}" failed: ${i}`,{cause:r})}return n.error=r.reason,console.info(`[ExtensionCoordinator] Package "${t}" skipped: ${r.reason}`),N(e.bus,n,`skipped`),e.bootProgress.skipped(n.pkg,r.reason),!0}function be(e,t,n,r){if(!n.pkg.storage?.registerHandlers||e.db===void 0)return!0;try{let t=j(e.contextHost,n,r),i=n.pkg.storage.registerHandlers(e.bus,e.db,t);return i&&(n.storageCleanup=i),!0}catch(r){let i=r instanceof Error?r.message:String(r);if(console.error(`[ExtensionCoordinator] Package "${t}" storage registration failed:`,r),Q(e,t,n,i),n.pkg.critical)throw r;return!1}}function Z(e,t){if(t.storageCleanup)try{t.storageCleanup()}catch(t){console.error(`[ExtensionCoordinator] Storage cleanup error after failed start of "${e}":`,t)}finally{t.storageCleanup=void 0}}function Q(e,t,n,r){n.error=r,console.error(`[ExtensionCoordinator] Package "${t}" failed:`,r),N(e.bus,n,`failed`),e.bootProgress.failed(n.pkg,r)}async function $(e,t,n){try{await ge(e,n.pkg)}catch(e){console.warn(`[ExtensionCoordinator] Failed to register tray entry for ${t}:`,e)}}var xe=class{bus;surface;db;extensionContextBase;runtimeEnvironment;shutdownController=new AbortController;entries=new Map;loadOrder=[];loaded=!1;started=!1;rpcCleanups=[];contributionProcessors=[];warningActionMap=new Map;windowRegistry=new e;_trayEntries=[];_cliContributions=[];persistEnabled;loadEnabled;loadConfig;runMigrations;constructor(e,t={}){this.bus=e,this.surface=t.surface??`headless`,this.db=t.db,this.extensionContextBase=t.extensionContextBase,this.runtimeEnvironment=t.runtimeEnvironment,this.persistEnabled=t.persistEnabled,this.loadEnabled=t.loadEnabled,this.loadConfig=t.loadConfig,this.runMigrations=t.runMigrations,this.rpcCleanups.push(te(this.bus,this.warningActionMap,t.launcherCommand??`makaio`))}get trayEntries(){return this._trayEntries.map(e=>({...e}))}get cliContributions(){return this._cliContributions}extensionsWithHttp(){return me(this.entries)}load(e,t){if(this.loaded)throw Error(`ExtensionCoordinator.load() called twice. The coordinator is single-use; create a new instance if needed.`);let n=V(H(e,this.surface,this.runtimeEnvironment));this.loadOrder=K(n);for(let e of this.loadOrder){let r=n.find(t=>t.name===e),i={pkg:r,identity:ae(r.name),state:`discovered`,enabled:this.loadEnabled?.(e)!==!1,warnings:[]};if(t){let n=t.get(e);n&&(i.configDefaults=n)}this.entries.set(e,i),r.namespaces&&this.bus.registerNamespaces(r.namespaces),pe({windowRegistry:this.windowRegistry,trayEntries:this._trayEntries,cliContributions:this._cliContributions},r)}this.rpcCleanups.push(...D({bus:this.bus,entries:this.entries,cliContributions:this._cliContributions,list:()=>this.list(),handleSetEnabled:(e,t)=>this.handleSetEnabled(e,t)})),this.loaded=!0}async startAll(){if(!this.loaded)throw Error(`ExtensionCoordinator.startAll() called before load(). Call load() first.`);if(this.started)throw Error(`ExtensionCoordinator.startAll() called twice. The coordinator is single-use; create a new instance if needed.`);this.started=!0;let e=new v(this.bus,this.loadOrder.length);this.rpcCleanups.push(()=>e.dispose());try{await de({loadOrder:this.loadOrder,entries:this.entries,runMigrations:this.runMigrations});for(let t of this.loadOrder){let n=this.entries.get(t);n&&await Y({bus:this.bus,db:this.db,entries:this.entries,contributionProcessors:this.contributionProcessors,contextHost:this.createExtensionContextHost(),bootProgress:e},t,n)}let t=this.createExtensionHealthHost();await Promise.all(this.loadOrder.map(e=>this.entries.get(e)?.state===`active`?J(t,e):void 0)),await ne({bus:this.bus,entries:this.entries,warningActionMap:this.warningActionMap})}finally{e.complete()}}async shutdown(){this.shutdownController.abort();for(let e of this.rpcCleanups)e();this.rpcCleanups=[],this.warningActionMap.clear(),await he({entries:this.entries,loadOrder:this.loadOrder,contributionProcessors:this.contributionProcessors,contextHost:this.createExtensionContextHost()})}list(){return[...this.entries.values()].map(e=>E(e))}getExtensionService(e){let t=typeof e==`string`?e:e.name;return this.entries.get(t)?.service}getExtension(e){return this.entries.get(e)?.pkg}forEachActiveExtension(e){let t=this.createExtensionContextHost();for(let n of this.loadOrder){let r=this.entries.get(n);if(!r||r.state!==`active`)continue;let i=j(t,r,A(t,n,r));e(n,r.pkg,i)}}forExtension(e,t){let n=this.entries.get(e);if(!n||n.state!==`active`)return;let r=this.createExtensionContextHost(),i=j(r,n,A(r,e,n));t(e,n.pkg,i)}registerContributionProcessor(e){return this.contributionProcessors.push(e),()=>{let t=this.contributionProcessors.indexOf(e);t>=0&&this.contributionProcessors.splice(t,1)}}async handleSetEnabled(e,t){return L({bus:this.bus,db:this.db,entries:this.entries,extensionContextBase:this.extensionContextBase,loadConfig:this.loadConfig,signal:this.shutdownController.signal,hasActiveExtension:e=>this.hasActiveExtension(e),persistEnabled:this.persistEnabled,contributionProcessors:this.contributionProcessors,getExtensionService:e=>this.getExtensionService(e),runHealthCheck:e=>J(this.createExtensionHealthHost(),e),emitWarningsForEntry:(e,t)=>k({bus:this.bus,entries:this.entries,warningActionMap:this.warningActionMap},e,t)},e,t)}createExtensionContextHost(){return{bus:this.bus,extensionContextBase:this.extensionContextBase,loadConfig:this.loadConfig,signal:this.shutdownController.signal,hasActiveExtension:e=>this.hasActiveExtension(e),getExtensionService:e=>this.getExtensionService(e)}}createExtensionHealthHost(){return{bus:this.bus,entries:this.entries}}hasActiveExtension(e){return this.entries.get(e)?.state===`active`}};export{m as a,g as i,V as n,h as o,H as r,xe as t};

package/dist/extension-CpIUgBKI.mjs

@@ -0,0 +1 @@
+import{n as e}from"./definition-DZMXOnjX.mjs";import{n as t,t as n}from"./version-BeT3ASEe.mjs";import{z as r}from"zod";const i=r.object({entrypoint:r.string().startsWith(`/`,{message:`Entrypoint must be a URL path starting with "/"`})}),a=r.object({endpoint:r.string().url().optional()}),o=r.union([e,r.object({anthropic:a.optional(),openai:a.optional()}).refine(e=>Object.keys(e).length>0,{message:`ProtocolRef config object must specify at least one protocol`})]),s=r.object({id:r.string().min(1),version:t,binaryVersion:t.optional()}),c=r.object({name:r.string().min(1),displayName:r.string().min(1).optional(),description:r.string().optional(),clients:r.array(s).readonly().optional(),protocols:r.array(o).min(1).readonly(),defaultProvider:r.string().min(1).optional()}),l=r.object({id:r.string().min(1),name:r.string().min(1),description:r.string().optional(),binary:r.object({name:r.string().min(1),managed:r.boolean().optional(),version:n.optional()}).strict().refine(e=>e.managed!==!0||e.version!==void 0,{message:`binary.version is required when binary.managed is true`,path:[`version`]}).refine(e=>e.version===void 0||e.managed===!0,{message:`binary.managed must be true when binary.version is provided`,path:[`managed`]}).optional()}).strict(),u=r.object({id:r.string().min(1),name:r.string().min(1),description:r.string().optional()}),d=r.object({prefix:r.string().min(1),description:r.string().optional(),stage:r.enum([`gather`,`transform`,`action`]).optional()}),f=r.object({adapterName:r.string().min(1),displayName:r.string().min(1),logFilePattern:r.string().min(1).optional()}),p=r.object({id:r.string().min(1),label:r.string().min(1),description:r.string().optional(),icon:r.string().min(1).optional(),selectionMode:r.enum([`single`,`multi`]),messageRoles:r.array(r.enum([`user`,`assistant`])).readonly().optional()}),m=r.enum([`beforeCreate`,`beforeRevise`,`afterCreate`,`afterRevise`,`afterStatusChanged`,`afterObservationAdded`]),h=r.object({id:r.string().min(1),event:m,kind:r.string().min(1).optional(),schemaVersion:r.string().min(1).optional()}),g=r.object({tiles:r.boolean().optional(),widgets:r.boolean().optional(),pages:r.boolean().optional(),routes:r.boolean().optional()}),_={adapters:`adapter`,clients:`client`,providers:`provider`,triggers:`trigger`,logImporters:`log importer`,sessionEventActions:`session event action`,artifactLifecycleHooks:`artifact lifecycle hook`};function v(e,t,n){e.addIssue({code:r.ZodIssueCode.custom,path:[t],message:`Duplicate ${_[t]} contribution identifier "${n}"`})}function y(e,t){let n=new Set,r=new Set,i=[];for(let a of e??[]){let e=t(a);if(n.has(e)){r.has(e)||(r.add(e),i.push(e));continue}n.add(e)}return i}const b=r.object({adapters:r.array(c).readonly().optional(),clients:r.array(l).readonly().optional(),providers:r.array(u).readonly().optional(),triggers:r.array(d).readonly().optional(),logImporters:r.array(f).readonly().optional(),sessionEventActions:r.array(p).readonly().optional(),artifactLifecycleHooks:r.array(h).readonly().optional(),create:r.boolean().optional(),tools:r.boolean().optional(),bootstrap:r.boolean().optional(),namespace:r.boolean().optional(),configSchema:r.boolean().optional(),uiConfig:r.boolean().optional(),ui:g.optional()}).superRefine((e,t)=>{for(let n of y(e.adapters,e=>e.name))v(t,`adapters`,n);for(let n of y(e.clients,e=>e.id))v(t,`clients`,n);for(let n of y(e.providers,e=>e.id))v(t,`providers`,n);for(let n of y(e.triggers,e=>e.prefix))v(t,`triggers`,n);for(let n of y(e.logImporters,e=>e.adapterName))v(t,`logImporters`,n);for(let n of y(e.sessionEventActions,e=>e.id))v(t,`sessionEventActions`,n);for(let n of y(e.artifactLifecycleHooks,e=>e.id))v(t,`artifactLifecycleHooks`,n)}),x=r.string().trim().min(1).transform(e=>e),S=r.object({name:r.string().min(1),required:r.boolean().optional()}),C=r.object({id:r.string(),style:r.enum([`tray-popover`,`utility`,`panel`]),width:r.number().optional(),height:r.number().optional(),singleton:r.boolean().optional(),params:r.array(S).readonly().optional()}).superRefine((e,t)=>{let n=new Set;for(let[i,a]of e.params?.entries()??[]){if(!n.has(a.name)){n.add(a.name);continue}t.addIssue({code:r.ZodIssueCode.custom,message:`Duplicate window param "${a.name}"`,path:[`params`,i,`name`]})}}),w=r.object({label:r.string(),section:r.enum([`utilities`,`tools`,`views`]).optional(),opensWindow:r.string().optional(),action:r.string().optional()}),T=r.object({name:r.string().min(1),description:r.string(),required:r.boolean().optional(),positional:r.boolean().optional(),short:r.string().regex(/^-[A-Za-z0-9]$/,`Expected a short flag like -p`).optional(),type:r.enum([`string`,`boolean`,`number`]).optional()}),E=r.object({name:r.string().min(1),description:r.string(),args:r.array(T).readonly().optional()}),D=r.object({name:r.string().min(1),description:r.string(),subcommands:r.array(E).readonly().optional(),hasInteractive:r.boolean().optional(),canProvideBus:r.boolean().optional()}),O=r.string().min(1).refine(e=>!/^(?:[\\/]|[A-Za-z]:)/.test(e),`Expected a relative path`).refine(e=>!e.split(/[\\/]/).some(e=>e===``||e===`.`||e===`..`),`Path must not contain empty or dot segments`),k=r.object({migrations:O.optional(),migrationSourceId:r.string().min(1).optional()}),A=r.object({type:r.literal(`extension`),name:r.string().min(1),version:t,optional:r.boolean().optional()});function j(e,t=`>=0.1.0`,n){return n===void 0?{type:`extension`,name:e,version:t}:{type:`extension`,name:e,version:t,optional:n}}const M=r.discriminatedUnion(`type`,[r.object({type:r.literal(`host`),id:r.string().min(1)}),r.object({type:r.literal(`capability`),id:r.string().min(1),version:t.optional()})]),N=r.object({name:r.string().min(1).regex(/^(@[^/\\]+\/)?[^/\\]+$/,`Extension name must be a plain identifier or an npm-scoped name (@scope/pkg)`).refine(e=>(e.startsWith(`@`)?e.split(`/`):[e]).every(e=>e!==`.`&&e!==`..`),`Extension name must not be a dot-segment`),displayName:r.string().min(1),version:n,surface:r.enum([`interactive`,`headless`,`any`]).optional(),dependencies:r.array(A).readonly().optional(),requires:r.array(M).readonly().optional(),provides:r.array(x).readonly().optional(),windows:r.array(C).readonly().optional(),tray:w.optional(),cli:D.optional(),storage:k.optional(),browser:i.optional(),contributions:b.optional()});function P(e){return Object.freeze({name:e})}const F=r.object({command:r.string().min(1),args:r.array(r.string()).optional(),env:r.record(r.string(),r.string()).optional(),healthTimeoutMs:r.number().int().positive().optional(),shutdownTimeoutMs:r.number().int().positive().optional()}),I=r.enum([`none`,`on-crash`,`always`]),L=F.extend({restartPolicy:I.optional()}),R=r.discriminatedUnion(`type`,[L.extend({type:r.literal(`bus-stdio`)}),L.extend({type:r.literal(`bus-websocket`)}),F.extend({type:r.literal(`mcp-stdio`)})]);function z(e){if(e.includes(`\\`)||e.startsWith(`./`)||e.startsWith(`../`)||e.startsWith(`/`))return!1;let t=e.split(`/`),n=t.at(-1);return!n||n.includes(`.`)?!1:t.every(e=>e!==``&&e!==`.`&&e!==`..`&&e!==`src`&&e!==`dist`)}const B=r.union([r.literal(!0),r.string().min(1).refine(z,{message:`entrypoint stem must use forward-slash path stems, must not contain empty, . or .. segments, must not include a dotted final segment, and must not contain src or dist segments`})]),V=r.object({server:B.optional(),browser:B.optional(),cli:B.optional()}).refine(e=>e.server!==void 0||e.browser!==void 0||e.cli!==void 0,{message:`at least one entrypoint must be declared`});function H(e){return e.execution===`detached`}const U=N.extend({version:n,makaio:r.object({framework:t}).strict().readonly(),entrypoints:V.optional(),execution:r.enum([`embedded`,`detached`]).optional(),transport:R.optional(),config:r.object({defaults:r.record(r.string(),r.unknown()).optional()}).optional()}).superRefine((e,t)=>{e.execution===`detached`?(e.transport===void 0&&t.addIssue({code:r.ZodIssueCode.custom,message:`detached extensions must declare a 'transport' config`,path:[`transport`]}),e.entrypoints!==void 0&&t.addIssue({code:r.ZodIssueCode.custom,message:`detached extensions must not declare entrypoints`,path:[`entrypoints`]})):(e.entrypoints===void 0&&t.addIssue({code:r.ZodIssueCode.custom,message:`embedded extensions must declare at least one entrypoint`,path:[`entrypoints`]}),e.transport!==void 0&&t.addIssue({code:r.ZodIssueCode.custom,message:`embedded extensions must not declare a transport config`,path:[`transport`]}))});function W(e){return e}function G(e){return W(U.parse(e))}function K(e){let t=U.safeParse(e);return t.success?{success:!0,data:W(t.data)}:t}const q=r.discriminatedUnion(`kind`,[r.object({kind:r.literal(`configure-integration`),clientId:r.string().min(1),bundle:r.string().min(1)}),r.object({kind:r.literal(`install-extension`),extensionName:r.string().min(1)}),r.object({kind:r.literal(`open-url`),url:r.string().url()}),r.object({kind:r.literal(`run-command`),command:r.string().min(1)})]),J=r.enum([`info`,`recommended`,`degraded`]),Y=r.object({severity:J,title:r.string().min(1),message:r.string().min(1),action:q.optional()});function X(e){switch(e.kind){case`configure-integration`:return`Configure`;case`install-extension`:return`Install`;case`open-url`:return`Open`;case`run-command`:return`Run`}}const Z=r.object({extensionName:r.string().min(1),warnings:r.array(Y)});function Q(e,t){return e.parse(t??{})}function $(e){return JSON.stringify([e.extensionId,e.type,e.name,e.filename])}export{h as A,i as B,C,s as D,x as E,o as F,u as I,p as L,b as M,f as N,c as O,a as P,d as R,w as S,j as T,E as _,Y as a,M as b,R as c,H as d,G as f,D as g,T as h,Z as i,l as j,m as k,U as l,P as m,Q as n,J as o,K as p,q as r,X as s,$ as t,V as u,A as v,S as w,k as x,N as y,g as z};

package/dist/facet-BuwhrThl.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";const n=e.enum([`human`,`system`,`agent`]),r=e.enum([`single`,`multiple`]),i=e.enum([`workpiece`,`artifact`,`surface`]),a=e.object({namespace:e.string().min(1).regex(/^[a-z][a-z0-9-]*$/),cardinality:r,values:e.union([e.literal(`open`),e.array(e.string().min(1)).readonly()]),authority:e.array(n).min(1).readonly(),appliesTo:e.array(i).min(1).readonly(),description:e.string().min(1).optional()});function o(e){return{namespace:e.namespace,toRegistration:()=>({namespace:e.namespace,cardinality:e.cardinality,values:e.values===`open`?`open`:[...e.values],authority:[...e.authority],appliesTo:[...e.appliesTo],...e.description===void 0?{}:{description:e.description}})}}const s={"namespace.register":{request:a,response:e.object({registered:e.boolean()})},"namespace.list":{request:e.object({namespace:e.string().min(1).optional()}),response:e.object({namespaces:e.array(a)})},"namespace.changed":e.object({namespace:e.string().min(1)})},c=t(`facet`,s),l=c.subjects;export{i as a,a as c,o as i,s as n,n as o,l as r,r as s,c as t};

package/dist/filesystem-service-B8rhBRgB.mjs

@@ -0,0 +1 @@
+import{FileSystemSubjects as e,FsSubjects as t}from"./services/filesystem/namespace.mjs";import*as n from"node:fs/promises";import*as r from"node:path";import{BaseService as i}from"@makaio/framework/service-base";import*as a from"node:os";const o=[`node_modules`,`.git`,`dist`,`build`,`.next`,`coverage`,`.turbo`,`.cache`];function s(e){return e.split(r.sep).filter(Boolean)}function c(e){let t=r.dirname(e);return t===e?null:t}function l(e){let t=s(e),n=[],i=r.parse(e).root;for(let e of t)i=r.join(i,e),n.push({name:e,path:i});return n}async function u(e,t){let i=r.resolve(e),a=await n.readdir(i,{withFileTypes:!0}),u=t?.includeHidden??!1,d=new Set(t?.excludeNames??o),f=[],p=[];for(let e of a){if(e.name.startsWith(`.`)&&!u||d.has(e.name))continue;let t=r.join(i,e.name),a=e.isDirectory();try{let i=!1;if(a)try{await n.access(r.join(t,`.git`)),i=!0}catch{}let o=await n.stat(t);f.push({name:e.name,path:t,type:a?`directory`:`file`,isGitRepo:a?i:void 0,size:a?void 0:o.size,modified:o.mtimeMs})}catch(t){let n=t;p.push({name:e.name,code:n.code??`UNKNOWN`,message:n.message})}}f.sort((e,t)=>e.type===t.type?e.name.localeCompare(t.name):e.type===`directory`?-1:1);let m=!1;try{await n.access(r.join(i,`.git`)),m=!0}catch{}return{entries:f,isGitRepo:m,path:i,parentPath:c(i),segments:s(i),breadcrumbs:l(i),errors:p.length>0?p:void 0}}var d=class extends i{machineId;label;constructor(e,t,n=`Local`){super(e),this.machineId=t,this.label=n}async onInit(){this.registerHandler(e.listSources,e=>{e.identify?.(this.machineId),e.setResult({sources:[{machineId:this.machineId,label:this.label}]})}),this.addCleanup(this.bus.on(e.listDirectory,async e=>{let t=await u(e.payload.path??a.homedir(),e.payload.options);e.setResult(t)},{filter:{machineId:this.machineId}})),this.addCleanup(this.bus.on(e.getHomeDir,e=>{e.setResult({path:a.homedir()})},{filter:{machineId:this.machineId}})),this.registerHandler(t.glob,async e=>{let{pattern:t,cwd:i,limit:a=100,offset:o=0,ignore:s=[],machineId:c}=e.payload;if(this.requireMachineIdForRemote(e,c),c!==void 0&&!this.shouldHandle(c))return;let{globby:l}=await import(`./globby-rtWVaFHv.mjs`).then(e=>e.n),u=await l(t,{cwd:i,ignore:[`node_modules/**`,`.git/**`,...s],absolute:!0,onlyFiles:!1,expandDirectories:!1}),d=u.length,f=o+a<d,p=u.slice(o,o+a),m=await Promise.all(p.map(async e=>{let t=r.relative(i,e),a=`file`,o;try{let t=await n.stat(e);a=t.isDirectory()?`directory`:`file`,o=t.isFile()?t.size:void 0}catch{}return{path:e,relativePath:t,type:a,size:o}}));e.setResult({files:m,truncated:f,total:d})}),this.registerHandler(t.readFile,async e=>{let{path:t,machineId:r,encoding:i=`utf-8`}=e.payload;if(this.requireMachineIdForRemote(e,r),r!==void 0&&!this.shouldHandle(r))return;let a=await n.readFile(t,{encoding:i});e.setResult({content:a})}),this.registerHandler(t.writeFile,async e=>{let{path:t,content:r,machineId:i,encoding:a=`utf-8`}=e.payload;this.requireMachineIdForRemote(e,i),!(i!==void 0&&!this.shouldHandle(i))&&(await n.writeFile(t,r,{encoding:a}),e.setResult({success:!0}))})}requireMachineIdForRemote(e,t){if(!this.isHostOwnedOrigin(e)&&t===void 0)throw Error(`machineId is required for remote filesystem access`)}isHostOwnedOrigin(e){return e.origin.local||e.transport?.transportName===`worker`&&e.transport.peer===void 0}shouldHandle(e){return e===this.machineId}};export{d as t};

package/dist/filesystem-service-p_iJVHd4.d.mts

@@ -0,0 +1,66 @@
+import { IMakaioBus } from "@makaio/framework/bus";
+import { BaseService } from "@makaio/framework/service-base";
+
+//#region services/core/src/filesystem/filesystem-service.d.ts
+/**
+ * FileSystemService provides filesystem browsing via bus requests.
+ *
+ * Handles:
+ * - listSources: Returns this machine as an available source
+ * - listDirectory: Lists directory contents
+ * - getHomeDir: Returns home directory path
+ * - glob: Pattern-based file search
+ * - readFile: Read file content
+ * - writeFile: Write file content
+ * @example
+ * ```typescript
+ * const fsService = new FileSystemService(bus, 'local-machine', 'Local');
+ * // BaseService lifecycle is explicit: call init() once before bus requests.
+ * await fsService.init();
+ *
+ * const home = await bus.request(FileSystemSubjects.getHomeDir, {});
+ * const listing = await bus.request(FileSystemSubjects.listDirectory, { path: home.path });
+ * const files = await bus.request(FsSubjects.glob, { pattern: '**\/*.ts', cwd: '/project' });
+ * const content = await bus.request(FsSubjects.readFile, { path: '/path/to/file.ts' });
+ * ```
+ */
+declare class FileSystemService extends BaseService {
+  private readonly machineId;
+  private readonly label;
+  /**
+   * Create a filesystem service instance for a specific machine source.
+   * @param bus - Bus instance used to register request handlers
+   * @param machineId - Machine identifier used for request routing
+   * @param label - Human-readable source label (defaults to 'Local')
+   */
+  constructor(bus: IMakaioBus, machineId: string, label?: string);
+  /**
+   * Register bus handlers for filesystem operations.
+   */
+  protected onInit(): Promise<void>;
+  /**
+   * Throw when a remote caller omits the required `machineId`.
+   *
+   * Remote callers must include `machineId` so ownership is explicit and the
+   * correct service instance can be selected. Host-owned callers may omit it:
+   * direct in-process requests are local, and the browser SharedWorker bridge
+   * arrives through the `worker` transport without a remote peer.
+   * @param ctx - Bus context for the current request
+   * @param machineId - The `machineId` from the request payload
+   */
+  private requireMachineIdForRemote;
+  /**
+   * Check whether a request originated from host-owned code.
+   * @param ctx - Bus context for the current request.
+   * @returns True for local requests and host UI bridge requests.
+   */
+  private isHostOwnedOrigin;
+  /**
+   * Check if this service should handle the request.
+   * @param requestMachineId - The machineId from the request payload
+   * @returns True if this service should handle the request
+   */
+  private shouldHandle;
+}
+//#endregion
+export { FileSystemService as t };

package/dist/git/index.d.mts

@@ -0,0 +1,210 @@
+import { IMakaioBus } from "@makaio/framework/bus";
+import { BaseService } from "@makaio/framework/service-base";
+
+//#region subsystems/git/src/git-service.d.ts
+/**
+ * GitService provides git repository functionality via bus requests.
+ *
+ * Combines:
+ * - Query operations:
+ *   - getRepoRoot, getBranch, getCommit, getStatus, getWorktrees, getRemotes, getDefaultBranch
+ *   - getLog, getFileAtRevision
+ *   - getFileAtCommit — returns file content at a commit with null-safe binary/missing semantics
+ *   - getBlobHashAtCommit — returns blob hash for divergence checks
+ * - File watching: monitors .git directories and emits events (commit, checkout, staging, etc.)
+ * - Multi-repo support: addRepo/removeRepo for watching multiple repositories
+ * @example
+ * ```typescript
+ * import { MakaioBus } from '@makaio/framework/bus';
+ * import { GitService } from '@makaio/framework/services/git';
+ * import { GitSubjects } from '@makaio/framework/services/git/namespace';
+ *
+ * // Initialize the service
+ * const gitService = new GitService(bus);
+ * await gitService.init();
+ *
+ * // Make requests via bus
+ * const branch = await bus.request(GitSubjects.getBranch, {});
+ * console.log('Current branch:', branch.current);
+ *
+ * // Watch a repo for events
+ * await bus.request(GitSubjects.addRepo, { repoPath: '/path/to/repo' });
+ *
+ * // Listen for git events
+ * bus.on(GitSubjects.commit, (ctx) => {
+ *   console.log('New commit:', ctx.payload.hash);
+ * });
+ *
+ * // Cleanup when done
+ * await gitService.destroy();
+ * ```
+ */
+declare class GitService extends BaseService {
+  private readonly watcher;
+  private readonly logCache;
+  private readonly workingTreeCache;
+  private readonly fingerprintCache;
+  /**
+   * @param bus - Bus instance for registering handlers
+   */
+  constructor(bus: IMakaioBus);
+  protected onInit(): Promise<void>;
+  protected onDestroy(): Promise<void>;
+  /**
+   * Register query request handlers on the bus.
+   */
+  private registerQueryHandlers;
+  private registerGitStateHandlers;
+  private registerHistoryHandlers;
+  private registerWorktreeManagementHandlers;
+  /**
+   * Assert that a git mutation came from host-owned code or the host UI bridge.
+   * @param ctx - Bus handler context carrying origin and transport metadata.
+   * @param handlerName - Git handler name used in the error message.
+   */
+  private requireHostOwnedOrigin;
+  /**
+   * Register the fingerprint request handler on the bus.
+   *
+   * Serves cached results when available. On a miss, computes the fingerprint
+   * via {@link computeFingerprint} and stores it under the resolved invalidation root.
+   */
+  private registerFingerprintHandler;
+  /**
+   * Invalidate all log cache entries for a specific repository.
+   * @param repoPath - Repository path to invalidate
+   */
+  private invalidateLogCache;
+  /**
+   * Invalidate all working tree cache entries for a specific repository.
+   * @param repoPath - Repository path to invalidate
+   */
+  private invalidateWorkingTreeCache;
+  /**
+   * Invalidate all fingerprint cache entries for a specific repository.
+   * @param repoPath - Repository path to invalidate
+   */
+  private invalidateFingerprintCache;
+  /**
+   * Resolve repository path for caching and git operations.
+   * @param request - Request with optional repoPath property
+   * @returns Repository path string
+   */
+  private resolveRepoPath;
+  /**
+   * Register handlers that invalidate caches on relevant git events.
+   */
+  private registerCacheInvalidationHandlers;
+}
+//#endregion
+//#region subsystems/git/src/git-watcher.d.ts
+/** Types of git operations that can be detected from .git file changes. */
+type GitOperationType = 'commit' | 'checkout' | 'staging' | 'merge' | 'rebase';
+/** Result of interpreting a file change as a git operation. */
+type InterpretResult = {
+  type: GitOperationType | 'worktree-added' | 'worktree-removed';
+  worktree: string | undefined;
+} | null;
+interface FileChange {
+  path: string;
+  kind: 'create' | 'change' | 'delete';
+}
+/**
+ * GitWatcher observes .git/ directory changes and emits semantic git events.
+ * Supports watching multiple repositories simultaneously.
+ *
+ * This is an internal component used by GitService.
+ */
+declare class GitWatcher {
+  private readonly bus;
+  private readonly watchers;
+  private unsubFsChanged;
+  private unsubAddRepo;
+  private unsubRemoveRepo;
+  private initialized;
+  constructor(bus: IMakaioBus);
+  /** Initialize the watcher and register bus handlers. */
+  init(): Promise<void>;
+  /** Destroy the watcher and cleanup all watchers. */
+  destroy(): Promise<void>;
+  /**
+   * Add a repository to watch.
+   * @param repoPath - Absolute path to the repository root.
+   * @returns Response indicating success or failure.
+   */
+  private addRepo;
+  /**
+   * Resolve the directory that should be watched for git metadata changes.
+   *
+   * For standard repos, `.git` is a directory and is returned directly.
+   * For worktree checkouts, `.git` is a file containing `gitdir: <path>`.
+   * In that case we resolve and return the referenced git directory.
+   * @param repoPath - Absolute path to repository/worktree root
+   * @returns Absolute path to git metadata directory
+   */
+  private resolveGitDir;
+  /**
+   * Remove a repository from watching.
+   * @param repoPath - Absolute path to the repository root.
+   * @returns Response indicating success or failure.
+   */
+  private removeRepo;
+  /**
+   * Handle fs.changed event - route to correct repo watcher.
+   * Uses path.relative to ensure the change is actually inside gitDir,
+   * not just a path that shares the same prefix (e.g., .git-backup).
+   * @param change - The file change event from FileWatcher.
+   */
+  private handleFsChange;
+  /**
+   * Narrow an `InterpretResult` type to the subset that can be covered by a native git hook.
+   *
+   * Only `commit` and `checkout` are suppressible — `merge`, `rebase`, `staging`, and
+   * worktree events are always emitted from filesystem inference regardless of hook coverage.
+   * @param type - The operation type from a non-null {@link InterpretResult}.
+   * @returns `true` when `type` is `'commit'` or `'checkout'`, the two suppressible operations.
+   */
+  private isSuppressibleOperation;
+  /**
+   * Query the git-hook coverage service to determine whether a native hook already
+   * covers the given operation for the repo associated with `watcher`.
+   *
+   * Uses {@link IMakaioBus.requestOptional} so missing coverage providers preserve
+   * filesystem-event emission behaviour. Other coverage failures are also treated
+   * as uncovered because native hook coverage is an optimization over the fallback path.
+   * @param watcher - The per-repo watcher state providing the repo root path.
+   * @param operation - The git operation GitWatcher is about to emit.
+   * @param worktree - Worktree name when the change is worktree-scoped, otherwise `undefined`.
+   * @returns `true` only when a coverage handler confirms the hook is installed and verified.
+   */
+  private isCoveredByNativeHook;
+  /**
+   * Handle change for a specific repo.
+   * @param watcher - The repo watcher state.
+   * @param change - The file change event.
+   * @returns True when the watcher recognized and handled the change.
+   */
+  private handleRepoChange;
+  /**
+   * Get working directory for a worktree.
+   * @param watcher - The repo watcher state.
+   * @param worktree - The worktree name, or undefined for main worktree.
+   * @returns The working directory path.
+   */
+  private getWorkingDir;
+  private emitCommitEvent;
+  private emitCheckoutEvent;
+  private emitStagingEvent;
+  private emitMergeEvent;
+  private emitRebaseEvent;
+  private emitWorktreeEvent;
+  /**
+   * Interpret a file change for testing purposes.
+   * @param gitDir - The .git directory path.
+   * @param change - The file change event.
+   * @returns Interpretation result or null if unrecognized.
+   */
+  interpretChange(gitDir: string, change: FileChange): InterpretResult;
+}
+//#endregion
+export { type GitOperationType, GitService, GitWatcher, type InterpretResult };