@makaio/contracts 1.0.0-dev-1779051654000

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Makaio GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# @makaio/contracts
+
+Shared type contracts, Zod schemas, and bus subject namespaces for the Makaio
+framework. Every service domain — sessions, agents, tools, providers, and more —
+is defined here so consumers get a single, authoritative import path.
+
+## Installation
+
+This is a private workspace package. Add it to a consuming workspace package with the workspace
+protocol:
+
+```json
+{
+  "dependencies": {
+    "@makaio/contracts": "workspace:*"
+  }
+}
+```
+
+## Usage
+
+Import domain schemas and bus subjects by domain. Most consumers use the root
+barrel, but granular sub-paths are available for selective imports.
+
+```typescript
+import {
+  MakaioSessionSchema,
+  SessionSubjects,
+  AdapterSubjects,
+  type IMakaioSession,
+} from '@makaio/contracts';
+import { MakaioBus } from '@makaio/bus-core';
+
+// Listen for session lifecycle events
+MakaioBus.on(SessionSubjects.created, ({ payload }) => {
+  const session: IMakaioSession = MakaioSessionSchema.parse(payload);
+  console.log('Session created:', session.id);
+});
+
+// Parse incoming data against the canonical schema
+const session = MakaioSessionSchema.parse(rawData);
+```
+
+Sub-path exports are also available for contract domains:
+
+```typescript
+import { SessionSubjects } from '@makaio/contracts/session';
+import { ConfigSubjects } from '@makaio/contracts/config';
+```
+
+Boot progress subjects are runtime-owned:
+
+```typescript
+import { BootSubjects, BootNamespace } from '@makaio/kernel';
+```
+
+## API overview
+
+| Export | Description |
+|--------|-------------|
+| `SessionSubjects` / `SessionNamespace` | Bus subjects for session lifecycle RPCs and events |
+| `MakaioSessionSchema` | Zod schema for the canonical session object |
+| `AdapterSubjects` / `AdapterNamespace` | Bus subjects for adapter lifecycle (startAgent, initialized, …) |
+| `AgentSubjects` / `AgentNamespace` | Bus subjects for agent events plus RPCs such as `sendMessage`, `toolApprove`, `getCapabilities`, `cwd.change`, `credential.change`, `model.change`, and `validateModelChange` |
+| `ToolSubjects` | Bus subjects for tool approval and execution lifecycle |
+| `ConfigSubjects` / `ConfigSchema` | Bus subjects and schema for runtime config access |
+| `type IMakaioSession` | Core session interface |
+| `type SessionContext` | Contextual data attached to a running session |
+| `type Turn` / `TurnSchema` | Message-level turn model with usage metrics |
+| `SessionMessageSchema` | Normalized stored-message model |
+| `type AgentRole` / `AgentRoleSchema` | Agent role enumeration (`lead`, `member`) |
+| `MessageBlockSchema` | `text`, `image`, `document`, `attachment`, `reasoning`, `tool_call`, and `tool_output` block schemas |
+| `SubagentSubjects` | Bus subjects for subagent spawning and communication |

package/dist/account-identity-ZrtBl3Bq.mjs

@@ -0,0 +1 @@
+import{m as e}from"./shared-CE23KND3.mjs";import{g as t,h as n}from"./profile-Bcegl5D9.mjs";import{n as r}from"./version-u2rO7guD.mjs";import{z as i}from"zod";const a=i.enum([`strong`,`alias`]),o=i.object({scheme:t,value:t,strength:a}),s=i.object({key:t,label:i.string(),usedPercentage:i.number().finite().min(0).max(100),resetsAt:n.optional()}),c=i.object({windows:i.array(s)}),l=i.record(i.string(),i.unknown()).optional(),u=i.object({clientId:t,found:i.boolean(),version:i.string().optional(),warningMessage:i.string().optional()}),d=i.object({clientId:t,binaryName:t,supportedVersions:r.optional()}),f=i.object({clientAccountId:t,clientId:t,observedAt:n,source:t,displayLabel:i.string().optional(),usage:c,metadata:l}),p=i.discriminatedUnion(`kind`,[i.object({kind:i.literal(`session`),sessionId:t}),i.object({kind:i.literal(`adapter-session`),adapterSessionId:t}),i.object({kind:i.literal(`both`),sessionId:t,adapterSessionId:t})]),m=i.object({clientId:i.string(),source:i.string(),kind:i.string(),observedAt:n,payload:e}),h={request:i.object({clientId:t,observedAt:n.optional(),displayLabel:i.string().optional(),identifiers:i.array(o).min(1),metadata:l}),response:i.object({clientAccountId:t,displayLabel:i.string().optional()})},g={request:m.extend({locator:p}),response:i.object({handled:i.boolean(),sessionId:t.nullable(),clientAccountId:t.nullable(),changed:i.boolean()})},_={request:i.object({clientId:t,observedAt:n,source:t,account:i.object({displayLabel:i.string().optional(),identifiers:i.array(o).min(1)}),usage:c,metadata:l}),response:i.object({clientAccountId:t,snapshot:f})};export{l as a,g as c,f as d,s as f,m as i,p as l,h as n,u as o,c as p,a as r,d as s,o as t,_ as u};

package/dist/adapter/index.d.ts

@@ -0,0 +1,13 @@
+export { AdapterSubjects, AdapterNamespace } from './namespace.js';
+export { AdapterSessionStatusSchema, type AdapterSessionStatus } from './schemas/adapter-session-status.js';
+export { SESSION_LINEAGE_KINDS, ROOT_SESSION_LINEAGE_KIND, FORK_SESSION_LINEAGE_KIND, SUBAGENT_SESSION_LINEAGE_KIND, COMPRESS_SESSION_LINEAGE_KIND, RootSessionLineageSchema, ForkSessionLineageSchema, SubagentSessionLineageSchema, CompressSessionLineageSchema, SessionLineageSchema, SessionLineageKindSchema, type SessionLineage, type SessionLineageKind, } from './schemas/session-lineage.js';
+export { AdapterSchemas } from './schemas.js';
+export { AdapterRuntimeOptionsSchema, type AdapterRuntimeOptions } from './schemas/runtime-options.js';
+export { StartAgentSchema, type StartAgentRequest, type StartAgentResponse } from './schemas/start-agent.js';
+export { RehydrateAgentSchema, type RehydrateAgentRequest, type RehydrateAgentResponse, } from './schemas/rehydrate-agent.js';
+export { SessionUsageSchema, type SessionUsage } from './schemas/session-usage.js';
+export { SessionLinkedSchema, type SessionLinked } from './schemas/session-linked.js';
+export { SessionDiscoveredSchema, type SessionDiscovered } from './schemas/session-discovered.js';
+export { AgentSelectionBaseSchema, AdapterSelectionSchema, AgentSelectionSchema, type AgentSelectionBase, type AdapterSelection, type AgentSelection, type AgentSelectionKindMap, } from './schemas/agent-resolution.js';
+export { ProviderContextSchema, type ProviderContext } from './schemas/provider-context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC5G,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/adapter/index.mjs

@@ -0,0 +1 @@
+import{ct as e,f as t,g as n,i as r,lt as i,n as a,r as o,st as s,ut as c,x as l,xt as u}from"../schemas-BkyMBNp4.mjs";import{COMPRESS_SESSION_LINEAGE_KIND as d,CompressSessionLineageSchema as f,FORK_SESSION_LINEAGE_KIND as p,ForkSessionLineageSchema as m,ROOT_SESSION_LINEAGE_KIND as h,RootSessionLineageSchema as g,SESSION_LINEAGE_KINDS as _,SUBAGENT_SESSION_LINEAGE_KIND as v,SessionLineageKindSchema as y,SessionLineageSchema as b,SubagentSessionLineageSchema as x}from"./schemas/session-lineage.mjs";import{n as S,r as C,t as w}from"../adapter-CbtjTUAe.mjs";export{w as AdapterNamespace,u as AdapterRuntimeOptionsSchema,C as AdapterSchemas,e as AdapterSelectionSchema,a as AdapterSessionStatusSchema,S as AdapterSubjects,i as AgentSelectionBaseSchema,c as AgentSelectionSchema,d as COMPRESS_SESSION_LINEAGE_KIND,f as CompressSessionLineageSchema,p as FORK_SESSION_LINEAGE_KIND,m as ForkSessionLineageSchema,s as ProviderContextSchema,h as ROOT_SESSION_LINEAGE_KIND,n as RehydrateAgentSchema,g as RootSessionLineageSchema,_ as SESSION_LINEAGE_KINDS,v as SUBAGENT_SESSION_LINEAGE_KIND,r as SessionDiscoveredSchema,y as SessionLineageKindSchema,b as SessionLineageSchema,o as SessionLinkedSchema,t as SessionUsageSchema,l as StartAgentSchema,x as SubagentSessionLineageSchema};