@ai-matrx/agents 0.59.151 → 0.59.152
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/CHANGELOG.md +11 -1
- package/README.md +3 -3
- package/dist/catalog/index.cjs +7 -7
- package/dist/catalog/index.d.cts +28 -28
- package/dist/catalog/index.d.ts +28 -28
- package/dist/catalog/index.js +7 -7
- package/dist/catalog/native/index.cjs +1 -1
- package/dist/catalog/native/index.d.cts +16 -16
- package/dist/catalog/native/index.d.ts +16 -16
- package/dist/catalog/native/index.js +1 -1
- package/dist/catalog/react/index.cjs +1 -1
- package/dist/catalog/react/index.d.cts +9 -9
- package/dist/catalog/react/index.d.ts +9 -9
- package/dist/catalog/react/index.js +1 -1
- package/dist/catalog/styles.css +5 -5
- package/dist/content-transfer/index.cjs +2 -2
- package/dist/content-transfer/index.js +2 -2
- package/dist/content-transfer/react/index.cjs +2 -2
- package/dist/content-transfer/react/index.js +2 -2
- package/dist/context/react/index.d.cts +3 -3
- package/dist/context/react/index.d.ts +3 -3
- package/dist/index.cjs +3 -3
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +3 -3
- package/dist/mandates/index.cjs +2 -2
- package/dist/mandates/index.d.cts +4 -4
- package/dist/mandates/index.d.ts +4 -4
- package/dist/mandates/index.js +2 -2
- package/dist/mandates/runs.d.cts +1 -1
- package/dist/mandates/runs.d.ts +1 -1
- package/dist/models/index.d.cts +2 -2
- package/dist/models/index.d.ts +2 -2
- package/dist/models/react/index.cjs +1 -1
- package/dist/models/react/index.js +1 -1
- package/dist/quick/index.d.cts +5 -5
- package/dist/quick/index.d.ts +5 -5
- package/dist/settings/index.d.cts +8 -8
- package/dist/settings/index.d.ts +8 -8
- package/dist/skills/index.d.cts +1 -1
- package/dist/skills/index.d.ts +1 -1
- package/dist/skills/react/index.d.cts +1 -1
- package/dist/skills/react/index.d.ts +1 -1
- package/dist/sources/index.d.cts +1 -1
- package/dist/sources/index.d.ts +1 -1
- package/dist/sources/runtime/index.d.cts +2 -2
- package/dist/sources/runtime/index.d.ts +2 -2
- package/dist/tools/index.d.cts +6 -6
- package/dist/tools/index.d.ts +6 -6
- package/package.json +4 -4
package/dist/index.d.ts
CHANGED
|
@@ -16,7 +16,7 @@ export { DEFAULT_WORKFLOW_PROJECTION_LIMITS, WorkflowNodeProjection, WorkflowNod
|
|
|
16
16
|
* = a plain image the model sees. The server owns the wire mapping and the
|
|
17
17
|
* refusal gate (aidream `matrx_ai/media/image_reference_roles.py`); this module
|
|
18
18
|
* mirrors its vocabulary and limits so the builder can tell the truth BEFORE a
|
|
19
|
-
* run: a role the selected model cannot take is shown
|
|
19
|
+
* run: a role the selected model cannot take is shown grayed with the reason.
|
|
20
20
|
*
|
|
21
21
|
* Limits come from the catalog: the routing offering's
|
|
22
22
|
* `capabilities_override.image_reference_roles` (`{role: max, total: n}`).
|
|
@@ -162,7 +162,7 @@ declare function orderVariablesForForm<T extends RunInputVariable>(defs: T[]): T
|
|
|
162
162
|
declare function variableRunLabel(variable: RunInputVariable, formatName?: (name: string) => string): string;
|
|
163
163
|
/** The hint under / beside a variable: its own help text, else the role's line. */
|
|
164
164
|
declare function variableRunHint(variable: RunInputVariable): string | undefined;
|
|
165
|
-
/** Derive the ordered, grouped,
|
|
165
|
+
/** Derive the ordered, grouped, labeled run inputs for an agent's variables. */
|
|
166
166
|
declare function deriveRunInputs<V extends RunInputVariable>(defs: readonly V[] | null | undefined, formatName?: (name: string) => string): RunInput<V>[];
|
|
167
167
|
|
|
168
168
|
export { AUDIO_REFERENCE_ROLES, type AudioReferenceRole, IMAGE_REFERENCE_ROLES, IMAGE_ROLE_META, type ImageReferenceRole, type ImageRoleLimits, type ImageRoleMeta, type ImageRoleVerdict, type ReferenceRole, type RunInput, type RunInputGroup, type RunInputMediaKind, type RunInputVariable, VIDEO_IMAGE_ROLES, VIDEO_REFERENCE_ROLES, type VideoReferenceRole, deriveRunInputs, imageRoleVerdict, isControlVariable, isImageReferenceRole, isReferenceRole, namedReferenceVerdict, normalizeReferenceName, orderVariablesForForm, partitionControlVariables, readImageRoleLimits, referenceRoleCaption, roleTakesName, rolesFor, variableNameOfImageUrl, variableNameOfMediaUrl, variableRunHint, variableRunLabel };
|
package/dist/index.js
CHANGED
|
@@ -530,7 +530,7 @@ var IMAGE_ROLE_META = {
|
|
|
530
530
|
subject: {
|
|
531
531
|
label: "Subject",
|
|
532
532
|
ask: "Subject reference",
|
|
533
|
-
explanation: "Keeps this exact product or object
|
|
533
|
+
explanation: "Keeps this exact product or object recognizable: shape, materials, labels."
|
|
534
534
|
},
|
|
535
535
|
character: {
|
|
536
536
|
label: "Character",
|
|
@@ -540,7 +540,7 @@ var IMAGE_ROLE_META = {
|
|
|
540
540
|
style: {
|
|
541
541
|
label: "Style",
|
|
542
542
|
ask: "Style reference",
|
|
543
|
-
explanation: "Borrows only the look (
|
|
543
|
+
explanation: "Borrows only the look (colors, lighting, medium), never the content."
|
|
544
544
|
},
|
|
545
545
|
mask: {
|
|
546
546
|
label: "Mask",
|
|
@@ -570,7 +570,7 @@ var IMAGE_ROLE_META = {
|
|
|
570
570
|
asset: {
|
|
571
571
|
label: "Asset",
|
|
572
572
|
ask: "Asset reference",
|
|
573
|
-
explanation: "Keeps this product, object or character
|
|
573
|
+
explanation: "Keeps this product, object or character recognizable throughout the clip."
|
|
574
574
|
},
|
|
575
575
|
extend: {
|
|
576
576
|
label: "Extend",
|
package/dist/mandates/index.cjs
CHANGED
|
@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
|
|
|
47
47
|
|
|
48
48
|
// mandates/keys.generated.ts
|
|
49
49
|
var MANDATE_KEYS_META = {
|
|
50
|
-
aidreamRevision: "
|
|
50
|
+
aidreamRevision: "c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5",
|
|
51
51
|
generatorVersion: "1.0.0",
|
|
52
|
-
packageVersion: "0.59.
|
|
52
|
+
packageVersion: "0.59.152",
|
|
53
53
|
retireWindow: 3
|
|
54
54
|
};
|
|
55
55
|
var MANDATE_KEYS = {
|
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
* from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
|
|
7
7
|
* boot sync writes to the database from. There is no hand list anywhere.
|
|
8
8
|
*
|
|
9
|
-
* aidream revision:
|
|
9
|
+
* aidream revision: c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5
|
|
10
10
|
* generator version: 1.0.0
|
|
11
|
-
* package version: 0.59.
|
|
11
|
+
* package version: 0.59.152
|
|
12
12
|
* active keys: 602
|
|
13
13
|
* retiring keys: 3
|
|
14
14
|
*
|
|
@@ -19,9 +19,9 @@
|
|
|
19
19
|
*/
|
|
20
20
|
/** Where this module came from — surfaced so a report can name the exact build. */
|
|
21
21
|
declare const MANDATE_KEYS_META: {
|
|
22
|
-
readonly aidreamRevision: "
|
|
22
|
+
readonly aidreamRevision: "c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5";
|
|
23
23
|
readonly generatorVersion: "1.0.0";
|
|
24
|
-
readonly packageVersion: "0.59.
|
|
24
|
+
readonly packageVersion: "0.59.152";
|
|
25
25
|
readonly retireWindow: 3;
|
|
26
26
|
};
|
|
27
27
|
/** Every declared mandate key, by THE IDENTIFIER RULE. */
|
package/dist/mandates/index.d.ts
CHANGED
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
* from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
|
|
7
7
|
* boot sync writes to the database from. There is no hand list anywhere.
|
|
8
8
|
*
|
|
9
|
-
* aidream revision:
|
|
9
|
+
* aidream revision: c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5
|
|
10
10
|
* generator version: 1.0.0
|
|
11
|
-
* package version: 0.59.
|
|
11
|
+
* package version: 0.59.152
|
|
12
12
|
* active keys: 602
|
|
13
13
|
* retiring keys: 3
|
|
14
14
|
*
|
|
@@ -19,9 +19,9 @@
|
|
|
19
19
|
*/
|
|
20
20
|
/** Where this module came from — surfaced so a report can name the exact build. */
|
|
21
21
|
declare const MANDATE_KEYS_META: {
|
|
22
|
-
readonly aidreamRevision: "
|
|
22
|
+
readonly aidreamRevision: "c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5";
|
|
23
23
|
readonly generatorVersion: "1.0.0";
|
|
24
|
-
readonly packageVersion: "0.59.
|
|
24
|
+
readonly packageVersion: "0.59.152";
|
|
25
25
|
readonly retireWindow: 3;
|
|
26
26
|
};
|
|
27
27
|
/** Every declared mandate key, by THE IDENTIFIER RULE. */
|
package/dist/mandates/index.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
// mandates/keys.generated.ts
|
|
2
2
|
var MANDATE_KEYS_META = {
|
|
3
|
-
aidreamRevision: "
|
|
3
|
+
aidreamRevision: "c1a12e82cd05e1a4c0835cd6af40c1ac59a641f5",
|
|
4
4
|
generatorVersion: "1.0.0",
|
|
5
|
-
packageVersion: "0.59.
|
|
5
|
+
packageVersion: "0.59.152",
|
|
6
6
|
retireWindow: 3
|
|
7
7
|
};
|
|
8
8
|
var MANDATE_KEYS = {
|
package/dist/mandates/runs.d.cts
CHANGED
|
@@ -24,7 +24,7 @@ type RunRung = "system" | "org" | "user" | "run";
|
|
|
24
24
|
type RunSort = "started_at" | "duration" | "cost" | "status" | "level";
|
|
25
25
|
declare const RUN_STATUSES: readonly RunStatus[];
|
|
26
26
|
interface MandateRun {
|
|
27
|
-
/** `agent_run` = an agent run
|
|
27
|
+
/** `agent_run` = an agent run labeled with the mandate that kept no conversation. */
|
|
28
28
|
runKind: "conversation" | "workflow" | "agent_run";
|
|
29
29
|
runId: string;
|
|
30
30
|
startedAt: string;
|
package/dist/mandates/runs.d.ts
CHANGED
|
@@ -24,7 +24,7 @@ type RunRung = "system" | "org" | "user" | "run";
|
|
|
24
24
|
type RunSort = "started_at" | "duration" | "cost" | "status" | "level";
|
|
25
25
|
declare const RUN_STATUSES: readonly RunStatus[];
|
|
26
26
|
interface MandateRun {
|
|
27
|
-
/** `agent_run` = an agent run
|
|
27
|
+
/** `agent_run` = an agent run labeled with the mandate that kept no conversation. */
|
|
28
28
|
runKind: "conversation" | "workflow" | "agent_run";
|
|
29
29
|
runId: string;
|
|
30
30
|
startedAt: string;
|
package/dist/models/index.d.cts
CHANGED
|
@@ -1060,7 +1060,7 @@ interface HardwareClasses {
|
|
|
1060
1060
|
declare function normalizeArch(arch: string | null | undefined): "arm64" | "x86_64" | null;
|
|
1061
1061
|
/** The catalog's os names (`darwin`, `linux`, `windows`); Node's `win32` maps to `windows`. */
|
|
1062
1062
|
declare function normalizeOs(os: string | null | undefined): string | null;
|
|
1063
|
-
/** The device's hardware classes, best first (design §1.6). Missing facts ⇒ the processor class,
|
|
1063
|
+
/** The device's hardware classes, best first (design §1.6). Missing facts ⇒ the processor class, labeled. */
|
|
1064
1064
|
declare function hardwareClassesOf(hw: DeviceHardware | null | undefined): HardwareClasses;
|
|
1065
1065
|
/** Whether `memoryBytes` fits `totalMemoryBytes × fitFraction`. Null when either side is unknown ("not measured", never a pass). */
|
|
1066
1066
|
declare function fitsMemory(memoryBytes: number | null, totalMemoryBytes: number | null, fitFraction: number): boolean | null;
|
|
@@ -1120,7 +1120,7 @@ interface NoSelection {
|
|
|
1120
1120
|
/** The files of a variant a device fetches for these uses: every `core` file plus any whose uses overlap. Optional files (empty required_for) never. */
|
|
1121
1121
|
declare function requiredArtifacts(variant: LocalVariant, uses: readonly ArtifactUse[]): LocalArtifact[];
|
|
1122
1122
|
/**
|
|
1123
|
-
* Memory as the computer's own settings show it: binary gigabytes (2^30 bytes),
|
|
1123
|
+
* Memory as the computer's own settings show it: binary gigabytes (2^30 bytes), labeled GB the way
|
|
1124
1124
|
* macOS, Windows and Linux label installed memory. One unit for every memory figure a screen shows —
|
|
1125
1125
|
* a reason line in decimal GB beside a stats strip in binary GB read as two different memories.
|
|
1126
1126
|
*/
|
package/dist/models/index.d.ts
CHANGED
|
@@ -1060,7 +1060,7 @@ interface HardwareClasses {
|
|
|
1060
1060
|
declare function normalizeArch(arch: string | null | undefined): "arm64" | "x86_64" | null;
|
|
1061
1061
|
/** The catalog's os names (`darwin`, `linux`, `windows`); Node's `win32` maps to `windows`. */
|
|
1062
1062
|
declare function normalizeOs(os: string | null | undefined): string | null;
|
|
1063
|
-
/** The device's hardware classes, best first (design §1.6). Missing facts ⇒ the processor class,
|
|
1063
|
+
/** The device's hardware classes, best first (design §1.6). Missing facts ⇒ the processor class, labeled. */
|
|
1064
1064
|
declare function hardwareClassesOf(hw: DeviceHardware | null | undefined): HardwareClasses;
|
|
1065
1065
|
/** Whether `memoryBytes` fits `totalMemoryBytes × fitFraction`. Null when either side is unknown ("not measured", never a pass). */
|
|
1066
1066
|
declare function fitsMemory(memoryBytes: number | null, totalMemoryBytes: number | null, fitFraction: number): boolean | null;
|
|
@@ -1120,7 +1120,7 @@ interface NoSelection {
|
|
|
1120
1120
|
/** The files of a variant a device fetches for these uses: every `core` file plus any whose uses overlap. Optional files (empty required_for) never. */
|
|
1121
1121
|
declare function requiredArtifacts(variant: LocalVariant, uses: readonly ArtifactUse[]): LocalArtifact[];
|
|
1122
1122
|
/**
|
|
1123
|
-
* Memory as the computer's own settings show it: binary gigabytes (2^30 bytes),
|
|
1123
|
+
* Memory as the computer's own settings show it: binary gigabytes (2^30 bytes), labeled GB the way
|
|
1124
1124
|
* macOS, Windows and Linux label installed memory. One unit for every memory figure a screen shows —
|
|
1125
1125
|
* a reason line in decimal GB beside a stats strip in binary GB read as two different memories.
|
|
1126
1126
|
*/
|
|
@@ -205,7 +205,7 @@ var SHAPES = {
|
|
|
205
205
|
/**
|
|
206
206
|
* THE ARCHIVE GLYPH (Lucide `archive`) — the ONE mark of the platform
|
|
207
207
|
* archive filter, drawn identically in every Matrx client so the control a
|
|
208
|
-
* person learns on one surface is
|
|
208
|
+
* person learns on one surface is recognizable on all of them.
|
|
209
209
|
*/
|
|
210
210
|
archive: {
|
|
211
211
|
paths: [
|
|
@@ -187,7 +187,7 @@ var SHAPES = {
|
|
|
187
187
|
/**
|
|
188
188
|
* THE ARCHIVE GLYPH (Lucide `archive`) — the ONE mark of the platform
|
|
189
189
|
* archive filter, drawn identically in every Matrx client so the control a
|
|
190
|
-
* person learns on one surface is
|
|
190
|
+
* person learns on one surface is recognizable on all of them.
|
|
191
191
|
*/
|
|
192
192
|
archive: {
|
|
193
193
|
paths: [
|
package/dist/quick/index.d.cts
CHANGED
|
@@ -5,17 +5,17 @@ import { A as AgentSummary } from '../types-DZhDqrVE.cjs';
|
|
|
5
5
|
*
|
|
6
6
|
* A quick agent is a named bundle of exactly: name, system prompt, model and three settings
|
|
7
7
|
* (temperature, top-p, max output tokens). It is an ordinary `agent.definition` row — one agent
|
|
8
|
-
* table, one permission model, no second prompt store — marked `kind: quick` so the big
|
|
8
|
+
* table, one permission model, no second prompt store — marked `kind: quick` so the big catalog
|
|
9
9
|
* can hide or group it. This entry owns the shape and the pure builders/selectors; `./writes`
|
|
10
10
|
* owns the four database calls (the one named write allowlist entry of this package).
|
|
11
11
|
*
|
|
12
12
|
* The marker lives in two places on purpose: `metadata.kind = "quick"` is the record's own
|
|
13
|
-
* statement; the `kind:quick` tag rides every
|
|
13
|
+
* statement; the `kind:quick` tag rides every catalog row (the catalog read carries tags, not
|
|
14
14
|
* metadata), so a list can filter without a second read — exactly how `chat-agent` marks presets.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
declare const QUICK_AGENT_KIND: "quick";
|
|
18
|
-
/** The tag every quick agent carries; the
|
|
18
|
+
/** The tag every quick agent carries; the catalog row's way to say `kind: quick`. */
|
|
19
19
|
declare const QUICK_AGENT_TAG: "kind:quick";
|
|
20
20
|
/** The three minor settings — nothing else is ever part of a quick agent. */
|
|
21
21
|
interface QuickAgentSettings {
|
|
@@ -77,7 +77,7 @@ declare function buildQuickAgentUpdate(def: QuickAgentDefinition): Record<string
|
|
|
77
77
|
declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined): QuickAgent | null;
|
|
78
78
|
declare function isQuickAgentSummary(row: Pick<AgentSummary, "tags">): boolean;
|
|
79
79
|
/**
|
|
80
|
-
* THE PERSONAL LIST: the person's own, live quick agents out of the ONE
|
|
80
|
+
* THE PERSONAL LIST: the person's own, live quick agents out of the ONE catalog read.
|
|
81
81
|
* (Org and system lanes are the catalogue's own tabs; this is "mine".)
|
|
82
82
|
*/
|
|
83
83
|
declare function listMyQuickAgents(rows: readonly AgentSummary[], userId: string | null): AgentSummary[];
|
|
@@ -102,7 +102,7 @@ declare function createQuickAgent(client: QuickAgentClient, def: QuickAgentDefin
|
|
|
102
102
|
declare function updateQuickAgent(client: QuickAgentClient, id: string, def: QuickAgentDefinition): Promise<QuickAgent>;
|
|
103
103
|
/** Soft delete — the same `deleted_at` every agent delete sets, so every list already hides it. */
|
|
104
104
|
declare function deleteQuickAgent(client: QuickAgentClient, id: string): Promise<void>;
|
|
105
|
-
/** One quick agent's full definition (the
|
|
105
|
+
/** One quick agent's full definition (the catalog row carries no prompt). */
|
|
106
106
|
declare function readQuickAgent(client: QuickAgentClient, id: string): Promise<QuickAgent | null>;
|
|
107
107
|
|
|
108
108
|
export { QUICK_AGENT_BOUNDS, QUICK_AGENT_DEFAULT_SETTINGS, QUICK_AGENT_KIND, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentSettings, type QuickAgentSystemMessage, buildQuickAgentRow, buildQuickAgentUpdate, clampQuickAgentSettings, createQuickAgent, deleteQuickAgent, isQuickAgentSummary, listMyQuickAgents, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, updateQuickAgent, withoutQuickAgents };
|
package/dist/quick/index.d.ts
CHANGED
|
@@ -5,17 +5,17 @@ import { A as AgentSummary } from '../types-DZhDqrVE.js';
|
|
|
5
5
|
*
|
|
6
6
|
* A quick agent is a named bundle of exactly: name, system prompt, model and three settings
|
|
7
7
|
* (temperature, top-p, max output tokens). It is an ordinary `agent.definition` row — one agent
|
|
8
|
-
* table, one permission model, no second prompt store — marked `kind: quick` so the big
|
|
8
|
+
* table, one permission model, no second prompt store — marked `kind: quick` so the big catalog
|
|
9
9
|
* can hide or group it. This entry owns the shape and the pure builders/selectors; `./writes`
|
|
10
10
|
* owns the four database calls (the one named write allowlist entry of this package).
|
|
11
11
|
*
|
|
12
12
|
* The marker lives in two places on purpose: `metadata.kind = "quick"` is the record's own
|
|
13
|
-
* statement; the `kind:quick` tag rides every
|
|
13
|
+
* statement; the `kind:quick` tag rides every catalog row (the catalog read carries tags, not
|
|
14
14
|
* metadata), so a list can filter without a second read — exactly how `chat-agent` marks presets.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
declare const QUICK_AGENT_KIND: "quick";
|
|
18
|
-
/** The tag every quick agent carries; the
|
|
18
|
+
/** The tag every quick agent carries; the catalog row's way to say `kind: quick`. */
|
|
19
19
|
declare const QUICK_AGENT_TAG: "kind:quick";
|
|
20
20
|
/** The three minor settings — nothing else is ever part of a quick agent. */
|
|
21
21
|
interface QuickAgentSettings {
|
|
@@ -77,7 +77,7 @@ declare function buildQuickAgentUpdate(def: QuickAgentDefinition): Record<string
|
|
|
77
77
|
declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined): QuickAgent | null;
|
|
78
78
|
declare function isQuickAgentSummary(row: Pick<AgentSummary, "tags">): boolean;
|
|
79
79
|
/**
|
|
80
|
-
* THE PERSONAL LIST: the person's own, live quick agents out of the ONE
|
|
80
|
+
* THE PERSONAL LIST: the person's own, live quick agents out of the ONE catalog read.
|
|
81
81
|
* (Org and system lanes are the catalogue's own tabs; this is "mine".)
|
|
82
82
|
*/
|
|
83
83
|
declare function listMyQuickAgents(rows: readonly AgentSummary[], userId: string | null): AgentSummary[];
|
|
@@ -102,7 +102,7 @@ declare function createQuickAgent(client: QuickAgentClient, def: QuickAgentDefin
|
|
|
102
102
|
declare function updateQuickAgent(client: QuickAgentClient, id: string, def: QuickAgentDefinition): Promise<QuickAgent>;
|
|
103
103
|
/** Soft delete — the same `deleted_at` every agent delete sets, so every list already hides it. */
|
|
104
104
|
declare function deleteQuickAgent(client: QuickAgentClient, id: string): Promise<void>;
|
|
105
|
-
/** One quick agent's full definition (the
|
|
105
|
+
/** One quick agent's full definition (the catalog row carries no prompt). */
|
|
106
106
|
declare function readQuickAgent(client: QuickAgentClient, id: string): Promise<QuickAgent | null>;
|
|
107
107
|
|
|
108
108
|
export { QUICK_AGENT_BOUNDS, QUICK_AGENT_DEFAULT_SETTINGS, QUICK_AGENT_KIND, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentSettings, type QuickAgentSystemMessage, buildQuickAgentRow, buildQuickAgentUpdate, clampQuickAgentSettings, createQuickAgent, deleteQuickAgent, isQuickAgentSummary, listMyQuickAgents, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, updateQuickAgent, withoutQuickAgents };
|
|
@@ -166,13 +166,13 @@ declare const EMPTY_UI_GATES: UiGates;
|
|
|
166
166
|
declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey): boolean;
|
|
167
167
|
|
|
168
168
|
/**
|
|
169
|
-
* Model Settings
|
|
169
|
+
* Model Settings Catalog — the single source of truth for the STANDARD
|
|
170
170
|
* settings list, and the one chokepoint that decides which keys it contains.
|
|
171
171
|
*
|
|
172
172
|
* ── The model (two distinct surfaces) ────────────────────────────────────────
|
|
173
173
|
* 1. STANDARD list — ONLY the keys the selected model explicitly declares in
|
|
174
174
|
* its `controls` config (i.e. the parameters this model actually supports).
|
|
175
|
-
* `buildSettingsRows()` returns exactly these, grouped + ordered.
|
|
175
|
+
* `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
|
|
176
176
|
* keys the model does not declare are NOT shown here.
|
|
177
177
|
* 2. CAUTION surface — settings the agent has SET that the model does NOT
|
|
178
178
|
* support. These are never hidden: they are flagged as "not valid for this
|
|
@@ -180,7 +180,7 @@ declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey):
|
|
|
180
180
|
* by the `unsupported_by_model` rule). They do NOT belong in the standard
|
|
181
181
|
* list — that is exactly the "showing all possible keys" bug.
|
|
182
182
|
*
|
|
183
|
-
* The
|
|
183
|
+
* The catalog exists so the standard list's labels, grouping and order live
|
|
184
184
|
* in ONE place (previously copy-pasted as `textModelSettings` /
|
|
185
185
|
* `booleanSettings` / ... into three components, each filtering by
|
|
186
186
|
* `getControl(key)` inline — which drifted and regressed). Components map over
|
|
@@ -190,7 +190,7 @@ declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey):
|
|
|
190
190
|
* every key into the standard list.
|
|
191
191
|
*
|
|
192
192
|
* Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
|
|
193
|
-
* ONLY supported keys (never the full
|
|
193
|
+
* ONLY supported keys (never the full catalog), and `unsupported-by-model.
|
|
194
194
|
* test.ts` asserts set-but-unsupported keys surface in the caution layer.
|
|
195
195
|
*/
|
|
196
196
|
|
|
@@ -206,7 +206,7 @@ interface CatalogueGroup {
|
|
|
206
206
|
entries: CatalogueEntry[];
|
|
207
207
|
}
|
|
208
208
|
declare const SETTINGS_CATALOGUE: CatalogueGroup[];
|
|
209
|
-
/** Flat set of every key the
|
|
209
|
+
/** Flat set of every key the catalog declares. */
|
|
210
210
|
declare const CATALOGUE_KEYS: ReadonlySet<string>;
|
|
211
211
|
interface SettingsRow {
|
|
212
212
|
key: string;
|
|
@@ -233,12 +233,12 @@ type ControlsLike = Record<string, unknown> | null | undefined;
|
|
|
233
233
|
* Build the STANDARD settings list for the selected model.
|
|
234
234
|
*
|
|
235
235
|
* CONTRACT: returns ONLY keys the model declares a control for (supported).
|
|
236
|
-
*
|
|
236
|
+
* Catalog keys the model does not declare are omitted — they are not "shown"
|
|
237
237
|
* in the standard list. Set-but-unsupported keys are NOT returned here either;
|
|
238
238
|
* the caution layer (validation IssueTable) surfaces and repairs those.
|
|
239
239
|
*
|
|
240
240
|
* The catch-all "Other" group carries supported keys the model declares that
|
|
241
|
-
* the
|
|
241
|
+
* the catalog doesn't name yet — so a brand-new model control still appears
|
|
242
242
|
* without a code change. Empty groups are returned (consumers skip them).
|
|
243
243
|
*/
|
|
244
244
|
declare function buildSettingsRows(controls: ControlsLike, settings: Record<string, unknown> | null | undefined): RenderGroup[];
|
|
@@ -328,7 +328,7 @@ declare function getActionForMode(mode: ResolutionMode, conflict: ConflictItem,
|
|
|
328
328
|
* was inexpressible — the default (e.g. the agent's class pin `offering_id`)
|
|
329
329
|
* silently came back on the next merge and on the wire. `null` = "the API must
|
|
330
330
|
* not use this key"; `mergeEffectiveSettings` deletes it, `buildApiPayload`
|
|
331
|
-
* sends it (the server
|
|
331
|
+
* sends it (the server honors `offering_id: null`).
|
|
332
332
|
*/
|
|
333
333
|
declare function computeOverrideDiff(defaults: Partial<AgentSettings>, proposed: Partial<AgentSettings>): Partial<AgentSettings>;
|
|
334
334
|
/**
|
package/dist/settings/index.d.ts
CHANGED
|
@@ -166,13 +166,13 @@ declare const EMPTY_UI_GATES: UiGates;
|
|
|
166
166
|
declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey): boolean;
|
|
167
167
|
|
|
168
168
|
/**
|
|
169
|
-
* Model Settings
|
|
169
|
+
* Model Settings Catalog — the single source of truth for the STANDARD
|
|
170
170
|
* settings list, and the one chokepoint that decides which keys it contains.
|
|
171
171
|
*
|
|
172
172
|
* ── The model (two distinct surfaces) ────────────────────────────────────────
|
|
173
173
|
* 1. STANDARD list — ONLY the keys the selected model explicitly declares in
|
|
174
174
|
* its `controls` config (i.e. the parameters this model actually supports).
|
|
175
|
-
* `buildSettingsRows()` returns exactly these, grouped + ordered.
|
|
175
|
+
* `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
|
|
176
176
|
* keys the model does not declare are NOT shown here.
|
|
177
177
|
* 2. CAUTION surface — settings the agent has SET that the model does NOT
|
|
178
178
|
* support. These are never hidden: they are flagged as "not valid for this
|
|
@@ -180,7 +180,7 @@ declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey):
|
|
|
180
180
|
* by the `unsupported_by_model` rule). They do NOT belong in the standard
|
|
181
181
|
* list — that is exactly the "showing all possible keys" bug.
|
|
182
182
|
*
|
|
183
|
-
* The
|
|
183
|
+
* The catalog exists so the standard list's labels, grouping and order live
|
|
184
184
|
* in ONE place (previously copy-pasted as `textModelSettings` /
|
|
185
185
|
* `booleanSettings` / ... into three components, each filtering by
|
|
186
186
|
* `getControl(key)` inline — which drifted and regressed). Components map over
|
|
@@ -190,7 +190,7 @@ declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey):
|
|
|
190
190
|
* every key into the standard list.
|
|
191
191
|
*
|
|
192
192
|
* Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
|
|
193
|
-
* ONLY supported keys (never the full
|
|
193
|
+
* ONLY supported keys (never the full catalog), and `unsupported-by-model.
|
|
194
194
|
* test.ts` asserts set-but-unsupported keys surface in the caution layer.
|
|
195
195
|
*/
|
|
196
196
|
|
|
@@ -206,7 +206,7 @@ interface CatalogueGroup {
|
|
|
206
206
|
entries: CatalogueEntry[];
|
|
207
207
|
}
|
|
208
208
|
declare const SETTINGS_CATALOGUE: CatalogueGroup[];
|
|
209
|
-
/** Flat set of every key the
|
|
209
|
+
/** Flat set of every key the catalog declares. */
|
|
210
210
|
declare const CATALOGUE_KEYS: ReadonlySet<string>;
|
|
211
211
|
interface SettingsRow {
|
|
212
212
|
key: string;
|
|
@@ -233,12 +233,12 @@ type ControlsLike = Record<string, unknown> | null | undefined;
|
|
|
233
233
|
* Build the STANDARD settings list for the selected model.
|
|
234
234
|
*
|
|
235
235
|
* CONTRACT: returns ONLY keys the model declares a control for (supported).
|
|
236
|
-
*
|
|
236
|
+
* Catalog keys the model does not declare are omitted — they are not "shown"
|
|
237
237
|
* in the standard list. Set-but-unsupported keys are NOT returned here either;
|
|
238
238
|
* the caution layer (validation IssueTable) surfaces and repairs those.
|
|
239
239
|
*
|
|
240
240
|
* The catch-all "Other" group carries supported keys the model declares that
|
|
241
|
-
* the
|
|
241
|
+
* the catalog doesn't name yet — so a brand-new model control still appears
|
|
242
242
|
* without a code change. Empty groups are returned (consumers skip them).
|
|
243
243
|
*/
|
|
244
244
|
declare function buildSettingsRows(controls: ControlsLike, settings: Record<string, unknown> | null | undefined): RenderGroup[];
|
|
@@ -328,7 +328,7 @@ declare function getActionForMode(mode: ResolutionMode, conflict: ConflictItem,
|
|
|
328
328
|
* was inexpressible — the default (e.g. the agent's class pin `offering_id`)
|
|
329
329
|
* silently came back on the next merge and on the wire. `null` = "the API must
|
|
330
330
|
* not use this key"; `mergeEffectiveSettings` deletes it, `buildApiPayload`
|
|
331
|
-
* sends it (the server
|
|
331
|
+
* sends it (the server honors `offering_id: null`).
|
|
332
332
|
*/
|
|
333
333
|
declare function computeOverrideDiff(defaults: Partial<AgentSettings>, proposed: Partial<AgentSettings>): Partial<AgentSettings>;
|
|
334
334
|
/**
|
package/dist/skills/index.d.cts
CHANGED
|
@@ -244,7 +244,7 @@ interface SkillConfig {
|
|
|
244
244
|
* implicit DEFAULT bucket). */
|
|
245
245
|
type SkillTier = "included" | "listed" | "forbidden" | "default";
|
|
246
246
|
/** Free-string per the wire contract, but these are the recognized values
|
|
247
|
-
* for filtering /
|
|
247
|
+
* for filtering / labeling. */
|
|
248
248
|
type SkillType = "render_block" | "convention" | "workflow" | "task" | "reference" | "mode" | "agent_behavior" | string;
|
|
249
249
|
/** Local form draft used while a skill is being edited / created. Mirrors
|
|
250
250
|
* SkillRow but the immutable identity fields collapse to single optional
|
package/dist/skills/index.d.ts
CHANGED
|
@@ -244,7 +244,7 @@ interface SkillConfig {
|
|
|
244
244
|
* implicit DEFAULT bucket). */
|
|
245
245
|
type SkillTier = "included" | "listed" | "forbidden" | "default";
|
|
246
246
|
/** Free-string per the wire contract, but these are the recognized values
|
|
247
|
-
* for filtering /
|
|
247
|
+
* for filtering / labeling. */
|
|
248
248
|
type SkillType = "render_block" | "convention" | "workflow" | "task" | "reference" | "mode" | "agent_behavior" | string;
|
|
249
249
|
/** Local form draft used while a skill is being edited / created. Mirrors
|
|
250
250
|
* SkillRow but the immutable identity fields collapse to single optional
|
|
@@ -68,7 +68,7 @@ interface IngestReport {
|
|
|
68
68
|
roots: string[];
|
|
69
69
|
}
|
|
70
70
|
/** Free-string per the wire contract, but these are the recognized values
|
|
71
|
-
* for filtering /
|
|
71
|
+
* for filtering / labeling. */
|
|
72
72
|
type SkillType = "render_block" | "convention" | "workflow" | "task" | "reference" | "mode" | "agent_behavior" | string;
|
|
73
73
|
type AsyncStatus = "idle" | "loading" | "ready" | "error";
|
|
74
74
|
|
|
@@ -68,7 +68,7 @@ interface IngestReport {
|
|
|
68
68
|
roots: string[];
|
|
69
69
|
}
|
|
70
70
|
/** Free-string per the wire contract, but these are the recognized values
|
|
71
|
-
* for filtering /
|
|
71
|
+
* for filtering / labeling. */
|
|
72
72
|
type SkillType = "render_block" | "convention" | "workflow" | "task" | "reference" | "mode" | "agent_behavior" | string;
|
|
73
73
|
type AsyncStatus = "idle" | "loading" | "ready" | "error";
|
|
74
74
|
|
package/dist/sources/index.d.cts
CHANGED
|
@@ -152,7 +152,7 @@ interface SourceRefOptions {
|
|
|
152
152
|
/**
|
|
153
153
|
* Build one pointer. Empty optional fields are omitted (so the wire stays
|
|
154
154
|
* minimal and equal pointers serialise equally); `exclude` is trimmed,
|
|
155
|
-
* lower-cased and de-duplicated exactly as the server
|
|
155
|
+
* lower-cased and de-duplicated exactly as the server normalizes it;
|
|
156
156
|
* `include_segments` is de-duplicated in order. Throws on an empty type or id —
|
|
157
157
|
* a pointer to nothing is never built silently.
|
|
158
158
|
*/
|
package/dist/sources/index.d.ts
CHANGED
|
@@ -152,7 +152,7 @@ interface SourceRefOptions {
|
|
|
152
152
|
/**
|
|
153
153
|
* Build one pointer. Empty optional fields are omitted (so the wire stays
|
|
154
154
|
* minimal and equal pointers serialise equally); `exclude` is trimmed,
|
|
155
|
-
* lower-cased and de-duplicated exactly as the server
|
|
155
|
+
* lower-cased and de-duplicated exactly as the server normalizes it;
|
|
156
156
|
* `include_segments` is de-duplicated in order. Throws on an empty type or id —
|
|
157
157
|
* a pointer to nothing is never built silently.
|
|
158
158
|
*/
|
|
@@ -403,7 +403,7 @@ interface SourcePlan {
|
|
|
403
403
|
sentTokens: number;
|
|
404
404
|
/** Window the verdict is judged against. */
|
|
405
405
|
windowTokens: number;
|
|
406
|
-
/** True when the window is the
|
|
406
|
+
/** True when the window is the labeled default, not the model's own. */
|
|
407
407
|
windowIsFallback: boolean;
|
|
408
408
|
verdict: BudgetVerdict;
|
|
409
409
|
/** Share of the window used, 0..∞. */
|
|
@@ -426,7 +426,7 @@ interface PlanInput {
|
|
|
426
426
|
base: SourceSet;
|
|
427
427
|
/** The model's window, or null when unknown. */
|
|
428
428
|
modelWindowTokens: number | null;
|
|
429
|
-
/** The
|
|
429
|
+
/** The labeled default used when the model is unknown. */
|
|
430
430
|
fallbackWindowTokens: number;
|
|
431
431
|
targetModelId?: string | undefined;
|
|
432
432
|
/** The host's one token estimator (default: the measured `estimateSourceTokens`). */
|
|
@@ -403,7 +403,7 @@ interface SourcePlan {
|
|
|
403
403
|
sentTokens: number;
|
|
404
404
|
/** Window the verdict is judged against. */
|
|
405
405
|
windowTokens: number;
|
|
406
|
-
/** True when the window is the
|
|
406
|
+
/** True when the window is the labeled default, not the model's own. */
|
|
407
407
|
windowIsFallback: boolean;
|
|
408
408
|
verdict: BudgetVerdict;
|
|
409
409
|
/** Share of the window used, 0..∞. */
|
|
@@ -426,7 +426,7 @@ interface PlanInput {
|
|
|
426
426
|
base: SourceSet;
|
|
427
427
|
/** The model's window, or null when unknown. */
|
|
428
428
|
modelWindowTokens: number | null;
|
|
429
|
-
/** The
|
|
429
|
+
/** The labeled default used when the model is unknown. */
|
|
430
430
|
fallbackWindowTokens: number;
|
|
431
431
|
targetModelId?: string | undefined;
|
|
432
432
|
/** The host's one token estimator (default: the measured `estimateSourceTokens`). */
|
package/dist/tools/index.d.cts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `createToolCatalog` — THE tool
|
|
2
|
+
* `createToolCatalog` — THE tool catalog holder (agent core B5).
|
|
3
3
|
*
|
|
4
4
|
* Framework-free like `createRunTierStore`: `getState` / `subscribe`, no Redux, reads only. The
|
|
5
5
|
* active list (`tool.definition`, not deleted, active) feeds every picker; `loadById` resolves one
|
|
6
6
|
* historical reference (inactive tools included) for audit and version surfaces without ever
|
|
7
|
-
* leaking it into the picker list. The
|
|
7
|
+
* leaking it into the picker list. The catalog is a READ of every tool the person can pick —
|
|
8
8
|
* never narrowed by the active organization.
|
|
9
9
|
*/
|
|
10
10
|
interface ToolCatalogPgError {
|
|
@@ -15,7 +15,7 @@ interface ToolCatalogResult<T> {
|
|
|
15
15
|
data: T | null;
|
|
16
16
|
error: ToolCatalogPgError | null;
|
|
17
17
|
}
|
|
18
|
-
/** The structural slice of supabase-js the
|
|
18
|
+
/** The structural slice of supabase-js the catalog uses. */
|
|
19
19
|
interface ToolCatalogQuery<Row> extends PromiseLike<ToolCatalogResult<Row[]>> {
|
|
20
20
|
select(columns: string): ToolCatalogQuery<Row>;
|
|
21
21
|
is(column: string, value: null): ToolCatalogQuery<Row>;
|
|
@@ -47,7 +47,7 @@ interface ToolCatalogState<Row extends ToolRowBase = ToolRowBase> {
|
|
|
47
47
|
}
|
|
48
48
|
interface ToolCatalogConfig<Row extends ToolRowBase> {
|
|
49
49
|
client: ToolCatalogClient<Row> | (() => ToolCatalogClient<Row>);
|
|
50
|
-
/** OPTIONAL — DEFAULT: true. False (no database, a signed-out visitor) answers an empty
|
|
50
|
+
/** OPTIONAL — DEFAULT: true. False (no database, a signed-out visitor) answers an empty catalog. */
|
|
51
51
|
isAvailable?: () => boolean;
|
|
52
52
|
/** OPTIONAL — DEFAULT: a tagged `console.error`. */
|
|
53
53
|
errorSink?: (event: {
|
|
@@ -59,7 +59,7 @@ interface ToolCatalogConfig<Row extends ToolRowBase> {
|
|
|
59
59
|
interface ToolCatalog<Row extends ToolRowBase = ToolRowBase> {
|
|
60
60
|
getState(): ToolCatalogState<Row>;
|
|
61
61
|
subscribe(listener: () => void): () => void;
|
|
62
|
-
/** The active
|
|
62
|
+
/** The active catalog; one read per session (concurrent calls share it). `force` re-reads. */
|
|
63
63
|
load(options?: {
|
|
64
64
|
force?: boolean;
|
|
65
65
|
}): Promise<Row[]>;
|
|
@@ -247,7 +247,7 @@ interface ToolCallView {
|
|
|
247
247
|
points_held: number;
|
|
248
248
|
points_charged: number;
|
|
249
249
|
cache: ToolCallCache;
|
|
250
|
-
/** The
|
|
250
|
+
/** The normalized inputs the call ran with (detection applied, defaults filled), so a stored call can refill its form. */
|
|
251
251
|
inputs?: Record<string, unknown> | null;
|
|
252
252
|
/** How many sources were tried; the list itself is admin-only. */
|
|
253
253
|
attempts_count?: number;
|
package/dist/tools/index.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `createToolCatalog` — THE tool
|
|
2
|
+
* `createToolCatalog` — THE tool catalog holder (agent core B5).
|
|
3
3
|
*
|
|
4
4
|
* Framework-free like `createRunTierStore`: `getState` / `subscribe`, no Redux, reads only. The
|
|
5
5
|
* active list (`tool.definition`, not deleted, active) feeds every picker; `loadById` resolves one
|
|
6
6
|
* historical reference (inactive tools included) for audit and version surfaces without ever
|
|
7
|
-
* leaking it into the picker list. The
|
|
7
|
+
* leaking it into the picker list. The catalog is a READ of every tool the person can pick —
|
|
8
8
|
* never narrowed by the active organization.
|
|
9
9
|
*/
|
|
10
10
|
interface ToolCatalogPgError {
|
|
@@ -15,7 +15,7 @@ interface ToolCatalogResult<T> {
|
|
|
15
15
|
data: T | null;
|
|
16
16
|
error: ToolCatalogPgError | null;
|
|
17
17
|
}
|
|
18
|
-
/** The structural slice of supabase-js the
|
|
18
|
+
/** The structural slice of supabase-js the catalog uses. */
|
|
19
19
|
interface ToolCatalogQuery<Row> extends PromiseLike<ToolCatalogResult<Row[]>> {
|
|
20
20
|
select(columns: string): ToolCatalogQuery<Row>;
|
|
21
21
|
is(column: string, value: null): ToolCatalogQuery<Row>;
|
|
@@ -47,7 +47,7 @@ interface ToolCatalogState<Row extends ToolRowBase = ToolRowBase> {
|
|
|
47
47
|
}
|
|
48
48
|
interface ToolCatalogConfig<Row extends ToolRowBase> {
|
|
49
49
|
client: ToolCatalogClient<Row> | (() => ToolCatalogClient<Row>);
|
|
50
|
-
/** OPTIONAL — DEFAULT: true. False (no database, a signed-out visitor) answers an empty
|
|
50
|
+
/** OPTIONAL — DEFAULT: true. False (no database, a signed-out visitor) answers an empty catalog. */
|
|
51
51
|
isAvailable?: () => boolean;
|
|
52
52
|
/** OPTIONAL — DEFAULT: a tagged `console.error`. */
|
|
53
53
|
errorSink?: (event: {
|
|
@@ -59,7 +59,7 @@ interface ToolCatalogConfig<Row extends ToolRowBase> {
|
|
|
59
59
|
interface ToolCatalog<Row extends ToolRowBase = ToolRowBase> {
|
|
60
60
|
getState(): ToolCatalogState<Row>;
|
|
61
61
|
subscribe(listener: () => void): () => void;
|
|
62
|
-
/** The active
|
|
62
|
+
/** The active catalog; one read per session (concurrent calls share it). `force` re-reads. */
|
|
63
63
|
load(options?: {
|
|
64
64
|
force?: boolean;
|
|
65
65
|
}): Promise<Row[]>;
|
|
@@ -247,7 +247,7 @@ interface ToolCallView {
|
|
|
247
247
|
points_held: number;
|
|
248
248
|
points_charged: number;
|
|
249
249
|
cache: ToolCallCache;
|
|
250
|
-
/** The
|
|
250
|
+
/** The normalized inputs the call ran with (detection applied, defaults filled), so a stored call can refill its form. */
|
|
251
251
|
inputs?: Record<string, unknown> | null;
|
|
252
252
|
/** How many sources were tried; the list itself is admin-only. */
|
|
253
253
|
attempts_count?: number;
|