@qontinui/shared-types 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/AgentCommand.d.ts

@@ -0,0 +1,81 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An account-scoped **override** of a runner-embedded default agent command.
+ *
+ * Presence of this record means "this organization has customized the command
+ * named `name`"; absence means the embedded default applies. See the module
+ * docs for the full resolution order and the delete-is-reset semantics.
+ *
+ * `body` is the whole markdown procedure — the exact bytes written to
+ * `.claude/commands/<name>.md`. It is **untrusted remote content** from the
+ * runner's point of view: it is markdown rather than code, but it is
+ * instructions to an agent, so consumers fail soft (a malformed override falls
+ * back to the embedded default and warns) and never fetch cross-org.
+ */
+export interface AgentCommand {
+  /**
+   * The full markdown body of the command.
+   */
+  body: string;
+  /**
+   * Content hash of [`body`](Self::body), for cheap change detection
+   * (cache invalidation, diff-against-default). `None` on rows written
+   * before a checksum was computed.
+   *
+   * Computed by [`agent_command_checksum`] — `"sha256-<hex>"` over the
+   * LF-normalized body. Do not hand-roll it; a producer that hashes raw
+   * bytes disagrees with one that hashes a CRLF round-trip.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp.
+   */
+  created_at: string;
+  /**
+   * User who last authored this override. **Attribution only** — it does not
+   * scope visibility; [`organization_id`](Self::organization_id) does.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Head of the version chain — the `version_number` of the
+   * [`AgentCommandVersion`] whose body this record currently carries.
+   * Starts at 1 and only ever increases (a revert bumps it; see the module
+   * docs).
+   */
+  current_version: number;
+  /**
+   * Override record id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Whether this override is visible to the whole organization rather than
+   * only its author. Absent means `false`.
+   */
+  is_shared: boolean;
+  /**
+   * The command slug, e.g. `vet-plan` or `implement-plan`. This is the
+   * override key: it must equal the name of the embedded default it
+   * replaces, and it is the filename stem under `.claude/commands/`.
+   *
+   * Because it becomes a path component, it is a write-boundary value —
+   * validate it with [`validate_agent_command_name`] before persisting.
+   */
+  name: string;
+  /**
+   * Owning organization (`auth.organizations.id`). `None` where the row has
+   * been orphaned by an organization deletion (`ondelete SET NULL`); such a
+   * row is not resolvable by any account and behaves as no override.
+   */
+  organization_id?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) last-modification timestamp.
+   */
+  updated_at: string;
+  [k: string]: unknown;
+}

package/src/generated/AgentCommandError.d.ts

@@ -0,0 +1,23 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Failure modes for agent-command overrides. Mirrors the tagged-enum shape of
+ * [`crate::apps::AppError`], so the qontinui-web layer can surface a rejected
+ * override the same way it surfaces a rejected app registration.
+ */
+export type AgentCommandError =
+  | {
+      name: string;
+      reason: "invalid-name";
+      [k: string]: unknown;
+    }
+  | {
+      name: string;
+      reason: "reserved-name";
+      [k: string]: unknown;
+    };

package/src/generated/AgentCommandVersion.d.ts

@@ -0,0 +1,67 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One immutable entry in an [`AgentCommand`]'s append-only version chain.
+ *
+ * Rows are **only ever inserted**. An edit appends the next `version_number`;
+ * a revert appends a new version whose `body` is copied from an older one and
+ * whose [`restored_from`](Self::restored_from) names that older version.
+ * Nothing in the chain is updated or deleted, so the chain is the complete
+ * edit history and "revert" is itself a recorded edit.
+ */
+export interface AgentCommandVersion {
+  /**
+   * The [`AgentCommand`] this version belongs to. Deleting the override
+   * cascades to its versions — resetting to the default discards the
+   * account's edit history along with the override.
+   */
+  agent_command_id: string;
+  /**
+   * The full markdown body as of this version.
+   */
+  body: string;
+  /**
+   * Free-text note describing what changed, supplied by the editor. Revert
+   * writes a generated one (e.g. `"Restored from version 2"`).
+   */
+  change_description?: string | null;
+  /**
+   * Content hash of [`body`](Self::body) at this version, from
+   * [`agent_command_checksum`]. Equal checksums on two versions mean the
+   * bodies are identical — which is what lets the UI show a revert as
+   * "back to v2's content" without refetching either body.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp. Versions are immutable, so
+   * there is deliberately no `updated_at`.
+   */
+  created_at: string;
+  /**
+   * User who authored this version. Attribution only.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Version-row id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Provenance for a revert: the `version_number` this version's body was
+   * copied from. `None` for an ordinary edit. Present only on versions
+   * produced by a restore, which is how the UI distinguishes "edited" from
+   * "reverted to v2" in the history list.
+   */
+  restored_from?: number | null;
+  /**
+   * Monotonic version number within this command, starting at 1. Unique per
+   * `(agent_command_id, version_number)`; the DB constraint — not
+   * application code — is what rejects a duplicate under concurrent appends.
+   */
+  version_number: number;
+  [k: string]: unknown;
+}

package/src/generated/ComponentActionInfo.d.ts

@@ -13,6 +13,19 @@ export interface ComponentActionInfo {
    * Longer description of what the action does.
    */
   description?: string | null;
+  /**
+   * Safety class of this action: `read`, `write` or `destructive`.
+   *
+   * **A safety annotation, not a hint.** An autonomous walk MUST NOT fire an
+   * action annotated `destructive`; that is the same exclusion the IR already
+   * applies to `destructive` transitions when generating auto-regressions.
+   * Author-declared, because only the app author knows that a particular
+   * `click` is a delete button.
+   *
+   * Absent means **unclassified, not safe** — an action nobody has judged
+   * must be treated as unknown rather than as `read`.
+   */
+  effect?: ("read" | "write" | "destructive") | null;
   /**
    * Unique action identifier within the component.
    */
@@ -21,4 +34,24 @@ export interface ComponentActionInfo {
    * Human-readable label.
    */
   label?: string | null;
+  /**
+   * Free-form declaration of the action's parameters, author-supplied on the
+   * SDK side as `ComponentAction.paramSchema` and surfaced verbatim on
+   * `/control/components`. Conventionally a small JSON Schema subset, but the
+   * SDK does not constrain the shape, so it is carried through untyped — the
+   * same treatment `ElementActionRequest::params` gets.
+   */
+  paramSchema?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Fully-resolved invocation path for this action:
+   * `/control/component/<componentId>/action/<actionId>`.
+   *
+   * **Server-annotated, not author-declared**: the SDK's
+   * `annotateComponentWithInvocationPaths` computes it when serving the
+   * component listing, so it is present on the wire but absent from anything
+   * an app author writes.
+   */
+  path?: string | null;
 }

package/src/generated/UIBridgeComponent.d.ts

@@ -14,6 +14,16 @@ import type { ComponentActionInfo } from "./ComponentActionInfo";
  * (e.g. "submit form", "reset filters").
  */
 export interface UIBridgeComponent {
+  /**
+   * Invocation-path template for this component's actions, emitted with a
+   * literal `{actionId}` placeholder:
+   * `/control/component/<componentId>/action/{actionId}`.
+   *
+   * **Server-annotated, not author-declared**: emitted by the SDK's
+   * `annotateComponentWithInvocationPaths` alongside the per-action
+   * [`ComponentActionInfo::path`].
+   */
+  actionInvocationPath?: string | null;
   /**
    * Actions exposed by this component.
    */

package/src/generated/index.ts

@@ -18,6 +18,9 @@ export type { ActionResponse } from './ActionResponse';
 export type { ActionStatus } from './ActionStatus';
 export type { ActionType } from './ActionType';
 export type { ActiveStatesResult } from './ActiveStatesResult';
+export type { AgentCommand } from './AgentCommand';
+export type { AgentCommandError } from './AgentCommandError';
+export type { AgentCommandVersion } from './AgentCommandVersion';
 export type { AgenticPhaseOutput } from './AgenticPhaseOutput';
 export type { AgenticStatus } from './AgenticStatus';
 export type { AiWorkflow } from './AiWorkflow';