@kindgi/runtime 0.1.4-rc.1 → 0.1.4-rc.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/inputs.d.ts +12 -1
- package/dist/inputs.d.ts.map +1 -1
- package/dist/runs.d.ts +7 -1
- package/dist/runs.d.ts.map +1 -1
- package/package.json +5 -5
- package/src/inputs.ts +22 -1
- package/src/runs.ts +16 -1
package/dist/inputs.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { Principal } from '@kindgi/authz';
|
|
2
2
|
import type { Flow, FlowVersionOverrides } from '@kindgi/flow';
|
|
3
3
|
import type { HandlerRegistry } from '@kindgi/handler';
|
|
4
|
-
import type { ConversationId, NodeId, ProjectId, Result, RunId, TenantId } from '@kindgi/types';
|
|
4
|
+
import type { AgentVersionVia, ConversationId, LiveScope, NodeId, ProjectId, Result, RunId, ScopeSegment, TenantId } from '@kindgi/types';
|
|
5
5
|
import type { HandlerMissingError } from './errors.js';
|
|
6
6
|
import type { KernelEventBusBinding } from './event-bus.js';
|
|
7
7
|
import type { RunOptions } from './types.js';
|
|
@@ -47,6 +47,10 @@ export interface RunAgentRef {
|
|
|
47
47
|
readonly id: string;
|
|
48
48
|
readonly version: string;
|
|
49
49
|
readonly conversationId: ConversationId;
|
|
50
|
+
/** Why this version ran (absent on runs from before it was recorded). */
|
|
51
|
+
readonly via?: AgentVersionVia;
|
|
52
|
+
/** The pin that chose it, when `via` is `live`. */
|
|
53
|
+
readonly liveScope?: LiveScope;
|
|
50
54
|
}
|
|
51
55
|
/** Marks a run as a replay: an eval run re-running a past run (`of`). */
|
|
52
56
|
export interface RunReplayRef {
|
|
@@ -106,6 +110,11 @@ export interface RunFlowInput {
|
|
|
106
110
|
* is the flow version as published; the caller applies them to bind.
|
|
107
111
|
*/
|
|
108
112
|
readonly versions?: FlowVersionOverrides;
|
|
113
|
+
/**
|
|
114
|
+
* The run's segment path (ordered, coarse to fine), which picks live agent
|
|
115
|
+
* versions; a child run inherits its parent's.
|
|
116
|
+
*/
|
|
117
|
+
readonly segments?: readonly ScopeSegment[];
|
|
109
118
|
/**
|
|
110
119
|
* Run an existing `pending` row (created by `startRun`) instead of
|
|
111
120
|
* inserting a new one — how a caller hands back a run id before the
|
|
@@ -177,6 +186,8 @@ export interface StartRunParams {
|
|
|
177
186
|
readonly replay?: RunReplayRef;
|
|
178
187
|
/** The versions the run swaps in over its flow version's pins; see `RunFlowInput.versions`. */
|
|
179
188
|
readonly versions?: FlowVersionOverrides;
|
|
189
|
+
/** The run's segment path; see `RunFlowInput.segments`. */
|
|
190
|
+
readonly segments?: readonly ScopeSegment[];
|
|
180
191
|
}
|
|
181
192
|
export type StartRunError = {
|
|
182
193
|
readonly code: 'insert-failed';
|
package/dist/inputs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"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"}
|
package/dist/runs.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { FlowVersionOverrides } from '@kindgi/flow';
|
|
2
|
-
import type { Cursor, NodeId, OrgId, ProjectId, RunId, TenantId, Timestamp } from '@kindgi/types';
|
|
2
|
+
import type { Cursor, NodeId, OrgId, ProjectId, RunId, ScopeSegment, TenantId, Timestamp } from '@kindgi/types';
|
|
3
3
|
import type { RunAgentRef } from './inputs.js';
|
|
4
4
|
import type { RunStatus } from './types.js';
|
|
5
5
|
/**
|
|
@@ -39,6 +39,12 @@ export interface KernelRunRecord {
|
|
|
39
39
|
* (`RunFlowInput.versions`). Absent on a run that has none.
|
|
40
40
|
*/
|
|
41
41
|
readonly versions?: FlowVersionOverrides;
|
|
42
|
+
/**
|
|
43
|
+
* The segment path the run was started with (ordered, coarse to fine),
|
|
44
|
+
* which picks live agent versions: the run's own, and its agent steps'
|
|
45
|
+
* when it is a flow run. Absent when it was started without one.
|
|
46
|
+
*/
|
|
47
|
+
readonly segments?: readonly ScopeSegment[];
|
|
42
48
|
}
|
|
43
49
|
/**
|
|
44
50
|
* Content-scope filter for `RunBinding.listRuns`. Present-with-value
|
package/dist/runs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kindgi/runtime",
|
|
3
|
-
"version": "0.1.4-rc.
|
|
3
|
+
"version": "0.1.4-rc.3",
|
|
4
4
|
"description": "Kindgi™ runtime wire-vocabulary + binding interfaces. Public shape covering: RunStatus / RunResult / RunOptions / JournalEntry / JournalKind and all fanout/subgraph/iteration/step payload types; all kernel error shapes (KernelError, RunNotFoundError, HandlerMissingError, WaitpointError, etc.); run inputs and records (RunFlowInput / ResumeRunInput / StartRunParams, FlowResolver, HandlerResolver, ParentRunRef, KernelRunRecord, ListRunsInput); trigger schemas (Cron/Event/Webhook records + inputs + errors, plus TriggerRegistryBinding + RunFlowBinding + TRIGGER_KINDS); versioning envelope + wrap/unwrap; event-bus channel + KernelEventBusBinding; and the binding interfaces (RunBinding, SchedulerBinding, WaitpointBinding, RunRetentionBinding, umbrella KernelBinding) that deployments plug into `createApp`. Types + pure derivation functions — no runtime state, no dependency on a runtime implementation. The Kindgi runtime implements the bindings.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -28,10 +28,10 @@
|
|
|
28
28
|
"README.md"
|
|
29
29
|
],
|
|
30
30
|
"dependencies": {
|
|
31
|
-
"@kindgi/authz": "0.1.4-rc.
|
|
32
|
-
"@kindgi/flow": "0.1.4-rc.
|
|
33
|
-
"@kindgi/handler": "0.1.4-rc.
|
|
34
|
-
"@kindgi/types": "0.1.4-rc.
|
|
31
|
+
"@kindgi/authz": "0.1.4-rc.3",
|
|
32
|
+
"@kindgi/flow": "0.1.4-rc.3",
|
|
33
|
+
"@kindgi/handler": "0.1.4-rc.3",
|
|
34
|
+
"@kindgi/types": "0.1.4-rc.3"
|
|
35
35
|
},
|
|
36
36
|
"engines": {
|
|
37
37
|
"node": ">=22.12.0"
|
package/src/inputs.ts
CHANGED
|
@@ -4,7 +4,17 @@
|
|
|
4
4
|
import type { Principal } from '@kindgi/authz';
|
|
5
5
|
import type { Flow, FlowVersionOverrides } from '@kindgi/flow';
|
|
6
6
|
import type { HandlerRegistry } from '@kindgi/handler';
|
|
7
|
-
import type {
|
|
7
|
+
import type {
|
|
8
|
+
AgentVersionVia,
|
|
9
|
+
ConversationId,
|
|
10
|
+
LiveScope,
|
|
11
|
+
NodeId,
|
|
12
|
+
ProjectId,
|
|
13
|
+
Result,
|
|
14
|
+
RunId,
|
|
15
|
+
ScopeSegment,
|
|
16
|
+
TenantId,
|
|
17
|
+
} from '@kindgi/types';
|
|
8
18
|
|
|
9
19
|
import type { HandlerMissingError } from './errors.js';
|
|
10
20
|
import type { KernelEventBusBinding } from './event-bus.js';
|
|
@@ -54,6 +64,10 @@ export interface RunAgentRef {
|
|
|
54
64
|
readonly id: string;
|
|
55
65
|
readonly version: string;
|
|
56
66
|
readonly conversationId: ConversationId;
|
|
67
|
+
/** Why this version ran (absent on runs from before it was recorded). */
|
|
68
|
+
readonly via?: AgentVersionVia;
|
|
69
|
+
/** The pin that chose it, when `via` is `live`. */
|
|
70
|
+
readonly liveScope?: LiveScope;
|
|
57
71
|
}
|
|
58
72
|
|
|
59
73
|
/** Marks a run as a replay: an eval run re-running a past run (`of`). */
|
|
@@ -116,6 +130,11 @@ export interface RunFlowInput {
|
|
|
116
130
|
* is the flow version as published; the caller applies them to bind.
|
|
117
131
|
*/
|
|
118
132
|
readonly versions?: FlowVersionOverrides;
|
|
133
|
+
/**
|
|
134
|
+
* The run's segment path (ordered, coarse to fine), which picks live agent
|
|
135
|
+
* versions; a child run inherits its parent's.
|
|
136
|
+
*/
|
|
137
|
+
readonly segments?: readonly ScopeSegment[];
|
|
119
138
|
/**
|
|
120
139
|
* Run an existing `pending` row (created by `startRun`) instead of
|
|
121
140
|
* inserting a new one — how a caller hands back a run id before the
|
|
@@ -189,6 +208,8 @@ export interface StartRunParams {
|
|
|
189
208
|
readonly replay?: RunReplayRef;
|
|
190
209
|
/** The versions the run swaps in over its flow version's pins; see `RunFlowInput.versions`. */
|
|
191
210
|
readonly versions?: FlowVersionOverrides;
|
|
211
|
+
/** The run's segment path; see `RunFlowInput.segments`. */
|
|
212
|
+
readonly segments?: readonly ScopeSegment[];
|
|
192
213
|
}
|
|
193
214
|
|
|
194
215
|
export type StartRunError = { readonly code: 'insert-failed'; readonly message: string };
|
package/src/runs.ts
CHANGED
|
@@ -9,7 +9,16 @@
|
|
|
9
9
|
//
|
|
10
10
|
|
|
11
11
|
import type { FlowVersionOverrides } from '@kindgi/flow';
|
|
12
|
-
import type {
|
|
12
|
+
import type {
|
|
13
|
+
Cursor,
|
|
14
|
+
NodeId,
|
|
15
|
+
OrgId,
|
|
16
|
+
ProjectId,
|
|
17
|
+
RunId,
|
|
18
|
+
ScopeSegment,
|
|
19
|
+
TenantId,
|
|
20
|
+
Timestamp,
|
|
21
|
+
} from '@kindgi/types';
|
|
13
22
|
|
|
14
23
|
import type { RunAgentRef } from './inputs.js';
|
|
15
24
|
import type { RunStatus } from './types.js';
|
|
@@ -51,6 +60,12 @@ export interface KernelRunRecord {
|
|
|
51
60
|
* (`RunFlowInput.versions`). Absent on a run that has none.
|
|
52
61
|
*/
|
|
53
62
|
readonly versions?: FlowVersionOverrides;
|
|
63
|
+
/**
|
|
64
|
+
* The segment path the run was started with (ordered, coarse to fine),
|
|
65
|
+
* which picks live agent versions: the run's own, and its agent steps'
|
|
66
|
+
* when it is a flow run. Absent when it was started without one.
|
|
67
|
+
*/
|
|
68
|
+
readonly segments?: readonly ScopeSegment[];
|
|
54
69
|
}
|
|
55
70
|
|
|
56
71
|
/**
|