@makaio/client-codex 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,103 @@
+# @makaio/client-codex
+
+Static client definition and schema library for the OpenAI Codex CLI. This package declares the user-facing identity of the `codex` binary within the framework — its stable ID, native tool catalog with capability tags drawn from the shared `codexCapabilityMap`, hook event map, and Zod schemas covering Codex's hook configuration and wiring RPCs. A separate `./runtime` entrypoint registers the client-native bus namespace and provides the `CodexClientSessionService` that bridges raw hook events into normalized `client.session.*` observations.
+
+## Client Identity
+
+| Field | Value |
+|-------|-------|
+| `id` | `codex` |
+| `name` | `Codex` |
+| `version` | `0.1.0` |
+| `description` | OpenAI Codex CLI — an agentic coding assistant |
+| `binary.name` | `codex` |
+| `binary.supportedVersions` | `*` |
+| `defaultApprovalPolicy` | `full-access` |
+| `defaultProviderId` | `openai-codex` |
+| `configIsolation.envVar` | `CODEX_HOME` |
+| `configIsolation.defaultPath` | `~/.codex` |
+
+### Runtime Capabilities
+
+| Capability | Value |
+|-----------|-------|
+| `supportsHooks` | `true` |
+| `supportsStatusline` | `false` |
+| `supportsSupervisorLaunch` | `true` |
+| `supportsManagedBinary` | `false` |
+
+### Hook Events
+
+| Hook Name | Framework Subject |
+|-----------|------------------|
+| `SessionStart` | `client.session.started` |
+| `UserPromptSubmit` | `client.session.userPrompt.submitted` |
+| `PreToolUse` | `client.session.tool.pre` |
+| `PostToolUse` | `client.session.tool.post` |
+| `Stop` | `client.session.turn.completed` |
+
+## Native Tools
+
+Capabilities are sourced from `codexCapabilityMap` in `@makaio/contracts`, keeping the capability taxonomy in one canonical location.
+
+| Tool | Friendly Name | Category | Capabilities |
+|------|---------------|----------|-------------|
+| `bash` | Terminal | System | `shell.execute`, `file.read`, `file.write`, `file.delete`, `network.request`, `process.manage` |
+| `patch` | Patch File | Files | `file.write` |
+
+## Served By (Adapters)
+
+| Adapter ID | Package |
+|-----------|---------|
+| `codex-app-server` | `@makaio/ai-adapters-codex-app-server` — direct integration with the Codex app-server via stdio subprocess |
+
+## Exports
+
+### Main entrypoint (`.`)
+
+| Export | Kind | Description |
+|--------|------|-------------|
+| `clientDefinition` | `ClientDefinition` | Static client definition (identity, tools, approval policy) |
+| `codexPackage` | `MakaioExtension` | Package descriptor for framework extension discovery |
+| `CodexClientSessionService` | class | Session normalization service (re-exported from `./runtime`) |
+| `CodexClientSubjects` | namespace subjects | Typed bus subjects for `client:codex.*` (re-exported from `./runtime`) |
+
+#### Config Schemas
+
+| Export | Description |
+|--------|-------------|
+| `CodexConfigSchemas` | Bus-subject schema map for all config hook RPCs |
+| `CodexScopeSchema` | Scope enum for Codex configuration |
+| `CodexHookEntrySchema` | Single hook entry |
+| `CodexNativeCommandHookSchema` | Native command hook definition |
+| `CodexNativeHookMatcherGroupSchema` | Hook matcher group |
+| `CodexNativeHooksFileSchema` | Full native hooks file structure |
+| `CodexScopeHookRecordSchema` | Per-scope hook record |
+| `CodexConfigHooksListRequestSchema` / `…ResponseSchema` | List hooks RPC |
+| `CodexConfigHooksAddRequestSchema` / `…ResponseSchema` | Add hook RPC |
+| `CodexConfigHooksRemoveRequestSchema` / `…ResponseSchema` | Remove hook RPC |
+| `AbsolutePathSchema` | Absolute filesystem path validation |
+
+#### Wiring Schemas
+
+| Export | Description |
+|--------|-------------|
+| `CodexWiringSchemas` | Bus-subject schema map for wiring list/apply/remove RPCs |
+
+### Runtime entrypoint (`./runtime`)
+
+| Export | Kind | Description |
+|--------|------|-------------|
+| `codexClientRuntimePackage` | `MakaioExtension` | Registers `codex.runtime` namespace and creates the client session service |
+| `CodexClientSessionService` | class | Bridges raw `client:codex.hook.received` events into normalized `client.session.*` observations |
+| `CodexClientSubjects` | namespace subjects | Typed bus subjects for `client:codex.*` |
+| `CODEX_CLIENT_NAMESPACE` | `string` | Fully-qualified namespace domain (`'client:codex'`) |
+| `normalizeCodexHook` | function | Normalizes a raw Codex hook payload into a `CodexNormalizedEvent` |
+
+### Server entrypoint (`./server`)
+
+Default export is `[codexPackage, codexClientRuntimePackage]` — the array of packages registered when this client is activated as a server entry.
+
+## Installation
+
+`@makaio/client-codex` is a private workspace package used internally by the framework.

package/descriptor.json

@@ -0,0 +1,21 @@
+{
+  "name": "codex",
+  "displayName": "Codex",
+  "version": "0.1.0",
+  "makaio": {
+    "framework": ">=0.1.0"
+  },
+  "entrypoints": {
+    "server": true
+  },
+  "contributions": {
+    "clients": [
+      {
+        "id": "codex",
+        "name": "Codex",
+        "description": "OpenAI Codex CLI \u2014 an agentic coding assistant",
+        "binary": { "name": "codex", "managed": true, "version": "0.130.0" }
+      }
+    ]
+  }
+}