@openwop/openwop 1.1.5 → 1.1.6

package/src/types.ts

@@ -125,7 +125,12 @@ export interface RunConfigurable {
 }
 
 export interface CreateRunRequest {
-  workflowId: string;
+  /**
+   * The workflow to run. Required for a normal run; OMITTED for an eval run
+   * (`mode: 'eval'`), which targets `agentId` + `evalSuiteRef` instead
+   * (RFC 0081 §B). The server enforces the conditional requirement.
+   */
+  workflowId?: string;
   inputs?: Record<string, unknown>;
   tenantId?: string;
   scopeId?: string;
@@ -133,6 +138,12 @@ export interface CreateRunRequest {
   configurable?: RunConfigurable;
   tags?: readonly string[];
   metadata?: Record<string, unknown>;
+  /** RFC 0081 §B. `'eval'` makes this run an eval-suite projection (see `evalSuiteRef` + `agentId`). Omit for a normal workflow run. */
+  mode?: 'eval';
+  /** RFC 0081. URI of the `AgentEvalSuite` to run. Required when `mode === 'eval'`. */
+  evalSuiteRef?: string;
+  /** RFC 0081. The manifest agent the eval suite targets. Required when `mode === 'eval'`. */
+  agentId?: string;
 }
 
 export interface CreateRunResponse {
@@ -1054,3 +1065,244 @@ export interface AgentInventoryResponse {
   agents: AgentInventoryEntry[];
   total: number;
 }
+
+/* ── Standing agent roster + org-chart (RFC 0086 / 0087) ──────────────── */
+
+/** RFC 0086 §A — a standing agent INSTANCE: a `host:<id>` AgentRef that
+ *  references a manifest/deployment and owns a workflow portfolio. */
+export interface AgentRosterEntry {
+  rosterId: string;
+  persona: string;
+  agentRef: { agentId: string; version?: string; channel?: string };
+  workflows?: string[];
+  owner: { tenantId: string; workspaceId?: string };
+  enabled?: boolean;
+  label?: string;
+  description?: string;
+}
+
+/** Response for `GET /v1/agents/roster` (RFC 0086 §B). */
+export interface AgentRosterResponse {
+  roster: AgentRosterEntry[];
+  total: number;
+}
+
+/** RFC 0087 §A — an org-chart department (a tree node via `parentDepartmentId`). */
+export interface OrgChartDepartment {
+  departmentId: string;
+  name: string;
+  parentDepartmentId: string | null;
+  roles: { roleId: string; name: string }[];
+}
+
+/** RFC 0087 §A — an org-chart member (a roster instance placed in a dept/role). */
+export interface OrgChartMember {
+  rosterId: string;
+  departmentId: string;
+  roleId: string;
+  reportsTo: string | null;
+}
+
+/** RFC 0087 §A — the descriptive org-chart over roster members. Carries no
+ *  authority-bearing field by design (§B `org-position-no-authority-escalation`). */
+export interface AgentOrgChart {
+  owner: { tenantId: string; workspaceId?: string };
+  departments: OrgChartDepartment[];
+  members: OrgChartMember[];
+}
+
+/** Response for `GET /v1/agents/org-chart/{departmentId}` (RFC 0087 §D) — the
+ *  department subtree + the responsibility roll-up (union of member portfolios). */
+export interface OrgChartResponsibilityView {
+  department: OrgChartDepartment;
+  members: OrgChartMember[];
+  responsibilities: string[];
+}
+
+/* ── User-authored agents (sample-extension; non-normative) ─────────────
+ * Backs the workflow-engine sample app's Agents tab. Pack-installed
+ * agents come through `AgentInventoryEntry` above (RFC 0072 §A
+ * normative inventory). The types below mirror the sample-host
+ * `POST /v1/host/sample/agents` create surface — they're scoped to
+ * the sample-extension and may evolve independently of the
+ * normative agent surface. Future RFC promotion would migrate these
+ * to the normative wire shape.
+ */
+
+/** Body for `POST /v1/host/sample/agents`. The server synthesises
+ *  the agentId as `user.<tenantId>.<persona-slug>`. */
+export interface CreateUserAgentRequest {
+  /** Short name; becomes the `@`-mention slug and chat panel label.
+   *  Required, ≤64 chars. */
+  persona: string;
+  /** Longer display name; defaults to the persona when omitted. */
+  label?: string;
+  description?: string;
+  /** One of: `chat`, `reasoning`, `coding`, `extraction`. */
+  modelClass: string;
+  /** Inline system prompt body; ≤16 000 chars. The sample-host stores
+   *  it directly (no pack-file ref). */
+  systemPrompt: string;
+  /** Capability ids the agent is allowed to call; ≤32 entries. */
+  toolAllowlist?: string[];
+  memoryShape?: {
+    scratchpad?: boolean;
+    conversation?: boolean;
+    longTerm?: boolean;
+  };
+  /** 0.0-1.0; decisions below this are surfaced as low-confidence. */
+  confidenceThreshold?: number;
+}
+
+/** Response body for `POST /v1/host/sample/agents` — shaped to
+ *  match `AgentInventoryEntry` minus normative-only fields, so a
+ *  follow-up `GET /v1/agents` returns a row of the same shape. */
+export interface UserAgentRecord {
+  agentId: string;
+  persona: string;
+  label: string;
+  description?: string;
+  modelClass: string;
+  packName: string;
+  packVersion: string;
+  toolAllowlist: string[];
+  memoryShape: {
+    scratchpad: boolean;
+    conversation: boolean;
+    longTerm: boolean;
+  };
+  confidenceThreshold?: number;
+  hasHandoffSchemas: false;
+}
+
+/** One installable agent-pack summary from the sample host's local
+ *  registry mirror (`GET /v1/host/sample/registry/agent-packs`). */
+export interface AgentPackSummary {
+  /** Pack name, e.g. `core.openwop.agents.code-reviewer`. */
+  name: string;
+  version: string;
+  description?: string;
+  /** Personas declared by the pack's `agents[]` (per RFC 0003). */
+  personas: string[];
+  /** True when at least one of the pack's agents is registered in
+   *  this host's in-process AgentRegistry. */
+  installed: boolean;
+}
+
+export interface AgentPackRegistryResponse {
+  packs: AgentPackSummary[];
+  total: number;
+}
+
+export interface InstallAgentPackRequest {
+  /** Must start with `core.openwop.agents.` — the sample's install
+   *  route filters to that namespace. */
+  name: string;
+  /** Defaults to `1.0.0` when omitted. */
+  version?: string;
+}
+
+export interface InstallAgentPackResponse {
+  name: string;
+  version: string;
+  /** True when the pack was newly installed; false when it was
+   *  already present in the registry. */
+  installed: boolean;
+  alreadyInstalled: boolean;
+}
+
+// ── RFC 0081 — Agent evaluation (eval-summary.schema.json) ─────────────
+
+/** Abstract model class (RFC 0002 / RFC 0003 manifest vocabulary). */
+export type AgentModelClass =
+  | 'reasoning'
+  | 'writing'
+  | 'coding'
+  | 'research'
+  | 'classification'
+  | 'general';
+
+/** A redaction-safe safety finding ({kind, severity} descriptor — never excerpted content). */
+export interface EvalSafetyFinding {
+  kind: string;
+  severity: 'low' | 'medium' | 'high' | 'critical';
+}
+
+/** Per-task result on an `EvalSummary` (content-free: scores + scalars + ids). */
+export interface EvalTaskResult {
+  taskId: string;
+  score: number;
+  passed: boolean;
+  costUsd?: number;
+  latencyMs?: number;
+  schemaValid?: boolean;
+  safetyFindings?: readonly EvalSafetyFinding[];
+}
+
+/** The regression block on an `EvalSummary` (RFC 0081 §D `regression` mode). */
+export interface EvalRegression {
+  baselineRunId: string;
+  scoreDelta: number;
+  diffRef?: string;
+}
+
+/**
+ * RFC 0081 §C — the terminal scorecard of an eval run, read via
+ * `client.runs.evalSummary(runId)`. Content-free: scores, scalars, ids, and
+ * redaction-safe safety descriptors only (`eval-summary-no-content-leak`).
+ */
+export interface EvalSummary {
+  suiteId: string;
+  suiteVersion: string;
+  evaluatedModelClass?: AgentModelClass;
+  aggregateScore: number;
+  passed: boolean;
+  taskCount: number;
+  passedCount: number;
+  totalCostUsd?: number;
+  tasks: readonly EvalTaskResult[];
+  regression?: EvalRegression;
+}
+
+// ── RFC 0082 — Agent deployment lifecycle ─────────────────────────────
+
+/** The seven-state deployment lifecycle (RFC 0082 §C). */
+export type DeploymentState =
+  | 'draft'
+  | 'test'
+  | 'staged'
+  | 'active'
+  | 'paused'
+  | 'deprecated'
+  | 'rolled-back';
+
+/**
+ * RFC 0082 §C — a per-(agentId, version) deployment record, returned by
+ * `client.agents.listDeployments` / `transitionDeployment`. Host-runtime state
+ * distinct from the immutable manifest and the registry's published tags.
+ */
+export interface AgentDeployment {
+  agentId: string;
+  version: string;
+  state: DeploymentState;
+  canaryPercent?: number;
+  rollbackPointer?: string;
+  channels?: readonly string[];
+  evalRunId?: string;
+  approvalGateId?: string;
+}
+
+/**
+ * RFC 0082 §E — the `transitionDeployment` request body. The host authorizes it
+ * fail-closed (RFC 0049 `deploy:*`), runs any RFC 0051 approvalGate, and enforces
+ * RFC 0081 `requiredEval` before emitting `deployment.promoted`.
+ */
+export interface AgentDeploymentTransition {
+  version: string;
+  transition: 'promote' | 'pause' | 'deprecate' | 'rollback' | 'adjust-canary';
+  toState?: DeploymentState;
+  channel?: string;
+  canaryPercent?: number;
+  evalRunId?: string;
+  reason?: string;
+}