@xemahq/biome-sdk 0.1.1

package/src/index.ts

@@ -0,0 +1,58 @@
+/**
+ * @xemahq/biome-sdk — single meta-import for Xema biome development.
+ *
+ * Re-exports the full public surface of every kernel contract package
+ * a biome author needs. Instead of importing from five separate packages,
+ * a biome can import everything from here:
+ *
+ * ```ts
+ * import {
+ *   BiomeManifestSchema,
+ *   CapabilityRefSchema,
+ *   ContributionKind,
+ *   XemaObjectKind,
+ *   ExecutionEnvironment,
+ * } from '@xemahq/biome-sdk';
+ * ```
+ *
+ * Note: `SubjectRef` / `SubjectRefSchema` are exported from both
+ * `@xemahq/kernel-contracts/capability` (typed enum `SubjectKind`) and
+ * `@xemahq/kernel-contracts/object` (loose string `kind`). The capability-
+ * contracts version is the canonical typed version and is what this meta-
+ * package exposes under the shared name. The xema-object-contracts version
+ * is intentionally kept loose (zero deps) for the XSI plane-1 envelope
+ * shape; it is exported as `XsiSubjectRef` / `XsiSubjectRefSchema` to
+ * avoid the ambiguity.
+ */
+export * from '@xemahq/kernel-contracts/contribution';
+export * from '@xemahq/kernel-contracts/capability';
+// Re-export xema-object-contracts wholesale except the two names that
+// clash with @xemahq/capability-contracts. The canonical typed versions
+// from capability-contracts take precedence; the XSI plane-1 loose
+// versions are re-exported under aliased names.
+export {
+  XemaObjectKind,
+  ObjectLifecycle,
+  ObjectLifecycleSchema,
+  XemaObjectRefSchema,
+  xemaObjectSchema,
+  XemaObjectRefParseError,
+  parseXemaObjectRef,
+  formatXemaObjectRef,
+  SubjectRefSchema as XsiSubjectRefSchema,
+} from '@xemahq/kernel-contracts/object';
+export type {
+  XemaObjectRef,
+  XemaObjectRefParts,
+  XemaObject,
+  SubjectRef as XsiSubjectRef,
+} from '@xemahq/kernel-contracts/object';
+export {
+  SpaceKind,
+  SpaceKindSchema,
+  SpaceRefSchema,
+  spaceRefToPath,
+} from '@xemahq/kernel-contracts/space';
+export type { SpaceRef } from '@xemahq/kernel-contracts/space';
+export * from '@xemahq/kernel-contracts/biome';
+export * from '@xemahq/kernel-contracts/execution-environment';

package/src/orchestrator-adapter/index.ts

@@ -0,0 +1,2 @@
+export * from './lib/orchestrator-adapter';
+export * from './lib/orchestrator-adapter-registry';

package/src/orchestrator-adapter/lib/orchestrator-adapter-registry.ts

@@ -0,0 +1,8 @@
+import { Registry } from '@xemahq/registry';
+import type { OrchestratorAdapterRegistration } from './orchestrator-adapter';
+
+export class OrchestratorAdapterRegistry extends Registry<string, OrchestratorAdapterRegistration> {
+  constructor(seed?: readonly OrchestratorAdapterRegistration[]) {
+    super(seed ? { name: 'OrchestratorAdapterRegistry', seed } : { name: 'OrchestratorAdapterRegistry' });
+  }
+}

package/src/orchestrator-adapter/lib/orchestrator-adapter.ts

@@ -0,0 +1,20 @@
+/**
+ * The contract every agent-orchestrator (OpenCode, Claude Code, …) implements
+ * so the rest of Xema can drive any of them through the same surface.
+ *
+ * Concrete implementations live in dedicated packages
+ * (e.g. `@xemahq/agent-workspace-opencode`) and register themselves
+ * into `OrchestratorAdapterRegistry` at platform boot.
+ */
+export interface OrchestratorAdapter<TInvocationContext = unknown, TInvocationResult = unknown> {
+  readonly id: string;
+  readonly displayName: string;
+
+  invoke(ctx: TInvocationContext): Promise<TInvocationResult>;
+}
+
+export interface OrchestratorAdapterRegistration {
+  readonly key: string;
+  readonly displayName: string;
+  readonly create: () => OrchestratorAdapter;
+}