@makaio/contracts 1.0.0-dev-1779051654000

package/dist/client/session-observed.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Observed session semantics schemas for the client domain.
+ *
+ * Covers the shared base payload, all per-event schemas for normalized
+ * lifecycle signals emitted by client adapters (`client.session.*`), and
+ * the wiring entry schema used by `client.wiring.list`.
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Shared base payload for all `client.session.*` observed-semantics events.
+ *
+ * These events are emitted by client adapters when they observe lifecycle
+ * signals from the underlying client runtime. They are **not** control
+ * messages — they carry normalized observations forwarded to the bus so
+ * listeners can react without coupling to a specific adapter implementation.
+ *
+ * Fields:
+ * - `clientId` — stable string ID of the client (e.g. `'claude-code'`).
+ * - `source` — how the observation was captured (e.g. `'native-hook'`,
+ *   `'adapter-derived'`).
+ * - `observedAt` — Unix epoch timestamp in milliseconds when the signal
+ *   was captured by the adapter.
+ * - `sessionId` — framework session ID, if already resolved.
+ * - `adapterSessionId` — raw session identifier from the client runtime,
+ *   if available.
+ * - `metadata` — arbitrary pass-through data from the adapter.
+ */
+export declare const ClientSessionObservedBaseSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ClientSessionObservedBase = z.infer<typeof ClientSessionObservedBaseSchema>;
+/**
+ * Payload for `client.session.started`.
+ *
+ * Emitted when an adapter observes that a new client session has begun.
+ * This is a normalized observed signal — not a command. The session may not
+ * yet be linked to a framework session at emission time.
+ */
+export declare const ClientSessionStartedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ClientSessionStarted = z.infer<typeof ClientSessionStartedSchema>;
+/**
+ * Payload for `client.session.userPrompt.submitted`.
+ *
+ * Emitted when an adapter observes that the user has submitted a prompt to
+ * the client runtime. The `prompt` field carries the raw prompt text when
+ * the adapter has access to it.
+ */
+export declare const ClientSessionUserPromptSubmittedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClientSessionUserPromptSubmitted = z.infer<typeof ClientSessionUserPromptSubmittedSchema>;
+/**
+ * Payload for `client.session.turn.started`.
+ *
+ * Emitted when an adapter observes the beginning of an assistant turn inside
+ * an ongoing client session.
+ */
+export declare const ClientSessionTurnStartedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ClientSessionTurnStarted = z.infer<typeof ClientSessionTurnStartedSchema>;
+/**
+ * Payload for `client.session.turn.completed`.
+ *
+ * Emitted when an adapter observes that an assistant turn has finished inside
+ * an ongoing client session.
+ */
+export declare const ClientSessionTurnCompletedSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ClientSessionTurnCompleted = z.infer<typeof ClientSessionTurnCompletedSchema>;
+/**
+ * Payload for `client.session.tool.pre`.
+ *
+ * Emitted when an adapter observes that a tool call is about to be executed
+ * by the client runtime. The `toolName` and `toolCallId` fields identify the
+ * specific invocation when the adapter has access to them.
+ */
+export declare const ClientSessionToolPreSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClientSessionToolPre = z.infer<typeof ClientSessionToolPreSchema>;
+/**
+ * Payload for `client.session.tool.post`.
+ *
+ * Emitted when an adapter observes that a tool call has completed inside the
+ * client runtime. The `success` field reflects the outcome when the adapter
+ * can determine it.
+ */
+export declare const ClientSessionToolPostSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    source: z.ZodString;
+    observedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    success: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ClientSessionToolPost = z.infer<typeof ClientSessionToolPostSchema>;
+/**
+ * A single wiring entry in a client `wiring.list` response.
+ *
+ * Represents one hook (or statusline) that Makaio can install into the
+ * client's native config.
+ */
+export declare const ClientWiringEntrySchema: z.ZodObject<{
+    group: z.ZodString;
+    name: z.ZodString;
+    installed: z.ZodBoolean;
+    command: z.ZodString;
+}, z.core.$strip>;
+/** A single wiring entry in a list response. */
+export type ClientWiringEntry = z.infer<typeof ClientWiringEntrySchema>;
+//# sourceMappingURL=session-observed.d.ts.map

package/dist/client/session-observed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-observed.d.ts","sourceRoot":"","sources":["../../src/client/session-observed.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,+BAA+B;;;;;;;iBAgB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAA6C,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;iBAGjD,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;iBAA6C,CAAC;AAEzF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;;;;iBAA6C,CAAC;AAE3F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAUtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAYlC,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/client-DBA09LFd.mjs

@@ -0,0 +1 @@
+import{t as e}from"./schemas-BJb5W0VZ.mjs";import{_ as t,a as n,g as r,h as i,m as a,n as ee,o as te}from"./profile-Bcegl5D9.mjs";import{n as ne,t as o}from"./version-u2rO7guD.mjs";import{c as re,d as ie,n as ae,o as oe,s as se,t as s,u as c}from"./account-identity-ZrtBl3Bq.mjs";import{createBusNamespace as ce}from"@makaio/framework/core";import{z as l}from"zod";const u=l.object({tag:l.string(),description:l.string().optional()}),d=l.object({name:l.string(),friendlyName:l.string(),description:l.string().optional(),category:l.string().optional(),capabilities:l.array(u).default([])}),f=l.object({id:l.string(),name:l.string(),description:l.string().optional(),glob:l.string().optional()}),p=l.object({name:l.string().min(1),frameworkSubject:l.string().min(1).optional()}),m=l.object({envVar:r.regex(/^[A-Za-z_][A-Za-z0-9_]*$/,{message:`envVar must be a valid environment variable name (letters, digits, underscores)`}),defaultPath:r.refine(e=>e===`~`||e.startsWith(`~/`)||t(e),{message:`defaultPath must be absolute, '~', or start with '~/'`}),pathKind:l.enum([`directory`,`file`]).default(`directory`)});function le(e){if(!e.startsWith(`@`))return!e.includes(`@`);let t=e.indexOf(`/`);return t>1&&!e.slice(t+1).includes(`@`)}const h=l.object({type:l.literal(`npm`),package:l.string().min(1).refine(le,{message:"package must not include an inline `@version` suffix; use the version field instead"}),version:o}),g=l.object({type:l.literal(`signed-binary-bucket`),version:o,config:l.object({baseUrl:l.string().url(),manifestPathTemplate:l.string().min(1),manifestSignaturePathTemplate:l.string().min(1),publicKeyUrl:l.string().url(),publicKeyFingerprint:l.string().min(1),binaryPathTemplate:l.string().min(1),platforms:l.record(l.string().min(1),l.string().min(1))})}),_=l.discriminatedUnion(`type`,[h,g]),v=l.object({executable:l.union([l.string().min(1),l.object({default:l.string().min(1),darwin:l.string().min(1).optional(),linux:l.string().min(1).optional(),win32:l.string().min(1).optional()}).strict()]),args:l.array(l.string()).default([])}).strict(),y=l.object({kind:l.string().min(1),payload:l.record(l.string(),l.unknown()).optional()}),b=l.object({supportsHooks:l.boolean().default(!1),supportsStatusline:l.boolean().default(!1),supportsSupervisorLaunch:l.boolean().default(!1),supportsManagedBinary:l.boolean().default(!1),hookEvents:l.array(p).default([])}).refine(e=>e.supportsHooks||e.hookEvents.length===0,{message:`hookEvents must be empty when supportsHooks is false`,path:[`hookEvents`]}),x=l.object({name:l.string().min(1),supportedVersions:ne}).strict(),S=l.object({id:l.string(),name:l.string(),version:o,description:l.string().optional(),binary:x.optional(),nativeTools:l.array(d).default([]),defaultApprovalPolicy:e,logSources:l.array(f).optional(),defaultProviderId:l.string().optional(),runtimeCapabilities:b.optional().transform(e=>b.parse(e??{})),managedInstall:_.optional(),versionCommand:v.optional(),postInstall:y.optional(),configIsolation:m.optional()}).strict().refine(e=>!e.runtimeCapabilities.supportsManagedBinary||e.managedInstall!==void 0,{message:`managedInstall is required when runtimeCapabilities.supportsManagedBinary is true`,path:[`managedInstall`]}).refine(e=>e.managedInstall===void 0||e.runtimeCapabilities.supportsManagedBinary,{message:`runtimeCapabilities.supportsManagedBinary must be true when managedInstall is provided`,path:[`runtimeCapabilities`,`supportsManagedBinary`]}).refine(e=>e.managedInstall===void 0||e.versionCommand!==void 0,{message:`versionCommand is required when managedInstall is provided`,path:[`versionCommand`]}).superRefine((e,t)=>{if(e.managedInstall===void 0||e.versionCommand===void 0)return;let{executable:n}=e.versionCommand,r=typeof n==`string`?[{path:n,issuePath:[`versionCommand`,`executable`]}]:[{path:n.default,issuePath:[`versionCommand`,`executable`,`default`]},...n.darwin===void 0?[]:[{path:n.darwin,issuePath:[`versionCommand`,`executable`,`darwin`]}],...n.linux===void 0?[]:[{path:n.linux,issuePath:[`versionCommand`,`executable`,`linux`]}],...n.win32===void 0?[]:[{path:n.win32,issuePath:[`versionCommand`,`executable`,`win32`]}]];for(let{path:e,issuePath:n}of r){let r=e.startsWith(`/`),i=/^[A-Za-z]:/.test(e),a=e.startsWith(`\\`);if(r||i||a){t.addIssue({code:l.ZodIssueCode.custom,path:n,message:`${n.join(`.`)} must be a relative path within the install directory`});continue}e.split(/[/\\]/).some(e=>e===`..`)&&t.addIssue({code:l.ZodIssueCode.custom,path:n,message:`${n.join(`.`)} must be a relative path within the install directory`})}}),C=l.object({binaryPath:a.nullable(),env:l.record(l.string(),l.string()),configDir:a.nullable(),source:l.enum([`managed`,`global`]),version:r.nullable()}),w={request:l.object({clientId:r,sessionId:r.optional(),projectDir:a.optional(),preferSource:l.enum([`managed`,`global`]).optional(),harnessId:r.optional()}),response:C},T=l.enum([`npm`,`signed-binary-bucket`]),E=l.object({version:r,installPath:a,installedAt:i,isActive:l.boolean()}),D=l.object({clientId:r,installedVersions:l.array(E),activeVersion:r.nullable(),pinnedVersion:o,updateAvailable:l.boolean()}).strict(),O={request:l.object({forceRefresh:l.boolean().optional()}),response:l.object({clients:l.array(D)})},k={request:l.object({clientId:r,version:o.optional()}),response:l.object({jobId:r,requestedVersion:o.nullable(),resolvedVersion:o.nullable()})},A={request:l.object({clientId:r,version:r}),response:l.object({clientId:r,removedVersion:r,activeVersion:r.nullable()})},j={request:l.object({clientId:r}),response:l.object({jobId:r,resolvedVersion:o.nullable()})},M={request:l.object({clientId:r,version:r}),response:l.object({clientId:r,activeVersion:r})},N=l.enum([`resolving`,`downloading`,`verifying`,`extracting`,`installing`,`post-install`,`activating`]),P=l.object({jobId:r,clientId:r,version:r.optional(),strategy:T,stage:N,progress:l.number().min(0).max(100).nullable(),installPath:a.optional(),activeAfterCompletion:l.boolean().optional(),metadata:l.record(l.string(),l.unknown()).optional()}),F=l.object({message:l.string(),code:l.string().optional()}),I=l.object({jobId:r,clientId:r,version:r.optional(),strategy:T,status:l.enum([`success`,`error`]),installPath:a.optional(),activeVersion:r.nullable(),error:F.optional(),metadata:l.record(l.string(),l.unknown()).optional()}),L=l.object({clientId:r,previousActiveVersion:r.nullable(),activeVersion:r.nullable(),reason:l.enum([`install`,`update`,`set-active`,`uninstall`])}),R=l.enum([`supervisor`,`adapter`,`client-hook`,`statusline`,`cli-wrapper`]),z=l.object({layer:R,producer:r}),B=l.object({supervisorSessionId:r.optional(),pid:l.number().int().positive().optional(),parentPid:l.number().int().positive().optional(),adapterSessionId:r.optional(),sessionId:r.optional(),cwd:l.string().optional(),argv:l.array(l.string()).optional(),metadata:l.record(l.string(),l.unknown()).optional()}),V={request:l.object({clientId:r,source:z,observedAt:i}).merge(B).refine(e=>e.supervisorSessionId!==void 0||e.pid!==void 0||e.adapterSessionId!==void 0,{message:`At least one hard-evidence field is required (supervisorSessionId, pid, or adapterSessionId)`}),response:l.object({clientRuntimeId:r,created:l.boolean(),promoted:l.boolean()})},H=B.extend({clientRuntimeId:r,clientId:r,status:l.enum([`observed`,`started`]),source:z,observedAt:i}),U=l.object({clientId:r,source:r,observedAt:i,sessionId:l.string().optional(),adapterSessionId:l.string().optional(),metadata:l.record(l.string(),l.unknown()).optional()}),W=U.extend({}),G=U.extend({prompt:r.optional()}),K=U.extend({}),q=U.extend({}),J=U.extend({toolName:r.optional(),toolCallId:r.optional()}),Y=U.extend({toolName:r.optional(),toolCallId:r.optional(),success:l.boolean().optional()}),X=l.object({group:r,name:r,installed:l.boolean(),command:r}),Z={"runtime.observe":V,"runtime.started":H,scan:{request:l.object({targets:l.array(se).optional()}),response:l.object({results:l.array(oe)})},"session.account.observe":re,"account.observe":ae,"account.activate":{request:l.object({clientId:r,clientAccountId:r,identifiers:l.array(s).min(1),displayLabel:l.string().optional()}),response:l.object({accepted:l.boolean()})},"account.getActive":{request:l.object({clientId:r}),response:l.object({identity:l.object({clientAccountId:r,identifiers:l.array(s).min(1),displayLabel:l.string().optional()}).nullable()})},"usage.ingest":c,"usage.snapshot":ie,"session.started":W,"session.userPrompt.submitted":G,"session.turn.started":K,"session.turn.completed":q,"session.tool.pre":J,"session.tool.post":Y,"wiring.list":{request:l.object({clientId:r.optional(),projectDir:a.optional(),makaioCommand:r}),response:l.object({results:l.array(l.object({clientId:r,entries:l.array(X)}))})},list:O,install:k,uninstall:A,update:j,setActive:M,"installJob.progress":P,"installJob.completed":I,"version.changed":L,resolveBinary:w,...n,...te,"config.prime":ee},Q=ce(`client`,Z),ue=Q.subjects;function $(e){if(Array.isArray(e)){for(let t of e)$(t);return Object.freeze(e)}if(e&&typeof e==`object`){for(let t of Object.values(e))$(t);return Object.freeze(e)}return e}function de(e){return $(S.parse(e))}export{T as A,f as B,M as C,F as D,L as E,p as F,v as G,h as H,b as I,u as L,w as M,x as N,N as O,S as P,d as R,O as S,j as T,y as U,_ as V,g as W,H as _,U as a,P as b,J as c,G as d,X as f,z as g,R as h,Z as i,C as j,E as k,q as l,V as m,Q as n,W as o,B as p,ue as r,Y as s,de as t,K as u,D as v,A as w,k as x,I as y,m as z};

package/dist/common/action-intent.d.ts

@@ -0,0 +1,112 @@
+import type { FocusContext } from './focus-context.js';
+/**
+ * Describes a UI side effect that an action handler intends to produce.
+ *
+ * Action handlers return an `ActionIntent` rather than executing effects directly.
+ * The framework's intent executor interprets and dispatches each kind.
+ *
+ * SEAM: New intent kinds are added here. UI executors add the corresponding
+ * cases without leaking renderer dependencies into service packages.
+ * @example
+ * ```typescript
+ * const intent: ActionIntent = { kind: 'clipboard', text: commit.hash };
+ * const compound: ActionIntent = {
+ *   kind: 'compound',
+ *   intents: [
+ *     { kind: 'clipboard', text: commit.hash },
+ *     { kind: 'feedback', message: 'Hash copied', variant: 'success' },
+ *   ],
+ * };
+ * ```
+ */
+export type ActionIntent = {
+    readonly kind: 'noop';
+} | {
+    readonly kind: 'clipboard';
+    readonly text: string;
+    readonly feedback?: string;
+} | {
+    readonly kind: 'navigate';
+    readonly target: FocusContext;
+} | {
+    readonly kind: 'openEditor';
+    readonly filePath: string;
+    readonly line?: number;
+    readonly column?: number;
+} | {
+    readonly kind: 'openPage';
+    readonly pageId: string;
+    readonly internalRoute?: string;
+} | {
+    readonly kind: 'busRequest';
+    readonly subject: string;
+    readonly payload?: Record<string, unknown>;
+} | {
+    readonly kind: 'feedback';
+    readonly message: string;
+    readonly variant?: 'info' | 'success' | 'warning' | 'error';
+} | {
+    readonly kind: 'confirm';
+    readonly title: string;
+    readonly message: string;
+    readonly onConfirmIntent: ActionIntent;
+} | {
+    readonly kind: 'compound';
+    readonly intents: readonly ActionIntent[];
+}
+/**
+ * Open a diff view for a file.
+ *
+ * - `commitId` is `null` for working-tree diffs (right side is read from disk).
+ * - `status` is the git file status character (A/M/D/R/…) for commit contexts.
+ * - `parentCount` drives empty-tree handling for root commits.
+ * - `originalPath` carries the rename origin when the file was renamed.
+ * - `variant` is the working-tree section ('staged' | 'unstaged' | 'untracked' | 'conflicted').
+ */
+ | {
+    readonly kind: 'viewDiff';
+    readonly filePath: string;
+    readonly commitId: string | null;
+    readonly status?: string;
+    readonly parentCount?: number;
+    readonly originalPath?: string;
+    readonly variant?: string;
+}
+/**
+ * Show file content at a specific commit in the inline file viewer panel.
+ * Only valid for commit-context files.
+ */
+ | {
+    readonly kind: 'viewAtCommit';
+    readonly filePath: string;
+    readonly commitId: string;
+}
+/**
+ * Show blame annotations for a file at a specific commit in the inline blame panel.
+ * Only valid for commit-context files.
+ */
+ | {
+    readonly kind: 'viewBlame';
+    readonly filePath: string;
+    readonly commitId: string;
+}
+/**
+ * Compare a file across revisions using the diff viewer.
+ *
+ * Equivalent to `viewDiff` but with `useEmptyTreeForRoot = true` — root commits
+ * are shown as full-add diffs against the empty tree. For working-tree contexts,
+ * untracked files are silently skipped.
+ *
+ * - `commitId` is `null` for working-tree compare.
+ * - `status`, `parentCount`, `originalPath`, `variant` carry the same semantics as `viewDiff`.
+ */
+ | {
+    readonly kind: 'compareVersions';
+    readonly filePath: string;
+    readonly commitId: string | null;
+    readonly status?: string;
+    readonly parentCount?: number;
+    readonly originalPath?: string;
+    readonly variant?: string;
+};
+//# sourceMappingURL=action-intent.d.ts.map

package/dist/common/action-intent.d.ts.map

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

package/dist/common/focus-context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared focus context type for navigation results.
+ *
+ * This type is used across multiple packages to define focus contexts
+ * for the web/app surface. It's centralized here to avoid duplication.
+ * @packageDocumentation
+ */
+/**
+ * Focus context types for navigation results.
+ *
+ * Represents the different focus areas available in the web/app interface.
+ * Used by slash commands, navigation results, and the focus store.
+ *
+ * The focus store implementation is in `@makaio/ui-hooks`.
+ */
+export type FocusContext = 'chat' | 'git' | 'review' | 'planning' | 'settings';
+//# sourceMappingURL=focus-context.d.ts.map

package/dist/common/focus-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-context.d.ts","sourceRoot":"","sources":["../../src/common/focus-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/dist/common/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared common types used across multiple packages.
+ *
+ * This package contains types that are shared between different parts
+ * of the Makaio system to avoid duplication and ensure consistency.
+ * @packageDocumentation
+ */
+export type { ActionIntent } from './action-intent.js';
+export type { FocusContext } from './focus-context.js';
+export { isSurfaceVisible } from './surface.js';
+export type { SurfaceType, SurfaceVisibility } from './surface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/common/index.mjs

@@ -0,0 +1 @@
+function e(e,t){return!e||e===`all`?!0:e.includes(t)}export{e as isSurfaceVisible};

package/dist/common/surface.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Surface type definitions shared across all packages.
+ *
+ * These are the canonical surface types used throughout the system.
+ * Both the contracts-level page metadata and the framework-level
+ * page definitions reference these types.
+ * @packageDocumentation
+ */
+/**
+ * Rendering surface identifiers.
+ *
+ * Each surface represents a distinct runtime environment:
+ * - 'web': Browser-based React DOM rendering
+ * - 'mobile': React Native rendering (iOS/Android)
+ * - 'electron': Desktop Electron rendering (superset of web)
+ * - 'electrobun': Desktop Electrobun rendering (Bun-native alternative to Electron)
+ * - 'tray': Lightweight tray popover canvas (subset of desktop)
+ *
+ * SEAM: New surfaces can be added here as the platform expands.
+ */
+export type SurfaceType = 'web' | 'mobile' | 'electron' | 'electrobun' | 'tray';
+/**
+ * Page surface visibility configuration.
+ *
+ * Controls which rendering surfaces a page appears on:
+ * - `'all'`: Available on every surface (default when omitted)
+ * - `SurfaceType[]`: Restricted to listed surfaces only
+ * @example
+ * ```typescript
+ * // Available everywhere
+ * surfaces: 'all'
+ *
+ * // Web and electron only
+ * surfaces: ['web', 'electron']
+ *
+ * // Mobile only
+ * surfaces: ['mobile']
+ * ```
+ */
+export type SurfaceVisibility = 'all' | SurfaceType[];
+/**
+ * Check if a page is visible on a given surface.
+ * @param visibility - Page surface visibility configuration
+ * @param surface - Surface to check against
+ * @returns True if the page should be visible on the surface
+ */
+export declare function isSurfaceVisible(visibility: SurfaceVisibility | undefined, surface: SurfaceType): boolean;
+//# sourceMappingURL=surface.d.ts.map

package/dist/common/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/common/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,WAAW,EAAE,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAKzG"}

package/dist/config/adapter-file.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Canonical schema version string for adapter config files.
+ */
+export declare const ADAPTER_FILE_SCHEMA_VERSION: "makaio/adapter-config/v1";
+/**
+ * Schema for `.makaio/adapters/<adapterName>.json`.
+ *
+ * The file stem is the canonical `adapterName`; the payload stores only the
+ * adapter's own settings and bindings.
+ *
+ * Metadata such as `description`, `helpLinks`, `instructions`, `clientId`,
+ * `protocol`, and `providerDefinitionIds` intentionally remain here because
+ * the plan freezes them into the public `EffectiveAdapter` view. Keeping them
+ * on the canonical adapter file lets framework-only and host consumers read
+ * the same adapter catalog without a second boot-owned projection layer.
+ */
+export declare const AdapterFileSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"makaio/adapter-config/v1">;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strict>>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    clientId: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodString>;
+    providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    settings: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        providerConfigId: z.ZodString;
+        isDefault: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Inferred type for a file-canonical adapter record.
+ */
+export type AdapterFile = z.infer<typeof AdapterFileSchema>;
+//# sourceMappingURL=adapter-file.d.ts.map

package/dist/config/adapter-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-file.d.ts","sourceRoot":"","sources":["../../src/config/adapter-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,2BAA2B,4BAAsC,CAAC;AAgD/E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;kBAcnB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/config/adapters-file.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+/**
+ * Configuration for a single provider entry inside `adapters.json`.
+ */
+export declare const AdaptersFileProviderSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    modelFilterMode: z.ZodOptional<z.ZodEnum<{
+        allowlist: "allowlist";
+        "show-all": "show-all";
+    }>>;
+    modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        disabled: "disabled";
+        enabled: "enabled";
+        visible: "visible";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * Configuration for one adapter entry inside `adapters.json`.
+ */
+export declare const AdaptersFileAdapterSchema: z.ZodObject<{
+    providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        providerId: z.ZodOptional<z.ZodString>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        isDefault: z.ZodOptional<z.ZodBoolean>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modelFilterMode: z.ZodOptional<z.ZodEnum<{
+            allowlist: "allowlist";
+            "show-all": "show-all";
+        }>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            disabled: "disabled";
+            enabled: "enabled";
+            visible: "visible";
+        }>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * File-based adapter configuration stored at `~/.makaio/adapters.json`.
+ */
+export declare const AdaptersFileSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"makaio/adapters-config/v1">;
+    adapters: z.ZodRecord<z.ZodString, z.ZodObject<{
+        providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            providerId: z.ZodOptional<z.ZodString>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            isDefault: z.ZodOptional<z.ZodBoolean>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            modelFilterMode: z.ZodOptional<z.ZodEnum<{
+                allowlist: "allowlist";
+                "show-all": "show-all";
+            }>>;
+            modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                disabled: "disabled";
+                enabled: "enabled";
+                visible: "visible";
+            }>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AdaptersFile = z.infer<typeof AdaptersFileSchema>;
+export type AdaptersFileAdapter = z.infer<typeof AdaptersFileAdapterSchema>;
+export type AdaptersFileProvider = z.infer<typeof AdaptersFileProviderSchema>;
+//# sourceMappingURL=adapters-file.d.ts.map

package/dist/config/adapters-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters-file.d.ts","sourceRoot":"","sources":["../../src/config/adapters-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;iBASrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;iBAEpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}