@makaio/contracts 1.0.0-dev-1779051654000

package/dist/client/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/client/namespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA8C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAA2B,CAAC"}

package/dist/client/primitives.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared schema primitives for the client contracts package.
+ *
+ * These building blocks are internal implementation details — they are NOT
+ * part of the public package API. Consumers outside this package must derive
+ * their constraints from the exported domain schemas, not from these
+ * primitives directly.
+ */
+import { z } from 'zod';
+/** Non-empty normalized string used for stable client identifiers. */
+export declare const NonEmptyStringSchema: z.ZodString;
+/** Epoch timestamp in milliseconds. */
+export declare const EpochMillisecondsSchema: z.ZodNumber;
+/**
+ * Return `true` for POSIX, Windows drive-letter, or UNC absolute paths
+ * regardless of the host OS running schema validation.
+ * @param value - Candidate path from a portable framework contract.
+ * @returns `true` when the value is absolute on a supported host path syntax.
+ */
+export declare function isPortableAbsolutePath(value: string): boolean;
+/** Non-empty absolute filesystem path. */
+export declare const AbsolutePathSchema: z.ZodString;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/client/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/client/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,aAA2B,CAAC;AAE7D,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,aAKe,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,aAIwC,CAAC"}

package/dist/client/profile.d.ts

@@ -0,0 +1,377 @@
+/**
+ * Profile and session-config schemas for the client domain.
+ *
+ * Covers the `ClientProfile` entity, the `profile.*` command–response pairs
+ * for CRUD and default-selection, the `sessionConfig.*` lifecycle subjects
+ * for per-session configuration isolation, the setup-delegation request
+ * schema passed to client-owned setup handlers, and the `config.prime`
+ * generic lifecycle hook fired at managed-install, profile-create, and
+ * session-create phases.
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Filesystem-safe profile name.
+ *
+ * Profile names are used as directory names under the client profile root, so
+ * they must be a single path component. The character set intentionally stays
+ * conservative until a concrete UX need requires broader display names.
+ */
+export declare const ClientProfileNameSchema: z.ZodString;
+/**
+ * Filesystem-safe session config directory name.
+ *
+ * Session IDs flow into ephemeral config directory paths. They are restricted
+ * to the same single-component form as profile names to prevent path escape.
+ */
+export declare const SessionConfigIdSchema: z.ZodString;
+/**
+ * A named, persistent configuration profile for a client.
+ *
+ * Profiles allow multiple configuration environments (e.g., work vs. personal)
+ * to coexist under the same `clientId`. One profile per client is marked as
+ * the default and is selected when no explicit profile name is provided. When
+ * no default exists, session setup falls back to the client's immutable native
+ * config source and copies/materializes it into the session directory.
+ */
+export declare const ClientProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    clientId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    configDir: z.ZodString;
+    isDefault: z.ZodBoolean;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type ClientProfile = z.infer<typeof ClientProfileSchema>;
+/**
+ * Environment variables map for a session's isolated config environment.
+ */
+export declare const SessionConfigEnvSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/**
+ * Policy for materializing a session config directory from a base client config.
+ */
+export declare const SessionConfigInheritanceSchema: z.ZodEnum<{
+    "auth-only": "auth-only";
+    empty: "empty";
+    full: "full";
+}>;
+export type SessionConfigInheritance = z.infer<typeof SessionConfigInheritanceSchema>;
+/**
+ * Request and response schemas for `client.profile.*` operations.
+ *
+ * Provides typed bus subjects for creating, listing, retrieving, updating,
+ * deleting, and setting the default profile for a given client.
+ */
+export declare const ClientProfileSchemas: {
+    /**
+     * Create a new profile for a client.
+     */
+    'profile.create': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            profile: z.ZodObject<{
+                id: z.ZodString;
+                clientId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+                configDir: z.ZodString;
+                isDefault: z.ZodBoolean;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    /**
+     * List all profiles for a client.
+     */
+    'profile.list': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            profiles: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                clientId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+                configDir: z.ZodString;
+                isDefault: z.ZodBoolean;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Get a profile by client ID and name.
+     *
+     * Returns `null` in the response when no matching profile exists rather
+     * than throwing, so callers can handle the absent-profile case inline.
+     */
+    'profile.get': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            profile: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                clientId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+                configDir: z.ZodString;
+                isDefault: z.ZodBoolean;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Update an existing profile's mutable fields.
+     */
+    'profile.update': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            profile: z.ZodObject<{
+                id: z.ZodString;
+                clientId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+                configDir: z.ZodString;
+                isDefault: z.ZodBoolean;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Delete a profile by client ID and name.
+     */
+    'profile.delete': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            success: z.ZodBoolean;
+        }, z.core.$strip>;
+    };
+    /**
+     * Mark a profile as the default for its client.
+     */
+    'profile.setDefault': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            profile: z.ZodObject<{
+                id: z.ZodString;
+                clientId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+                configDir: z.ZodString;
+                isDefault: z.ZodBoolean;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+};
+/**
+ * Request and response schemas for `client.sessionConfig.*` operations.
+ *
+ * Manages per-session configuration isolation: creating a temporary working
+ * directory seeded from a named profile, tearing it down after a session ends,
+ * and bulk-cleaning stale session directories.
+ */
+export declare const ClientSessionConfigSchemas: {
+    /**
+     * Create an isolated configuration directory for a session.
+     *
+     * The service seeds the directory from the named profile (or the client
+     * default when `profileName` is omitted) and returns the path together
+     * with any environment variables the client process should inherit.
+     */
+    'sessionConfig.create': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            sessionId: z.ZodString;
+            profileName: z.ZodOptional<z.ZodString>;
+            baseConfigDir: z.ZodOptional<z.ZodString>;
+            projectDir: z.ZodOptional<z.ZodString>;
+            configInheritance: z.ZodOptional<z.ZodEnum<{
+                "auth-only": "auth-only";
+                empty: "empty";
+                full: "full";
+            }>>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            sessionDir: z.ZodString;
+            env: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Destroy the isolated configuration directory for a session.
+     */
+    'sessionConfig.destroy': {
+        request: z.ZodObject<{
+            clientId: z.ZodString;
+            sessionId: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            success: z.ZodBoolean;
+        }, z.core.$strip>;
+    };
+    /**
+     * Clean up stale session config directories.
+     *
+     * When `clientId` is supplied only that client's orphaned directories are
+     * removed; omit it to clean across all clients.
+     */
+    'sessionConfig.cleanup': {
+        request: z.ZodObject<{
+            clientId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            removed: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+    };
+};
+/**
+ * Schema for the setup-delegation request passed to client-owned session
+ * config setup handlers.
+ *
+ * Each client's setup handler receives this payload and is responsible for
+ * populating `sessionDir` with the correct config files for the given
+ * `baseConfigDir` on the target platform.
+ */
+export declare const SessionConfigSetupRequestSchema: z.ZodObject<{
+    sessionDir: z.ZodString;
+    baseConfigDir: z.ZodString;
+    projectDir: z.ZodOptional<z.ZodString>;
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        linux: "linux";
+        win32: "win32";
+    }>;
+    configInheritance: z.ZodEnum<{
+        "auth-only": "auth-only";
+        empty: "empty";
+        full: "full";
+    }>;
+}, z.core.$strip>;
+export type SessionConfigSetupRequest = z.infer<typeof SessionConfigSetupRequestSchema>;
+/**
+ * Schema for the teardown-delegation request passed to client-owned session
+ * config destroy handlers.
+ *
+ * Each client's destroy handler receives the concrete session directory before
+ * `clients-core` removes it and is responsible for cleaning any native
+ * credential material associated with that directory.
+ */
+export declare const SessionConfigTeardownRequestSchema: z.ZodObject<{
+    sessionDir: z.ZodString;
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        linux: "linux";
+        win32: "win32";
+    }>;
+}, z.core.$strip>;
+export type SessionConfigTeardownRequest = z.infer<typeof SessionConfigTeardownRequestSchema>;
+/** Response schema for the teardown-delegation request. */
+export declare const SessionConfigTeardownResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export type SessionConfigTeardownResponse = z.infer<typeof SessionConfigTeardownResponseSchema>;
+/**
+ * Response schema for the setup-delegation request.
+ *
+ * The setup handler may return environment variables that the client process
+ * should inherit for the isolated session directory.  When absent, no extra
+ * environment variables are added beyond those already in the spawn environment.
+ */
+export declare const SessionConfigSetupResponseSchema: z.ZodObject<{
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SessionConfigSetupResponse = z.infer<typeof SessionConfigSetupResponseSchema>;
+/**
+ * Lifecycle phases at which the config-prime hook fires.
+ *
+ * - `'managed-install'` — after a managed binary is verified and before the
+ *   version record is persisted and the binary is activated.
+ * - `'profile-create'`  — after a named profile directory is created and
+ *   before the profile record is written to storage.
+ * - `'session-create'`  — after a session config directory is created and the
+ *   client-owned setup handler has run, before the session config response is
+ *   returned.
+ */
+export declare const ClientConfigPrimePhaseSchema: z.ZodEnum<{
+    "managed-install": "managed-install";
+    "profile-create": "profile-create";
+    "session-create": "session-create";
+}>;
+export type ClientConfigPrimePhase = z.infer<typeof ClientConfigPrimePhaseSchema>;
+/**
+ * Request and response schemas for `client.config.prime`.
+ *
+ * The generic `client.config.prime` handler delegates to the per-client
+ * `client:<clientId>.config.prime` subject via `requestOptional`.  If no
+ * client-specific handler is registered the call is a no-op.
+ *
+ * This allows client packages to perform one-time or per-session config
+ * initialisation (e.g. writing settings templates, injecting MCP server
+ * entries) at well-defined lifecycle points without the framework needing to
+ * know the client's config file format.
+ */
+export declare const ClientConfigPrimeSchema: {
+    /**
+     * Initiate a config prime for the given client directory and phase.
+     */
+    request: z.ZodObject<{
+        clientId: z.ZodString;
+        configDir: z.ZodString;
+        phase: z.ZodEnum<{
+            "managed-install": "managed-install";
+            "profile-create": "profile-create";
+            "session-create": "session-create";
+        }>;
+        binaryVersion: z.ZodOptional<z.ZodString>;
+        adapterName: z.ZodOptional<z.ZodString>;
+        projectDir: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    /** Outcome of the config-prime operation. */
+    response: z.ZodObject<{
+        primed: z.ZodBoolean;
+    }, z.core.$strip>;
+};
+export type ClientConfigPrimeRequest = z.infer<typeof ClientConfigPrimeSchema.request>;
+export type ClientConfigPrimeResponse = z.infer<typeof ClientConfigPrimeSchema.response>;
+export type ProfileCreateRequest = z.infer<(typeof ClientProfileSchemas)['profile.create']['request']>;
+export type ProfileCreateResponse = z.infer<(typeof ClientProfileSchemas)['profile.create']['response']>;
+export type ProfileListRequest = z.infer<(typeof ClientProfileSchemas)['profile.list']['request']>;
+export type ProfileListResponse = z.infer<(typeof ClientProfileSchemas)['profile.list']['response']>;
+export type ProfileGetRequest = z.infer<(typeof ClientProfileSchemas)['profile.get']['request']>;
+export type ProfileGetResponse = z.infer<(typeof ClientProfileSchemas)['profile.get']['response']>;
+export type ProfileUpdateRequest = z.infer<(typeof ClientProfileSchemas)['profile.update']['request']>;
+export type ProfileUpdateResponse = z.infer<(typeof ClientProfileSchemas)['profile.update']['response']>;
+export type ProfileDeleteRequest = z.infer<(typeof ClientProfileSchemas)['profile.delete']['request']>;
+export type ProfileDeleteResponse = z.infer<(typeof ClientProfileSchemas)['profile.delete']['response']>;
+export type ProfileSetDefaultRequest = z.infer<(typeof ClientProfileSchemas)['profile.setDefault']['request']>;
+export type ProfileSetDefaultResponse = z.infer<(typeof ClientProfileSchemas)['profile.setDefault']['response']>;
+export type SessionConfigCreateRequest = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.create']['request']>;
+export type SessionConfigCreateResponse = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.create']['response']>;
+export type SessionConfigDestroyRequest = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.destroy']['request']>;
+export type SessionConfigDestroyResponse = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.destroy']['response']>;
+export type SessionConfigCleanupRequest = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.cleanup']['request']>;
+export type SessionConfigCleanupResponse = z.infer<(typeof ClientSessionConfigSchemas)['sessionConfig.cleanup']['response']>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/client/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/client/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,aAGkD,CAAC;AAEvF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,aAA0B,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAiB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,sBAAsB,uCAAmC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;EAAyC,CAAC;AAErF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;;;;;;;;;;;;;;;;;;;IAgBH;;OAEG;;;;;;;;;;;;;;;;;;IAYH;;;;;OAKG;;;;;;;;;;;;;;;;;;;IAcH;;OAEG;;;;;;;;;;;;;;;;;;;;IAgBH;;OAEG;;;;;;;;;;IAcH;;OAEG;;;;;;;;;;;;;;;;;;;CAaJ,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;IACrC;;;;;;OAMG;;;;;;;;;;;;;;;;;;;IAwBH;;OAEG;;;;;;;;;;IAcH;;;;;OAKG;;;;;;;;;CAWJ,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;iBAW1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC;;;;;;;iBAK7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,2DAA2D;AAC3D,eAAO,MAAM,mCAAmC;;iBAG9C,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC;;iBAG3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAM1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;EAAkE,CAAC;AAE5G,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;IAClC;;OAEG;;;;;;;;;;;;;IA+BH,6CAA6C;;;;CAQ9C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACvF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAGzF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACvG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACzG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACnG,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACrG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACjG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACnG,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACvG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACzG,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACvG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AACzG,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/G,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,oBAAoB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAGjH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,CAAC,OAAO,0BAA0B,CAAC,CAAC,sBAAsB,CAAC,CAAC,SAAS,CAAC,CACvE,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,CAAC,OAAO,0BAA0B,CAAC,CAAC,sBAAsB,CAAC,CAAC,UAAU,CAAC,CACxE,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,CAAC,OAAO,0BAA0B,CAAC,CAAC,uBAAuB,CAAC,CAAC,SAAS,CAAC,CACxE,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,CAAC,OAAO,0BAA0B,CAAC,CAAC,uBAAuB,CAAC,CAAC,UAAU,CAAC,CACzE,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,CAAC,OAAO,0BAA0B,CAAC,CAAC,uBAAuB,CAAC,CAAC,SAAS,CAAC,CACxE,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,CAAC,OAAO,0BAA0B,CAAC,CAAC,uBAAuB,CAAC,CAAC,UAAU,CAAC,CACzE,CAAC"}

package/dist/client/runtime-observation.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Runtime observation schemas for the client domain.
+ *
+ * Covers source-layer classification, source descriptors, shared evidence
+ * fields, the `client.runtime.observe` request–response pair, and the
+ * `client.runtime.started` event payload.
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Source layer classification for a runtime observation.
+ *
+ * Identifies the component that produced the observation signal:
+ * - `'supervisor'` — the Makaio supervisor process directly detected the runtime
+ * - `'adapter'` — a client adapter emitted the signal from the adapter layer
+ * - `'client-hook'` — a native client hook (e.g. PostToolUse) produced the signal
+ * - `'statusline'` — a statusline / process-watcher scraper detected the runtime
+ * - `'cli-wrapper'` — a thin CLI shim wrapping the client binary reported the signal
+ */
+export declare const ClientRuntimeSourceLayerSchema: z.ZodEnum<{
+    adapter: "adapter";
+    "cli-wrapper": "cli-wrapper";
+    "client-hook": "client-hook";
+    statusline: "statusline";
+    supervisor: "supervisor";
+}>;
+export type ClientRuntimeSourceLayer = z.infer<typeof ClientRuntimeSourceLayerSchema>;
+/**
+ * Source descriptor identifying what produced a runtime observation.
+ *
+ * - `layer` — high-level component classification (see {@link ClientRuntimeSourceLayerSchema}).
+ * - `producer` — stable producer identifier within that layer (e.g. `'claude-code-adapter'`).
+ */
+export declare const ClientRuntimeSourceSchema: z.ZodObject<{
+    layer: z.ZodEnum<{
+        adapter: "adapter";
+        "cli-wrapper": "cli-wrapper";
+        "client-hook": "client-hook";
+        statusline: "statusline";
+        supervisor: "supervisor";
+    }>;
+    producer: z.ZodString;
+}, z.core.$strip>;
+export type ClientRuntimeSource = z.infer<typeof ClientRuntimeSourceSchema>;
+/**
+ * Shared runtime evidence fields that appear in both the `client.runtime.observe`
+ * request and the `client.runtime.started` event.
+ *
+ * At least one of `supervisorSessionId`, `pid`, or `adapterSessionId` must be
+ * present ("hard evidence" invariant). This constraint is enforced via `.refine()`
+ * on the terminal request schema, not on this base, so the base stays composable.
+ *
+ * Fields:
+ * - `supervisorSessionId` — supervisor-assigned session ID, when available.
+ * - `pid` — OS process ID of the client binary.
+ * - `parentPid` — OS process ID of the parent process.
+ * - `adapterSessionId` — raw session ID from the client runtime.
+ * - `sessionId` — framework session ID, if already resolved.
+ * - `cwd` — working directory of the client process.
+ * - `argv` — argv of the client process.
+ * - `metadata` — arbitrary pass-through data from the producer.
+ */
+export declare const ClientRuntimeEvidenceBaseSchema: z.ZodObject<{
+    supervisorSessionId: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    parentPid: z.ZodOptional<z.ZodNumber>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    argv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ClientRuntimeEvidenceBase = z.infer<typeof ClientRuntimeEvidenceBaseSchema>;
+/**
+ * Request and response schemas for `client.runtime.observe`.
+ *
+ * Callers send this request when they detect that a client runtime has started.
+ * The handler upserts a `ClientRuntime` record and returns a stable
+ * `clientRuntimeId` together with flags indicating whether the record was
+ * created or promoted to a richer state.
+ *
+ * Hard-evidence invariant: at least one of `supervisorSessionId`, `pid`, or
+ * `adapterSessionId` must be present. Enforced via `.refine()` on the request
+ * schema (not on the shared evidence base, which stays composable).
+ */
+export declare const ClientRuntimeObserveSchema: {
+    request: z.ZodObject<{
+        supervisorSessionId: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+        parentPid: z.ZodOptional<z.ZodNumber>;
+        adapterSessionId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        cwd: z.ZodOptional<z.ZodString>;
+        argv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        clientId: z.ZodString;
+        source: z.ZodObject<{
+            layer: z.ZodEnum<{
+                adapter: "adapter";
+                "cli-wrapper": "cli-wrapper";
+                "client-hook": "client-hook";
+                statusline: "statusline";
+                supervisor: "supervisor";
+            }>;
+            producer: z.ZodString;
+        }, z.core.$strip>;
+        observedAt: z.ZodNumber;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+        clientRuntimeId: z.ZodString;
+        created: z.ZodBoolean;
+        promoted: z.ZodBoolean;
+    }, z.core.$strip>;
+};
+export type ClientRuntimeObserveRequest = z.infer<typeof ClientRuntimeObserveSchema.request>;
+export type ClientRuntimeObserveResponse = z.infer<typeof ClientRuntimeObserveSchema.response>;
+/**
+ * Payload for `client.runtime.started`.
+ *
+ * Emitted by the runtime-observe service after a `client.runtime.observe` request
+ * has been handled and a runtime record has been created or confirmed. Listeners
+ * can react to this event without coupling to the observe handler.
+ *
+ * Hard-evidence invariant: at least one of `supervisorSessionId`, `pid`, or
+ * `adapterSessionId` is present (guaranteed by the observe handler before emit).
+ */
+export declare const ClientRuntimeStartedSchema: z.ZodObject<{
+    supervisorSessionId: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    parentPid: z.ZodOptional<z.ZodNumber>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    argv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    clientRuntimeId: z.ZodString;
+    clientId: z.ZodString;
+    status: z.ZodEnum<{
+        observed: "observed";
+        started: "started";
+    }>;
+    source: z.ZodObject<{
+        layer: z.ZodEnum<{
+            adapter: "adapter";
+            "cli-wrapper": "cli-wrapper";
+            "client-hook": "client-hook";
+            statusline: "statusline";
+            supervisor: "supervisor";
+        }>;
+        producer: z.ZodString;
+    }, z.core.$strip>;
+    observedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type ClientRuntimeStarted = z.infer<typeof ClientRuntimeStartedSchema>;
+//# sourceMappingURL=runtime-observation.d.ts.map

package/dist/client/runtime-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-observation.d.ts","sourceRoot":"","sources":["../../src/client/runtime-observation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B;;;;;;EAMzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAiB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBtC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAC7F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC;AAE/F;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAerC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}