@kindgi/api 0.1.2 → 0.1.4-rc.0

package/src/hitl-binding.ts

@@ -12,6 +12,7 @@ import type { ReviewerRole } from '@kindgi/authz';
 import type {
   ApprovalId,
   Cursor,
+  ListScope,
   ProjectId,
   ProvenanceId,
   Result,
@@ -57,6 +58,12 @@ export interface Approval {
   readonly updatedAt: Timestamp;
   readonly decidedAt?: Timestamp;
   readonly expiresAt?: Timestamp;
+  /**
+   * The reviewer's decision, once one is recorded. Absent while the
+   * approval is open, and when it ended without one (it expired, or a
+   * timeout escalated it).
+   */
+  readonly decision?: ReviewDecisionRecord;
 }
 
 export interface ReviewDecision {
@@ -76,6 +83,8 @@ export interface ReviewDecision {
 export interface ListApprovalsBindingInput {
   readonly tenantId: TenantId;
   readonly limit: number;
+  /** Only one project's approvals, or every project's in an org. Absent: the tenant's. */
+  readonly scope?: ListScope;
   readonly status?: ApprovalStatus;
   readonly requiredRole?: ReviewerRole;
   readonly since?: Timestamp;
@@ -110,12 +119,18 @@ export type SubmitReviewBindingResult =
     };
 
 /**
- * A single review-decision row hydrated for the audit-bundle route.
- * `null` = the approval terminated without a recorded decision (e.g.
- * status `expired`).
+ * An approval's recorded decision: on the approval it decided
+ * (`Approval.decision`), and for the audit-bundle route. `null` from
+ * `loadReviewDecision` = the approval terminated without a recorded
+ * decision (e.g. status `expired`).
  */
 export interface ReviewDecisionRecord {
   readonly decision: ReviewDecisionKind;
+  /**
+   * Who decided, as an actor: `user:<userId>`, the reviewer's user.
+   * Absent from a binding that doesn't record it (the Kindgi runtime does).
+   */
+  readonly decidedBy?: string;
   readonly reviewerId: ReviewerId;
   readonly reviewerRoleAtDecision: ReviewerRole;
   readonly decidedAt: Timestamp;
@@ -163,7 +178,8 @@ export interface HitlBinding {
   /**
    * Hydrate the recorded decision row for an approval — used by the
    * audit-bundle route. Returns `null` when the approval terminated
-   * without a recorded decision (status `expired`).
+   * without a recorded decision (status `expired`). `getApproval` and
+   * `listApprovals` return the same decision on each approval.
    */
   loadReviewDecision(
     tenantId: TenantId,

package/src/index.ts

@@ -233,6 +233,7 @@ export type {
   AgentPublishInput,
   AgentPublishOutcome,
   AgentRegistryBinding,
+  AgentVersionRecord,
   AgentReinstateVersionInput,
   AgentReinstateVersionOutcome,
   AgentUnregisterInput,
@@ -247,6 +248,7 @@ export type {
   FlowPublishInput,
   FlowPublishOutcome,
   FlowRegistryBinding,
+  FlowVersionRecord,
   FlowReinstateVersionInput,
   FlowReinstateVersionOutcome,
   FlowUnregisterInput,
@@ -309,7 +311,7 @@ export {
   stdioRefusal,
 } from './tenant-host-access.js';
 export type { HostReach, TenantHostAccess } from './tenant-host-access.js';
-export { POLICY_KINDS } from '@kindgi/policy-contract';
+export { APPLIED_POLICY_KINDS, POLICY_KINDS } from '@kindgi/policy-contract';
 export type {
   Policy,
   PolicyGetInput,
@@ -328,6 +330,61 @@ export type {
   PolicyVersionPage,
   PolicyVersionRow,
 } from '@kindgi/policy-contract';
+export { JUDGE_CLASS_SCOPE_KINDS, VERDICTS, judgeClassApplies } from './judgment-binding.js';
+export type {
+  EvalCaseListInput,
+  EvalCasePage,
+  EvalCasePutInput,
+  EvalCaseStoreBinding,
+  JudgedEvalCase,
+  JudgedItemSummary,
+} from './eval-case-binding.js';
+export { MAX_JUDGED_CASES } from './routes/judged-suites.js';
+export { MAX_JUDGED_HISTORY } from './routes/judgment-context.js';
+export type {
+  JudgeClass,
+  JudgeClassCreateInput,
+  JudgeClassCreateOutcome,
+  JudgeClassGetInput,
+  JudgeClassListInput,
+  JudgeClassPage,
+  JudgeClassScope,
+  JudgeClassScopeKind,
+  JudgeClassUpdateInput,
+  JudgedItem,
+  JudgedFlowContext,
+  JudgedFlowStep,
+  JudgedRunContext,
+  JudgedToolCall,
+  JudgedRunCopy,
+  JudgedRunListInput,
+  JudgedRunPage,
+  JudgedRunWithJudgments,
+  JudgedSubject,
+  Judgment,
+  JudgmentAssertedBy,
+  JudgmentGetInput,
+  JudgmentListInput,
+  JudgmentPage,
+  JudgmentRecordInput,
+  JudgmentRegistryBinding,
+  JudgmentWithCopies,
+  Verdict,
+} from './judgment-binding.js';
+export { resolvePointer } from './routes/judgments.js';
+export type {
+  BlockGetInput,
+  BlockGetVersionInput,
+  BlockListInput,
+  BlockListVersionsInput,
+  BlockPage,
+  BlockPublishInput,
+  BlockPublishOutcome,
+  BlockRecord,
+  BlockRegistryBinding,
+  BlockReinstateOutcome,
+  BlockVersionInput,
+} from './block-binding.js';
 export { EVAL_KINDS } from './eval-suite-binding.js';
 export type {
   EvalKind,
@@ -348,6 +405,9 @@ export type {
 export { EVAL_RUN_STATUSES } from './eval-run-binding.js';
 export type {
   AgentRef,
+  EvalBaseline,
+  EvalComparison,
+  EvalReads,
   EvalRun,
   EvalRunBinding,
   EvalRunCancelInput,
@@ -379,7 +439,27 @@ export type {
   EvalSubjectInvoker,
   InProcessEvalRunBindingOptions,
 } from './eval-run-dispatcher.js';
-export { COST_GROUP_DIMENSIONS } from './cost-binding.js';
+export { DEFAULT_COMPARISON, createJudgedDispatcher } from './judged-dispatcher.js';
+export type {
+  ComparisonBaselineSummary,
+  ComparisonMetric,
+  JudgedCaseResult,
+  JudgedComparisonSummary,
+  JudgedDispatcherOptions,
+} from './judged-dispatcher.js';
+export { itemChanges, matchJudged, outputItems, scoreItems, valueAt } from './judged-items.js';
+export type {
+  ItemChanges,
+  ItemJudgments,
+  MatchedItem,
+  OutputItem,
+  OutputScore,
+} from './judged-items.js';
+export {
+  COST_AGGREGATE_DEFAULT_LIMIT,
+  COST_AGGREGATE_MAX_LIMIT,
+  COST_GROUP_DIMENSIONS,
+} from './cost-binding.js';
 export type {
   CostAggregateGroup,
   CostAggregateInput,
@@ -391,6 +471,7 @@ export type {
   CostRecord,
   CostRecordFilter,
   CostRecordPage,
+  CostTokenTotals,
 } from './cost-binding.js';
 export type {
   ToolGetInput,
@@ -476,7 +557,10 @@ export type {
   DeploymentGetInput,
   DeploymentListInput,
   DeploymentPage,
+  DeployedAgent,
+  DeployedFlow,
   DeployedPrimitive,
+  DeployedVersion,
   DeploymentContents,
   DeploymentPrimitiveCounts,
   DeploymentRegisterInput,
@@ -550,6 +634,8 @@ export type {
   ListProvenanceRecordsInput,
   ListProvenanceRecordsResult,
   ProvenanceBinding,
+  CallUsage,
+  CallUsageByCallId,
   ProvenanceBindingError,
   ProvenanceListCursor,
   ProvenanceRecordSummary,