@honua/app-platform 0.0.20-alpha.0

package/operate/types.d.ts

@@ -0,0 +1,397 @@
+import type { HonuaCacheValidator } from "../core/cache-state.js";
+import type { QueryMethod } from "../core/types.js";
+/**
+ * Operate observability SDK contracts.
+ *
+ * Shared, protocol-neutral shapes for the Console / MCP / Studio "Operate"
+ * surfaces: server telemetry status, operational events, logs, alerts, realtime
+ * alert rules, geofence zones, delivery channel bindings, investigations, and the
+ * job viewer (runs, stages, logs, artifacts).
+ *
+ * These mirror honua-server#1168 / #1169 / #1170 and are designed so fixture data
+ * can drive Console Operate screens before live endpoints land. Capability gaps
+ * are represented as typed degraded results (see {@link HonuaOperateUnsupported})
+ * rather than thrown errors, and action availability is carried explicitly by the
+ * resource state/policy rather than inferred by the UI.
+ *
+ * @module
+ */
+export declare const HONUA_OPERATE_BASE_PATH: "/api/v1/operate";
+/**
+ * Observability sub-capabilities a deployment may or may not provide.
+ * Absent providers are surfaced as {@link HonuaOperateUnsupported} so clients can
+ * disable the matching Console panel instead of rendering empty data.
+ */
+export type HonuaOperateCapability = "telemetry" | "events" | "logs" | "metrics" | "alerts" | "alert-rules" | "geofences" | "delivery-channels" | "investigations" | "jobs" | "raw";
+export interface HonuaProblemDetails {
+    readonly type?: string;
+    readonly title?: string;
+    readonly status?: number;
+    readonly detail?: string;
+    readonly instance?: string;
+    readonly code?: string;
+    readonly errors?: Record<string, readonly string[]>;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaOperateUnsupported {
+    readonly supported: false;
+    readonly capability: HonuaOperateCapability;
+    readonly statusCode?: number;
+    readonly reason: string;
+    readonly problem?: HonuaProblemDetails;
+}
+export interface HonuaOperateSuccess<T> {
+    readonly supported: true;
+    readonly value: T;
+}
+export type HonuaOperateResult<T> = HonuaOperateSuccess<T> | HonuaOperateUnsupported;
+export interface HonuaOperateRequestOptions {
+    readonly signal?: AbortSignal;
+    readonly headers?: HeadersInit;
+}
+export interface HonuaOperateListOptions extends HonuaOperateRequestOptions {
+    readonly cursor?: string;
+    readonly limit?: number;
+    readonly targetId?: string;
+    readonly q?: string;
+    readonly since?: string;
+    readonly until?: string;
+    readonly refresh?: boolean;
+    readonly validator?: HonuaCacheValidator;
+}
+export interface HonuaOperatePage<T> {
+    readonly items: readonly T[];
+    readonly pagination: {
+        readonly nextCursor?: string;
+        readonly previousCursor?: string;
+        readonly limit?: number;
+        readonly total?: number;
+    };
+    readonly validator?: HonuaCacheValidator;
+    readonly sourceUpdatedAt?: string;
+}
+export interface HonuaOperateEntityValidators {
+    readonly etag?: string;
+    readonly lastModified?: string;
+}
+/** Hyperlinks attached to Operate resources for follow-on navigation. */
+export interface HonuaOperateLinks {
+    readonly self?: string;
+    readonly logs?: string;
+    readonly artifacts?: string;
+    readonly stages?: string;
+    readonly investigation?: string;
+    readonly alert?: string;
+    readonly rule?: string;
+    readonly [rel: string]: string | undefined;
+}
+/** A monitored unit (server, deployment, region) the Operate surfaces report on. */
+export interface HonuaObservabilityTarget extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: "server" | "deployment" | "region" | "cluster" | (string & {});
+    readonly environment?: "production" | "staging" | "development" | (string & {});
+    readonly region?: string;
+    readonly labels?: Record<string, string>;
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export type HonuaTelemetryHealth = "healthy" | "degraded" | "unhealthy" | "unknown" | (string & {});
+/** Provider availability for a target. `enabled: false` means telemetry is off, not failing. */
+export interface HonuaTelemetryProviderStatus {
+    readonly id: string;
+    readonly kind: "otlp" | "logs" | "metrics" | "alerts" | "jobs" | (string & {});
+    readonly enabled: boolean;
+    readonly connected?: boolean;
+    readonly detail?: string;
+    readonly lastSeenAt?: string;
+}
+export interface HonuaServerTelemetryStatus extends HonuaOperateEntityValidators {
+    readonly targetId: string;
+    readonly health: HonuaTelemetryHealth;
+    /** True when an OTLP/telemetry pipeline is configured and active for the target. */
+    readonly telemetryEnabled: boolean;
+    readonly version?: string;
+    readonly uptimeSeconds?: number;
+    readonly startedAt?: string;
+    readonly observedAt?: string;
+    readonly providers?: readonly HonuaTelemetryProviderStatus[];
+    readonly metrics?: readonly HonuaMetricSnapshot[];
+    readonly message?: string;
+    readonly problem?: HonuaProblemDetails;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaMetricSnapshot {
+    readonly name: string;
+    readonly value: number;
+    readonly unit?: string;
+    readonly observedAt?: string;
+    readonly labels?: Record<string, string>;
+}
+export type HonuaOperationalEventSeverity = "info" | "notice" | "warning" | "error" | "critical" | (string & {});
+/**
+ * An operational event in the event viewer. The {@link HonuaOperationalEvent.category}
+ * discriminates `audit` events from operational ones so the UI never conflates them.
+ */
+export interface HonuaOperationalEvent {
+    readonly id: string;
+    readonly targetId?: string;
+    readonly category: "operational" | "audit" | "security" | (string & {});
+    readonly type: string;
+    readonly severity: HonuaOperationalEventSeverity;
+    readonly summary: string;
+    readonly detail?: string;
+    readonly occurredAt: string;
+    readonly actor?: string;
+    readonly resource?: string;
+    readonly correlationId?: string;
+    readonly attributes?: Record<string, unknown>;
+    readonly links?: HonuaOperateLinks;
+}
+export type HonuaLogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | (string & {});
+/** A single structured log line. Distinct from {@link HonuaOperationalEvent} audit records. */
+export interface HonuaLogRecord {
+    readonly id: string;
+    readonly targetId?: string;
+    readonly level: HonuaLogLevel;
+    readonly message: string;
+    readonly timestamp: string;
+    readonly source?: string;
+    readonly traceId?: string;
+    readonly spanId?: string;
+    readonly jobId?: string;
+    readonly attributes?: Record<string, unknown>;
+}
+export type HonuaAlertSeverity = "info" | "warning" | "error" | "critical" | (string & {});
+export type HonuaAlertStatus = "firing" | "acknowledged" | "resolved" | "suppressed" | (string & {});
+/** Actions a viewer may take on an alert; presence reflects state + policy, not the UI's guess. */
+export type HonuaAlertAction = "acknowledge" | "resolve" | "suppress" | "unsuppress" | "escalate" | (string & {});
+export interface HonuaAlert extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly targetId?: string;
+    readonly ruleId?: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly severity: HonuaAlertSeverity;
+    readonly status: HonuaAlertStatus;
+    readonly firedAt: string;
+    readonly updatedAt?: string;
+    readonly resolvedAt?: string;
+    readonly acknowledgedAt?: string;
+    readonly acknowledgedBy?: string;
+    /** When `status === "suppressed"`, the reason/window the suppression was applied for. */
+    readonly suppression?: {
+        readonly reason?: string;
+        readonly until?: string;
+        readonly by?: string;
+    };
+    /** Outcome of the most recent delivery attempt across bound channels. */
+    readonly delivery?: HonuaAlertDeliveryStatus;
+    /** Actions currently permitted for this alert given its state and the caller's policy. */
+    readonly availableActions: readonly HonuaAlertAction[];
+    readonly labels?: Record<string, string>;
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaAlertDeliveryStatus {
+    readonly state: "pending" | "delivered" | "failed" | "not-configured" | (string & {});
+    readonly channelId?: string;
+    readonly attemptedAt?: string;
+    readonly error?: HonuaProblemDetails;
+}
+export interface HonuaAlertActionRequest {
+    readonly action: HonuaAlertAction;
+    readonly reason?: string;
+    /** For `suppress`: how long the suppression should last. */
+    readonly suppressUntil?: string;
+    readonly ifMatch?: string;
+}
+export type HonuaAlertRuleKind = "threshold" | "rate" | "absence" | "geofence" | (string & {});
+export interface HonuaAlertRule extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: HonuaAlertRuleKind;
+    readonly enabled: boolean;
+    readonly targetId?: string;
+    readonly description?: string;
+    readonly severity?: HonuaAlertSeverity;
+    /** True when the rule is evaluated against a live stream rather than batched. */
+    readonly realtime: boolean;
+    readonly expression?: string;
+    readonly geofenceZoneId?: string;
+    readonly windowSeconds?: number;
+    readonly threshold?: number;
+    /** Delivery channel bindings this rule fires through, with per-binding errors. */
+    readonly channelBindings?: readonly HonuaDeliveryChannelBinding[];
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaAlertRuleWriteRequest {
+    readonly name: string;
+    readonly kind: HonuaAlertRuleKind;
+    readonly enabled?: boolean;
+    readonly targetId?: string;
+    readonly description?: string;
+    readonly severity?: HonuaAlertSeverity;
+    readonly realtime?: boolean;
+    readonly expression?: string;
+    readonly geofenceZoneId?: string;
+    readonly windowSeconds?: number;
+    readonly threshold?: number;
+    readonly channelIds?: readonly string[];
+    readonly ifMatch?: string;
+}
+/** Result of a dry-run rule evaluation; no alert is persisted. */
+export interface HonuaAlertRuleTestResult {
+    readonly matched: boolean;
+    readonly evaluatedAt: string;
+    readonly observedValue?: number;
+    readonly sampleEventIds?: readonly string[];
+    readonly message?: string;
+    readonly problem?: HonuaProblemDetails;
+}
+/** A polygon/circle geofence zone an alert rule of kind `geofence` references. */
+export interface HonuaGeofenceZone extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly trigger: "enter" | "exit" | "dwell" | (string & {});
+    /** GeoJSON Polygon/MultiPolygon geometry, kept opaque to avoid a geometry dep here. */
+    readonly geometry: Record<string, unknown>;
+    readonly dwellSeconds?: number;
+    readonly description?: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeofenceZoneWriteRequest {
+    readonly name: string;
+    readonly enabled?: boolean;
+    readonly trigger: "enter" | "exit" | "dwell" | (string & {});
+    readonly geometry: Record<string, unknown>;
+    readonly dwellSeconds?: number;
+    readonly description?: string;
+    readonly ifMatch?: string;
+}
+/** Binding of an alert rule to a delivery channel, carrying the last delivery error if any. */
+export interface HonuaDeliveryChannelBinding {
+    readonly channelId: string;
+    readonly kind: "email" | "webhook" | "slack" | "pagerduty" | "sms" | (string & {});
+    readonly enabled: boolean;
+    readonly target?: string;
+    readonly lastDeliveryState?: HonuaAlertDeliveryStatus["state"];
+    readonly lastError?: HonuaProblemDetails;
+}
+export interface HonuaInvestigation extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly title: string;
+    readonly status: "open" | "investigating" | "resolved" | "closed" | (string & {});
+    readonly summary?: string;
+    readonly targetId?: string;
+    readonly createdAt: string;
+    readonly updatedAt?: string;
+    readonly createdBy?: string;
+    readonly pinnedItemIds?: readonly string[];
+    readonly timeline?: readonly HonuaInvestigationTimelineEntry[];
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaInvestigationTimelineEntry {
+    readonly id: string;
+    readonly kind: "note" | "event" | "alert" | "log" | "job" | (string & {});
+    readonly at: string;
+    readonly summary: string;
+    readonly refId?: string;
+    readonly pinned?: boolean;
+    readonly author?: string;
+}
+export interface HonuaInvestigationCreateRequest {
+    readonly title: string;
+    readonly summary?: string;
+    readonly targetId?: string;
+    readonly seedItemIds?: readonly string[];
+}
+export interface HonuaInvestigationPinRequest {
+    readonly itemId: string;
+    readonly pinned: boolean;
+    readonly ifMatch?: string;
+}
+export type HonuaJobState = "queued" | "running" | "succeeded" | "failed" | "cancelled" | "retrying" | (string & {});
+/** Job lifecycle controls; availability is state/policy-driven, never inferred by the UI. */
+export type HonuaJobAction = "cancel" | "retry" | "rerun" | "pause" | "resume" | (string & {});
+export interface HonuaJobRunSummary extends HonuaOperateEntityValidators {
+    readonly id: string;
+    readonly name: string;
+    readonly type?: string;
+    readonly targetId?: string;
+    readonly state: HonuaJobState;
+    readonly queuedAt?: string;
+    readonly startedAt?: string;
+    readonly finishedAt?: string;
+    readonly durationMs?: number;
+    readonly attempt?: number;
+    readonly maxAttempts?: number;
+    readonly progress?: {
+        readonly completed?: number;
+        readonly total?: number;
+        readonly message?: string;
+    };
+    /** Actions currently permitted for this run given its state and the caller's policy. */
+    readonly availableActions: readonly HonuaJobAction[];
+    readonly problem?: HonuaProblemDetails;
+    readonly links?: HonuaOperateLinks;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaJobRunDetail extends HonuaJobRunSummary {
+    readonly stages?: readonly HonuaJobStage[];
+    readonly artifacts?: readonly HonuaJobArtifact[];
+    readonly parameters?: Record<string, unknown>;
+    readonly triggeredBy?: string;
+    /** Id of the prior run this run retried, when `state === "retrying"` or after a retry. */
+    readonly retryOfRunId?: string;
+}
+export interface HonuaJobStage {
+    readonly id: string;
+    readonly name: string;
+    readonly state: HonuaJobState;
+    readonly startedAt?: string;
+    readonly finishedAt?: string;
+    readonly durationMs?: number;
+    readonly message?: string;
+    readonly problem?: HonuaProblemDetails;
+}
+export interface HonuaJobLog {
+    readonly id: string;
+    readonly jobId: string;
+    readonly stageId?: string;
+    readonly level: HonuaLogLevel;
+    readonly message: string;
+    readonly timestamp: string;
+    readonly attributes?: Record<string, unknown>;
+}
+export interface HonuaJobArtifact {
+    readonly id: string;
+    readonly jobId: string;
+    readonly name: string;
+    readonly contentType?: string;
+    readonly sizeBytes?: number;
+    readonly createdAt?: string;
+    readonly href?: string;
+    readonly checksum?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface HonuaJobActionRequest {
+    readonly action: HonuaJobAction;
+    readonly reason?: string;
+    readonly ifMatch?: string;
+}
+export interface HonuaOperateRawRequest extends HonuaOperateRequestOptions {
+    readonly method?: QueryMethod;
+    readonly path: string;
+    readonly body?: unknown;
+    readonly okStatuses?: readonly number[];
+}
+//# sourceMappingURL=types.d.ts.map

package/operate/types.d.ts.map

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

package/operate/types.js

@@ -0,0 +1,17 @@
+/**
+ * Operate observability SDK contracts.
+ *
+ * Shared, protocol-neutral shapes for the Console / MCP / Studio "Operate"
+ * surfaces: server telemetry status, operational events, logs, alerts, realtime
+ * alert rules, geofence zones, delivery channel bindings, investigations, and the
+ * job viewer (runs, stages, logs, artifacts).
+ *
+ * These mirror honua-server#1168 / #1169 / #1170 and are designed so fixture data
+ * can drive Console Operate screens before live endpoints land. Capability gaps
+ * are represented as typed degraded results (see {@link HonuaOperateUnsupported})
+ * rather than thrown errors, and action availability is carried explicitly by the
+ * resource state/policy rather than inferred by the UI.
+ *
+ * @module
+ */
+export const HONUA_OPERATE_BASE_PATH = "/api/v1/operate";

package/operator/client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `OperatorClient` — consumer-facing transport interface every operator
+ * controller depends on. Authored in this module so controllers and
+ * tests are not blocked on a downstream `HonuaClient` extension; the
+ * shipping `HonuaClient` is expected to implement this interface
+ * (mirroring how `#21` shipped runtime code against an interface its
+ * server counterpart later filled in).
+ *
+ * The interface names operator methods only — wire framing
+ * (HTTP/MCP/gRPC) is the implementer's choice.
+ *
+ * @module
+ */
+import type { IJobRun } from "../contract/index.js";
+import type { HonuaMapPackage } from "../runtime/index.js";
+import type { AnalysisIntent, AnalysisPlan, AppPackage, ApprovalDecision, BuilderIntent, BuilderPlan, ClarificationAnswer, DeploymentPlan, ExecutionResult, PublishingPlan } from "./workspace/types.js";
+export interface ChatChunk {
+    readonly turnId: string;
+    readonly delta: string;
+    readonly done: boolean;
+    readonly intentDraft?: AnalysisIntent | BuilderIntent;
+}
+/**
+ * Minimal operator transport surface. The full interface is consumed by
+ * the controllers in `src/operator/controllers/`.
+ */
+export interface OperatorClientApi {
+    chat(text: string, signal?: AbortSignal): AsyncIterable<ChatChunk>;
+    clarify(intentId: string, answers: ReadonlyArray<ClarificationAnswer>, signal?: AbortSignal): Promise<AnalysisIntent | BuilderIntent>;
+    getPlan(intentId: string, signal?: AbortSignal): Promise<AnalysisPlan | PublishingPlan | BuilderPlan | DeploymentPlan>;
+    /**
+     * Request a revised plan from the server. `notes` carries the
+     * embedder's revision request (e.g. "use vector tiles instead") and
+     * is forwarded as part of the wire request, not just observed in
+     * telemetry.
+     */
+    revisePlan(intentId: string, notes: string | undefined, signal?: AbortSignal): Promise<AnalysisPlan | PublishingPlan | BuilderPlan | DeploymentPlan>;
+    submitPlan(plan: AnalysisPlan | PublishingPlan | BuilderPlan | DeploymentPlan, signal?: AbortSignal): Promise<IJobRun<ExecutionResult>>;
+    refineMap(intentId: string, prompt: string, signal?: AbortSignal): Promise<HonuaMapPackage>;
+    refineApp(intentId: string, prompt: string, signal?: AbortSignal): Promise<AppPackage>;
+    getApproval(operationId: string, signal?: AbortSignal): Promise<ApprovalDecision>;
+    confirmApproval(operationId: string, signal?: AbortSignal): Promise<ApprovalDecision>;
+}
+/**
+ * `HonuaClient` (or any caller-supplied client) must expose the operator
+ * methods on a stable `operator` namespace. The operator surface is
+ * isolated so that pre-operator embedders pay no cost and adapter
+ * extensions do not collide with operator method names.
+ */
+export interface OperatorClient {
+    readonly operator: OperatorClientApi;
+}
+/**
+ * The fixed output key the server places the single execution result
+ * under in `JobResult<ExecutionResult>.outputs`. Naming the key in one
+ * place lets controllers read it without spreading wire-shape knowledge.
+ * If the server contract renames the key, only this constant changes.
+ */
+export declare const OPERATOR_EXECUTION_OUTPUT_KEY = "result";
+//# sourceMappingURL=client.d.ts.map

package/operator/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/operator/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACnE,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC3C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CAAC;IAC3C,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC;IACzE;;;;;OAKG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC;IACzE,UAAU,CACR,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,EAClE,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IACrC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5F,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvF,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClF,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvF;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,WAAW,CAAC"}

package/operator/client.js

@@ -0,0 +1,20 @@
+/**
+ * `OperatorClient` — consumer-facing transport interface every operator
+ * controller depends on. Authored in this module so controllers and
+ * tests are not blocked on a downstream `HonuaClient` extension; the
+ * shipping `HonuaClient` is expected to implement this interface
+ * (mirroring how `#21` shipped runtime code against an interface its
+ * server counterpart later filled in).
+ *
+ * The interface names operator methods only — wire framing
+ * (HTTP/MCP/gRPC) is the implementer's choice.
+ *
+ * @module
+ */
+/**
+ * The fixed output key the server places the single execution result
+ * under in `JobResult<ExecutionResult>.outputs`. Naming the key in one
+ * place lets controllers read it without spreading wire-shape knowledge.
+ * If the server contract renames the key, only this constant changes.
+ */
+export const OPERATOR_EXECUTION_OUTPUT_KEY = "result";

package/operator/controllers/approval.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `ApprovalController` — loads the policy decision for an in-flight
+ * operation and exposes a single `confirm()` action when the gate is
+ * `pending`. The controller never short-circuits a deferred outcome
+ * to "approved"; it surfaces the server's verbatim decision.
+ *
+ * Audit entries returned with each decision are forwarded to the
+ * `OperatorTelemetry.after` hook as `approval-audit` events so partner
+ * observability stacks see the same evidence the server records. The
+ * server remains the canonical audit-of-record — client telemetry is
+ * observability, not evidence.
+ *
+ * @module
+ */
+import type { OperatorClient } from "../client.js";
+import { HonuaOperatorApprovalError } from "../errors.js";
+import type { OperatorTelemetry } from "../telemetry.js";
+import type { ApprovalAuditEntry, ApprovalDecision } from "../workspace/types.js";
+import { type Unsubscribe } from "./base.js";
+export type ApprovalEvent = {
+    kind: "loaded";
+    decision: ApprovalDecision;
+} | {
+    kind: "confirmed";
+    decision: ApprovalDecision;
+} | {
+    kind: "audit";
+    entry: ApprovalAuditEntry;
+    decision: ApprovalDecision;
+} | {
+    kind: "error";
+    error: HonuaOperatorApprovalError;
+};
+export interface ApprovalControllerOptions {
+    client: OperatorClient;
+    telemetry?: OperatorTelemetry;
+}
+export declare class ApprovalController {
+    #private;
+    constructor(options: ApprovalControllerOptions);
+    get decision(): ApprovalDecision | undefined;
+    on(listener: (event: ApprovalEvent) => void): Unsubscribe;
+    load(operationId: string, signal?: AbortSignal): Promise<ApprovalDecision>;
+    /**
+     * Confirm a `pending` approval. The controller refuses to invoke the
+     * server when the loaded decision is in any other state — preventing
+     * a UI from re-confirming an already granted/denied/deferred outcome.
+     * Returns the server's outcome unchanged.
+     */
+    confirm(operationId: string, signal?: AbortSignal): Promise<ApprovalDecision>;
+}
+//# sourceMappingURL=approval.d.ts.map

package/operator/controllers/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../../src/operator/controllers/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAe,KAAK,WAAW,EAAyC,MAAM,WAAW,CAAC;AAEjG,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,qBAAa,kBAAkB;;gBAYV,OAAO,EAAE,yBAAyB;IAKrD,IAAW,QAAQ,IAAI,gBAAgB,GAAG,SAAS,CAElD;IAEM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW;IAInD,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmCvF;;;;;OAKG;IACU,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyD3F"}