@lssm/example.agent-console 0.0.0-canary-20251217060433 → 0.0.0-canary-20251217062139
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/.turbo/turbo-build$colon$bundle.log +229 -73
- package/CHANGELOG.md +6 -6
- package/dist/agent/agent.contracts.d.ts +126 -126
- package/dist/agent/agent.contracts.js +1 -1
- package/dist/agent/agent.entity.d.ts +36 -36
- package/dist/agent/agent.entity.js +1 -1
- package/dist/agent/agent.enum.d.ts +4 -4
- package/dist/agent/agent.enum.js +1 -1
- package/dist/agent/agent.event.d.ts +31 -31
- package/dist/agent/agent.event.js +1 -1
- package/dist/agent/agent.handler.d.ts +1 -1
- package/dist/agent/agent.schema.d.ts +95 -95
- package/dist/agent/agent.schema.js +1 -1
- package/dist/docs/agent-console.docblock.js +1 -1
- package/dist/index.d.ts +0 -3
- package/dist/libs/contracts/dist/capabilities/openbanking.js +1 -0
- package/dist/libs/contracts/dist/client/index.js +1 -0
- package/dist/libs/contracts/dist/client/react/feature-render.js +1 -0
- package/dist/libs/contracts/dist/client/react/form-render.js +1 -0
- package/dist/libs/contracts/dist/client/react/index.js +1 -0
- package/dist/libs/contracts/dist/contract-registry/index.js +1 -0
- package/dist/libs/contracts/dist/contract-registry/schemas.js +1 -0
- package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js +76 -0
- package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js +350 -0
- package/dist/libs/contracts/dist/docs/index.js +1 -0
- package/dist/libs/contracts/dist/docs/presentations.js +1 -0
- package/dist/libs/contracts/dist/docs/registry.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +383 -0
- package/dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +68 -0
- package/dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +140 -0
- package/dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +86 -0
- package/dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js +58 -0
- package/dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js +38 -0
- package/dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js +213 -0
- package/dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js +289 -0
- package/dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/schema/README.docblock.js +262 -0
- package/dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js +57 -0
- package/dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js +63 -0
- package/dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js +36 -0
- package/dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js +20 -0
- package/dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js +65 -0
- package/dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js +41 -0
- package/dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js +122 -0
- package/dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js +1 -0
- package/dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js +68 -0
- package/dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js +1 -0
- package/dist/libs/contracts/dist/events.js +1 -0
- package/dist/libs/contracts/dist/experiments/evaluator.js +1 -0
- package/dist/libs/contracts/dist/index.js +1 -0
- package/dist/libs/contracts/dist/install.js +1 -0
- package/dist/libs/contracts/dist/integrations/contracts.js +1 -0
- package/dist/libs/contracts/dist/integrations/index.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/contracts/balances.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/contracts/index.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/contracts/transactions.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/models.js +1 -0
- package/dist/libs/contracts/dist/integrations/openbanking/telemetry.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/elevenlabs.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/gcs-storage.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/gmail.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/google-calendar.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/index.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/mistral.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/postmark.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/powens.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/qdrant.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/registry.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/stripe.js +1 -0
- package/dist/libs/contracts/dist/integrations/providers/twilio-sms.js +1 -0
- package/dist/libs/contracts/dist/jsonschema.js +1 -0
- package/dist/libs/contracts/dist/knowledge/contracts.js +1 -0
- package/dist/libs/contracts/dist/knowledge/index.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/email-threads.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/financial-docs.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/financial-overview.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/index.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/product-canon.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/support-faq.js +1 -0
- package/dist/libs/contracts/dist/knowledge/spaces/uploaded-docs.js +1 -0
- package/dist/libs/contracts/dist/llm/exporters.js +1 -0
- package/dist/libs/contracts/dist/llm/index.js +1 -0
- package/dist/libs/contracts/dist/llm/prompts.js +1 -0
- package/dist/libs/contracts/dist/onboarding-base.js +1 -0
- package/dist/libs/contracts/dist/openapi.js +1 -0
- package/dist/libs/contracts/dist/ownership.js +1 -0
- package/dist/libs/contracts/dist/presentations.js +1 -0
- package/dist/libs/contracts/dist/presentations.v2.js +1 -0
- package/dist/libs/contracts/dist/prompt.js +1 -0
- package/dist/libs/contracts/dist/promptRegistry.js +1 -0
- package/dist/libs/contracts/dist/regenerator/index.js +1 -0
- package/dist/libs/contracts/dist/regenerator/service.js +1 -0
- package/dist/libs/contracts/dist/registry.js +1 -0
- package/dist/libs/contracts/dist/resources.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/EnumType.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/FieldType.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/ScalarTypeEnum.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/SchemaModel.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/entity/defineEntity.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/entity/index.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/entity/types.js +1 -0
- package/dist/libs/contracts/dist/schema/dist/index.js +1 -0
- package/dist/libs/contracts/dist/server/graphql-pothos.js +1 -0
- package/dist/libs/contracts/dist/server/index.js +1 -0
- package/dist/libs/contracts/dist/server/mcp/createMcpServer.js +1 -0
- package/dist/libs/contracts/dist/server/mcp/registerPresentations.js +1 -0
- package/dist/libs/contracts/dist/server/mcp/registerPrompts.js +1 -0
- package/dist/libs/contracts/dist/server/mcp/registerResources.js +1 -0
- package/dist/libs/contracts/dist/server/mcp/registerTools.js +1 -0
- package/dist/libs/contracts/dist/server/provider-mcp.js +1 -0
- package/dist/libs/contracts/dist/server/rest-elysia.js +1 -0
- package/dist/libs/contracts/dist/server/rest-express.js +1 -0
- package/dist/libs/contracts/dist/server/rest-generic.js +1 -0
- package/dist/libs/contracts/dist/server/rest-next-app.js +1 -0
- package/dist/libs/contracts/dist/server/rest-next-pages.js +1 -0
- package/dist/libs/contracts/dist/spec.js +1 -0
- package/dist/libs/contracts/dist/telemetry/index.js +1 -0
- package/dist/libs/contracts/dist/telemetry/tracker.js +1 -0
- package/dist/libs/contracts/dist/tests/index.js +1 -0
- package/dist/libs/contracts/dist/tests/runner.js +1 -0
- package/dist/libs/contracts/dist/workflow/index.js +1 -0
- package/dist/libs/contracts/dist/workflow/runner.js +1 -0
- package/dist/libs/schema/dist/EnumType.js +1 -0
- package/dist/libs/schema/dist/FieldType.js +1 -0
- package/dist/libs/schema/dist/ScalarTypeEnum.js +1 -0
- package/dist/libs/schema/dist/SchemaModel.js +1 -0
- package/dist/libs/schema/dist/entity/defineEntity.js +1 -0
- package/dist/libs/schema/dist/entity/index.js +1 -0
- package/dist/libs/schema/dist/entity/types.js +1 -0
- package/dist/libs/schema/dist/index.js +1 -0
- package/dist/run/run.contracts.d.ts +1 -1
- package/dist/run/run.contracts.js +1 -1
- package/dist/run/run.entity.d.ts +56 -56
- package/dist/run/run.entity.js +1 -1
- package/dist/run/run.enum.d.ts +5 -5
- package/dist/run/run.enum.js +1 -1
- package/dist/run/run.event.d.ts +71 -71
- package/dist/run/run.event.js +1 -1
- package/dist/run/run.schema.d.ts +99 -99
- package/dist/run/run.schema.js +1 -1
- package/dist/tool/tool.contracts.d.ts +101 -101
- package/dist/tool/tool.contracts.js +1 -1
- package/dist/tool/tool.entity.d.ts +24 -24
- package/dist/tool/tool.entity.js +1 -1
- package/dist/tool/tool.enum.d.ts +4 -4
- package/dist/tool/tool.enum.js +1 -1
- package/dist/tool/tool.event.d.ts +25 -25
- package/dist/tool/tool.event.js +1 -1
- package/dist/tool/tool.handler.d.ts +1 -1
- package/dist/tool/tool.schema.d.ts +52 -52
- package/dist/tool/tool.schema.js +1 -1
- package/package.json +43 -43
|
@@ -1,268 +1,268 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as _lssm_lib_schema28 from "@lssm/lib.schema";
|
|
2
2
|
|
|
3
3
|
//#region src/agent/agent.schema.d.ts
|
|
4
4
|
/**
|
|
5
5
|
* AI agent configuration schema.
|
|
6
6
|
*/
|
|
7
|
-
declare const AgentModel:
|
|
7
|
+
declare const AgentModel: _lssm_lib_schema28.SchemaModel<{
|
|
8
8
|
id: {
|
|
9
|
-
type:
|
|
9
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
10
10
|
isOptional: false;
|
|
11
11
|
};
|
|
12
12
|
organizationId: {
|
|
13
|
-
type:
|
|
13
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
14
14
|
isOptional: false;
|
|
15
15
|
};
|
|
16
16
|
name: {
|
|
17
|
-
type:
|
|
17
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
18
18
|
isOptional: false;
|
|
19
19
|
};
|
|
20
20
|
slug: {
|
|
21
|
-
type:
|
|
21
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
22
22
|
isOptional: false;
|
|
23
23
|
};
|
|
24
24
|
description: {
|
|
25
|
-
type:
|
|
25
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
26
26
|
isOptional: true;
|
|
27
27
|
};
|
|
28
28
|
status: {
|
|
29
|
-
type:
|
|
29
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string]>;
|
|
30
30
|
isOptional: false;
|
|
31
31
|
};
|
|
32
32
|
modelProvider: {
|
|
33
|
-
type:
|
|
33
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string, string]>;
|
|
34
34
|
isOptional: false;
|
|
35
35
|
};
|
|
36
36
|
modelName: {
|
|
37
|
-
type:
|
|
37
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
38
38
|
isOptional: false;
|
|
39
39
|
};
|
|
40
40
|
modelConfig: {
|
|
41
|
-
type:
|
|
41
|
+
type: _lssm_lib_schema28.FieldType<Record<string, unknown>, Record<string, unknown>>;
|
|
42
42
|
isOptional: true;
|
|
43
43
|
};
|
|
44
44
|
systemPrompt: {
|
|
45
|
-
type:
|
|
45
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
46
46
|
isOptional: false;
|
|
47
47
|
};
|
|
48
48
|
userPromptTemplate: {
|
|
49
|
-
type:
|
|
49
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
50
50
|
isOptional: true;
|
|
51
51
|
};
|
|
52
52
|
toolIds: {
|
|
53
|
-
type:
|
|
53
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
54
54
|
isArray: true;
|
|
55
55
|
isOptional: true;
|
|
56
56
|
};
|
|
57
57
|
toolChoice: {
|
|
58
|
-
type:
|
|
58
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string]>;
|
|
59
59
|
isOptional: false;
|
|
60
60
|
defaultValue: string;
|
|
61
61
|
};
|
|
62
62
|
maxIterations: {
|
|
63
|
-
type:
|
|
63
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
64
64
|
isOptional: false;
|
|
65
65
|
defaultValue: number;
|
|
66
66
|
};
|
|
67
67
|
maxTokensPerRun: {
|
|
68
|
-
type:
|
|
68
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
69
69
|
isOptional: true;
|
|
70
70
|
};
|
|
71
71
|
timeoutMs: {
|
|
72
|
-
type:
|
|
72
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
73
73
|
isOptional: false;
|
|
74
74
|
defaultValue: number;
|
|
75
75
|
};
|
|
76
76
|
version: {
|
|
77
|
-
type:
|
|
77
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
78
78
|
isOptional: false;
|
|
79
79
|
};
|
|
80
80
|
tags: {
|
|
81
|
-
type:
|
|
81
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
82
82
|
isArray: true;
|
|
83
83
|
isOptional: true;
|
|
84
84
|
};
|
|
85
85
|
createdAt: {
|
|
86
|
-
type:
|
|
86
|
+
type: _lssm_lib_schema28.FieldType<Date, string>;
|
|
87
87
|
isOptional: false;
|
|
88
88
|
};
|
|
89
89
|
updatedAt: {
|
|
90
|
-
type:
|
|
90
|
+
type: _lssm_lib_schema28.FieldType<Date, string>;
|
|
91
91
|
isOptional: false;
|
|
92
92
|
};
|
|
93
93
|
}>;
|
|
94
94
|
/**
|
|
95
95
|
* Summary of an agent for list views.
|
|
96
96
|
*/
|
|
97
|
-
declare const AgentSummaryModel:
|
|
97
|
+
declare const AgentSummaryModel: _lssm_lib_schema28.SchemaModel<{
|
|
98
98
|
id: {
|
|
99
|
-
type:
|
|
99
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
100
100
|
isOptional: false;
|
|
101
101
|
};
|
|
102
102
|
name: {
|
|
103
|
-
type:
|
|
103
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
104
104
|
isOptional: false;
|
|
105
105
|
};
|
|
106
106
|
slug: {
|
|
107
|
-
type:
|
|
107
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
108
108
|
isOptional: false;
|
|
109
109
|
};
|
|
110
110
|
description: {
|
|
111
|
-
type:
|
|
111
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
112
112
|
isOptional: true;
|
|
113
113
|
};
|
|
114
114
|
status: {
|
|
115
|
-
type:
|
|
115
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string]>;
|
|
116
116
|
isOptional: false;
|
|
117
117
|
};
|
|
118
118
|
modelProvider: {
|
|
119
|
-
type:
|
|
119
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string, string]>;
|
|
120
120
|
isOptional: false;
|
|
121
121
|
};
|
|
122
122
|
modelName: {
|
|
123
|
-
type:
|
|
123
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
124
124
|
isOptional: false;
|
|
125
125
|
};
|
|
126
126
|
version: {
|
|
127
|
-
type:
|
|
127
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
128
128
|
isOptional: false;
|
|
129
129
|
};
|
|
130
130
|
createdAt: {
|
|
131
|
-
type:
|
|
131
|
+
type: _lssm_lib_schema28.FieldType<Date, string>;
|
|
132
132
|
isOptional: false;
|
|
133
133
|
};
|
|
134
134
|
}>;
|
|
135
135
|
/**
|
|
136
136
|
* Tool reference in agent context.
|
|
137
137
|
*/
|
|
138
|
-
declare const AgentToolRefModel:
|
|
138
|
+
declare const AgentToolRefModel: _lssm_lib_schema28.SchemaModel<{
|
|
139
139
|
id: {
|
|
140
|
-
type:
|
|
140
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
141
141
|
isOptional: false;
|
|
142
142
|
};
|
|
143
143
|
name: {
|
|
144
|
-
type:
|
|
144
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
145
145
|
isOptional: false;
|
|
146
146
|
};
|
|
147
147
|
slug: {
|
|
148
|
-
type:
|
|
148
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
149
149
|
isOptional: false;
|
|
150
150
|
};
|
|
151
151
|
description: {
|
|
152
|
-
type:
|
|
152
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
153
153
|
isOptional: false;
|
|
154
154
|
};
|
|
155
155
|
category: {
|
|
156
|
-
type:
|
|
156
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
157
157
|
isOptional: false;
|
|
158
158
|
};
|
|
159
159
|
}>;
|
|
160
160
|
/**
|
|
161
161
|
* Agent with associated tools.
|
|
162
162
|
*/
|
|
163
|
-
declare const AgentWithToolsModel:
|
|
163
|
+
declare const AgentWithToolsModel: _lssm_lib_schema28.SchemaModel<{
|
|
164
164
|
id: {
|
|
165
|
-
type:
|
|
165
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
166
166
|
isOptional: false;
|
|
167
167
|
};
|
|
168
168
|
organizationId: {
|
|
169
|
-
type:
|
|
169
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
170
170
|
isOptional: false;
|
|
171
171
|
};
|
|
172
172
|
name: {
|
|
173
|
-
type:
|
|
173
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
174
174
|
isOptional: false;
|
|
175
175
|
};
|
|
176
176
|
slug: {
|
|
177
|
-
type:
|
|
177
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
178
178
|
isOptional: false;
|
|
179
179
|
};
|
|
180
180
|
description: {
|
|
181
|
-
type:
|
|
181
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
182
182
|
isOptional: true;
|
|
183
183
|
};
|
|
184
184
|
status: {
|
|
185
|
-
type:
|
|
185
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string]>;
|
|
186
186
|
isOptional: false;
|
|
187
187
|
};
|
|
188
188
|
modelProvider: {
|
|
189
|
-
type:
|
|
189
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string, string]>;
|
|
190
190
|
isOptional: false;
|
|
191
191
|
};
|
|
192
192
|
modelName: {
|
|
193
|
-
type:
|
|
193
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
194
194
|
isOptional: false;
|
|
195
195
|
};
|
|
196
196
|
modelConfig: {
|
|
197
|
-
type:
|
|
197
|
+
type: _lssm_lib_schema28.FieldType<Record<string, unknown>, Record<string, unknown>>;
|
|
198
198
|
isOptional: true;
|
|
199
199
|
};
|
|
200
200
|
systemPrompt: {
|
|
201
|
-
type:
|
|
201
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
202
202
|
isOptional: false;
|
|
203
203
|
};
|
|
204
204
|
userPromptTemplate: {
|
|
205
|
-
type:
|
|
205
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
206
206
|
isOptional: true;
|
|
207
207
|
};
|
|
208
208
|
toolIds: {
|
|
209
|
-
type:
|
|
209
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
210
210
|
isArray: true;
|
|
211
211
|
isOptional: true;
|
|
212
212
|
};
|
|
213
213
|
toolChoice: {
|
|
214
|
-
type:
|
|
214
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string]>;
|
|
215
215
|
isOptional: false;
|
|
216
216
|
};
|
|
217
217
|
maxIterations: {
|
|
218
|
-
type:
|
|
218
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
219
219
|
isOptional: false;
|
|
220
220
|
};
|
|
221
221
|
maxTokensPerRun: {
|
|
222
|
-
type:
|
|
222
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
223
223
|
isOptional: true;
|
|
224
224
|
};
|
|
225
225
|
timeoutMs: {
|
|
226
|
-
type:
|
|
226
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
227
227
|
isOptional: false;
|
|
228
228
|
};
|
|
229
229
|
version: {
|
|
230
|
-
type:
|
|
230
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
231
231
|
isOptional: false;
|
|
232
232
|
};
|
|
233
233
|
tags: {
|
|
234
|
-
type:
|
|
234
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
235
235
|
isArray: true;
|
|
236
236
|
isOptional: true;
|
|
237
237
|
};
|
|
238
238
|
createdAt: {
|
|
239
|
-
type:
|
|
239
|
+
type: _lssm_lib_schema28.FieldType<Date, string>;
|
|
240
240
|
isOptional: false;
|
|
241
241
|
};
|
|
242
242
|
updatedAt: {
|
|
243
|
-
type:
|
|
243
|
+
type: _lssm_lib_schema28.FieldType<Date, string>;
|
|
244
244
|
isOptional: false;
|
|
245
245
|
};
|
|
246
246
|
tools: {
|
|
247
|
-
type:
|
|
247
|
+
type: _lssm_lib_schema28.SchemaModel<{
|
|
248
248
|
id: {
|
|
249
|
-
type:
|
|
249
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
250
250
|
isOptional: false;
|
|
251
251
|
};
|
|
252
252
|
name: {
|
|
253
|
-
type:
|
|
253
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
254
254
|
isOptional: false;
|
|
255
255
|
};
|
|
256
256
|
slug: {
|
|
257
|
-
type:
|
|
257
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
258
258
|
isOptional: false;
|
|
259
259
|
};
|
|
260
260
|
description: {
|
|
261
|
-
type:
|
|
261
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
262
262
|
isOptional: false;
|
|
263
263
|
};
|
|
264
264
|
category: {
|
|
265
|
-
type:
|
|
265
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
266
266
|
isOptional: false;
|
|
267
267
|
};
|
|
268
268
|
}>;
|
|
@@ -273,66 +273,66 @@ declare const AgentWithToolsModel: _lssm_lib_schema513.SchemaModel<{
|
|
|
273
273
|
/**
|
|
274
274
|
* Input for creating an agent.
|
|
275
275
|
*/
|
|
276
|
-
declare const CreateAgentInputModel:
|
|
276
|
+
declare const CreateAgentInputModel: _lssm_lib_schema28.SchemaModel<{
|
|
277
277
|
organizationId: {
|
|
278
|
-
type:
|
|
278
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
279
279
|
isOptional: false;
|
|
280
280
|
};
|
|
281
281
|
name: {
|
|
282
|
-
type:
|
|
282
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
283
283
|
isOptional: false;
|
|
284
284
|
};
|
|
285
285
|
slug: {
|
|
286
|
-
type:
|
|
286
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
287
287
|
isOptional: false;
|
|
288
288
|
};
|
|
289
289
|
description: {
|
|
290
|
-
type:
|
|
290
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
291
291
|
isOptional: true;
|
|
292
292
|
};
|
|
293
293
|
modelProvider: {
|
|
294
|
-
type:
|
|
294
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string, string]>;
|
|
295
295
|
isOptional: false;
|
|
296
296
|
};
|
|
297
297
|
modelName: {
|
|
298
|
-
type:
|
|
298
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
299
299
|
isOptional: false;
|
|
300
300
|
};
|
|
301
301
|
modelConfig: {
|
|
302
|
-
type:
|
|
302
|
+
type: _lssm_lib_schema28.FieldType<Record<string, unknown>, Record<string, unknown>>;
|
|
303
303
|
isOptional: true;
|
|
304
304
|
};
|
|
305
305
|
systemPrompt: {
|
|
306
|
-
type:
|
|
306
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
307
307
|
isOptional: false;
|
|
308
308
|
};
|
|
309
309
|
userPromptTemplate: {
|
|
310
|
-
type:
|
|
310
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
311
311
|
isOptional: true;
|
|
312
312
|
};
|
|
313
313
|
toolIds: {
|
|
314
|
-
type:
|
|
314
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
315
315
|
isArray: true;
|
|
316
316
|
isOptional: true;
|
|
317
317
|
};
|
|
318
318
|
toolChoice: {
|
|
319
|
-
type:
|
|
319
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string]>;
|
|
320
320
|
isOptional: true;
|
|
321
321
|
};
|
|
322
322
|
maxIterations: {
|
|
323
|
-
type:
|
|
323
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
324
324
|
isOptional: true;
|
|
325
325
|
};
|
|
326
326
|
maxTokensPerRun: {
|
|
327
|
-
type:
|
|
327
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
328
328
|
isOptional: true;
|
|
329
329
|
};
|
|
330
330
|
timeoutMs: {
|
|
331
|
-
type:
|
|
331
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
332
332
|
isOptional: true;
|
|
333
333
|
};
|
|
334
334
|
tags: {
|
|
335
|
-
type:
|
|
335
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
336
336
|
isArray: true;
|
|
337
337
|
isOptional: true;
|
|
338
338
|
};
|
|
@@ -340,58 +340,58 @@ declare const CreateAgentInputModel: _lssm_lib_schema513.SchemaModel<{
|
|
|
340
340
|
/**
|
|
341
341
|
* Input for updating an agent.
|
|
342
342
|
*/
|
|
343
|
-
declare const UpdateAgentInputModel:
|
|
343
|
+
declare const UpdateAgentInputModel: _lssm_lib_schema28.SchemaModel<{
|
|
344
344
|
agentId: {
|
|
345
|
-
type:
|
|
345
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
346
346
|
isOptional: false;
|
|
347
347
|
};
|
|
348
348
|
name: {
|
|
349
|
-
type:
|
|
349
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
350
350
|
isOptional: true;
|
|
351
351
|
};
|
|
352
352
|
description: {
|
|
353
|
-
type:
|
|
353
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
354
354
|
isOptional: true;
|
|
355
355
|
};
|
|
356
356
|
status: {
|
|
357
|
-
type:
|
|
357
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string, string]>;
|
|
358
358
|
isOptional: true;
|
|
359
359
|
};
|
|
360
360
|
modelConfig: {
|
|
361
|
-
type:
|
|
361
|
+
type: _lssm_lib_schema28.FieldType<Record<string, unknown>, Record<string, unknown>>;
|
|
362
362
|
isOptional: true;
|
|
363
363
|
};
|
|
364
364
|
systemPrompt: {
|
|
365
|
-
type:
|
|
365
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
366
366
|
isOptional: true;
|
|
367
367
|
};
|
|
368
368
|
userPromptTemplate: {
|
|
369
|
-
type:
|
|
369
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
370
370
|
isOptional: true;
|
|
371
371
|
};
|
|
372
372
|
toolIds: {
|
|
373
|
-
type:
|
|
373
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
374
374
|
isArray: true;
|
|
375
375
|
isOptional: true;
|
|
376
376
|
};
|
|
377
377
|
toolChoice: {
|
|
378
|
-
type:
|
|
378
|
+
type: _lssm_lib_schema28.EnumType<[string, string, string]>;
|
|
379
379
|
isOptional: true;
|
|
380
380
|
};
|
|
381
381
|
maxIterations: {
|
|
382
|
-
type:
|
|
382
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
383
383
|
isOptional: true;
|
|
384
384
|
};
|
|
385
385
|
maxTokensPerRun: {
|
|
386
|
-
type:
|
|
386
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
387
387
|
isOptional: true;
|
|
388
388
|
};
|
|
389
389
|
timeoutMs: {
|
|
390
|
-
type:
|
|
390
|
+
type: _lssm_lib_schema28.FieldType<number, number>;
|
|
391
391
|
isOptional: true;
|
|
392
392
|
};
|
|
393
393
|
tags: {
|
|
394
|
-
type:
|
|
394
|
+
type: _lssm_lib_schema28.FieldType<string, string>;
|
|
395
395
|
isArray: true;
|
|
396
396
|
isOptional: true;
|
|
397
397
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{AgentStatusEnum as n,ModelProviderEnum as r,ToolChoiceEnum as i}from"./agent.enum.js";const a=t({name:`Agent`,description:`AI agent configuration`,fields:{id:{type:e.String_unsecure(),isOptional:!1},organizationId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},status:{type:n,isOptional:!1},modelProvider:{type:r,isOptional:!1},modelName:{type:e.NonEmptyString(),isOptional:!1},modelConfig:{type:e.JSONObject(),isOptional:!0},systemPrompt:{type:e.String_unsecure(),isOptional:!1},userPromptTemplate:{type:e.String_unsecure(),isOptional:!0},toolIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},toolChoice:{type:i,isOptional:!1,defaultValue:`auto`},maxIterations:{type:e.Int_unsecure(),isOptional:!1,defaultValue:10},maxTokensPerRun:{type:e.Int_unsecure(),isOptional:!0},timeoutMs:{type:e.Int_unsecure(),isOptional:!1,defaultValue:12e4},version:{type:e.NonEmptyString(),isOptional:!1},tags:{type:e.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`AgentSummary`,description:`Summary of an agent for list views`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},status:{type:n,isOptional:!1},modelProvider:{type:r,isOptional:!1},modelName:{type:e.NonEmptyString(),isOptional:!1},version:{type:e.NonEmptyString(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),s=t({name:`AgentToolRef`,description:`Tool reference in agent context`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!1}}}),c=t({name:`AgentWithTools`,description:`Agent with associated tools`,fields:{id:{type:e.String_unsecure(),isOptional:!1},organizationId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},status:{type:n,isOptional:!1},modelProvider:{type:r,isOptional:!1},modelName:{type:e.NonEmptyString(),isOptional:!1},modelConfig:{type:e.JSONObject(),isOptional:!0},systemPrompt:{type:e.String_unsecure(),isOptional:!1},userPromptTemplate:{type:e.String_unsecure(),isOptional:!0},toolIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},toolChoice:{type:i,isOptional:!1},maxIterations:{type:e.Int_unsecure(),isOptional:!1},maxTokensPerRun:{type:e.Int_unsecure(),isOptional:!0},timeoutMs:{type:e.Int_unsecure(),isOptional:!1},version:{type:e.NonEmptyString(),isOptional:!1},tags:{type:e.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1},tools:{type:s,isArray:!0,isOptional:!0}}}),l=t({name:`CreateAgentInput`,description:`Input for creating an agent`,fields:{organizationId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},modelProvider:{type:r,isOptional:!1},modelName:{type:e.NonEmptyString(),isOptional:!1},modelConfig:{type:e.JSONObject(),isOptional:!0},systemPrompt:{type:e.String_unsecure(),isOptional:!1},userPromptTemplate:{type:e.String_unsecure(),isOptional:!0},toolIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},toolChoice:{type:i,isOptional:!0},maxIterations:{type:e.Int_unsecure(),isOptional:!0},maxTokensPerRun:{type:e.Int_unsecure(),isOptional:!0},timeoutMs:{type:e.Int_unsecure(),isOptional:!0},tags:{type:e.String_unsecure(),isArray:!0,isOptional:!0}}}),u=t({name:`UpdateAgentInput`,description:`Input for updating an agent`,fields:{agentId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.NonEmptyString(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},status:{type:n,isOptional:!0},modelConfig:{type:e.JSONObject(),isOptional:!0},systemPrompt:{type:e.String_unsecure(),isOptional:!0},userPromptTemplate:{type:e.String_unsecure(),isOptional:!0},toolIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},toolChoice:{type:i,isOptional:!0},maxIterations:{type:e.Int_unsecure(),isOptional:!0},maxTokensPerRun:{type:e.Int_unsecure(),isOptional:!0},timeoutMs:{type:e.Int_unsecure(),isOptional:!0},tags:{type:e.String_unsecure(),isArray:!0,isOptional:!0}}});export{a as AgentModel,o as AgentSummaryModel,s as AgentToolRefModel,c as AgentWithToolsModel,l as CreateAgentInputModel,u as UpdateAgentInputModel};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.examples.agent-console.goal`,title:`Agent Console — Goal`,summary:`AI agent ops console: tools, agents, runs, logs, and metrics.`,kind:`goal`,visibility:`public`,route:`/docs/examples/agent-console/goal`,tags:[`ai`,`agents`,`goal`],body:`## Why it matters
|
|
2
2
|
- Provides a regenerable agent operations surface with tool registry and run history.
|
|
3
3
|
- Prevents drift between tool schemas, agent configs, and execution logs.
|
|
4
4
|
|
package/dist/index.d.ts
CHANGED
|
@@ -6,7 +6,6 @@ import { AgentCreatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, Agent
|
|
|
6
6
|
import { AgentSummary, AgentToolRef, AgentWithTools, GetAgentInput, ListAgentsInput, ListAgentsOutput, mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler, mockUpdateAgentHandler } from "./agent/agent.handler.js";
|
|
7
7
|
import { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation } from "./agent/agent.presentation.js";
|
|
8
8
|
import { AgentModel, AgentSummaryModel, AgentToolRefModel, AgentWithToolsModel, CreateAgentInputModel, UpdateAgentInputModel } from "./agent/agent.schema.js";
|
|
9
|
-
import "./agent/index.js";
|
|
10
9
|
import example from "./example.js";
|
|
11
10
|
import { ListRunsInput, ListRunsOutput, RunSummary, mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "./run/run.handler.js";
|
|
12
11
|
import { ListToolsInput, ListToolsOutput, ToolSummary, mockCreateToolHandler, mockGetToolHandler, mockListToolsHandler, mockTestToolHandler, mockUpdateToolHandler } from "./tool/tool.handler.js";
|
|
@@ -16,14 +15,12 @@ import { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQu
|
|
|
16
15
|
import { MessageGeneratedEvent, RunCancelledEvent, RunCompletedEvent, RunFailedEvent, RunStartedEvent, ToolCompletedEvent, ToolInvokedEvent } from "./run/run.event.js";
|
|
17
16
|
import { LogLevelEntityEnum, RunEntity, RunLogEntity, RunStatusEntityEnum, RunStepEntity, RunStepTypeEntityEnum } from "./run/run.entity.js";
|
|
18
17
|
import { RunDetailPresentation, RunListPresentation } from "./run/run.presentation.js";
|
|
19
|
-
import "./run/index.js";
|
|
20
18
|
import { ImplementationTypeEnum, ToolCategoryEnum, ToolStatusEnum } from "./tool/tool.enum.js";
|
|
21
19
|
import { CreateToolInputModel, ToolModel, ToolSummaryModel, UpdateToolInputModel } from "./tool/tool.schema.js";
|
|
22
20
|
import { CreateToolCommand, GetToolQuery, ListToolsQuery, TestToolCommand, UpdateToolCommand } from "./tool/tool.contracts.js";
|
|
23
21
|
import { ToolCreatedEvent, ToolStatusChangedEvent, ToolUpdatedEvent } from "./tool/tool.event.js";
|
|
24
22
|
import { ImplementationTypeEntityEnum, ToolCategoryEntityEnum, ToolEntity, ToolStatusEntityEnum } from "./tool/tool.entity.js";
|
|
25
23
|
import { ToolDetailPresentation, ToolListPresentation } from "./tool/tool.presentation.js";
|
|
26
|
-
import "./tool/index.js";
|
|
27
24
|
import { MOCK_AGENTS } from "./shared/mock-agents.js";
|
|
28
25
|
import { MOCK_TOOLS } from "./shared/mock-tools.js";
|
|
29
26
|
import { MOCK_RUNS } from "./shared/mock-runs.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`];[...t],[...n],e.Experimental,[...t],[...n],e.Experimental,[...t],[...n],e.Experimental;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import"../../presentations.v2.js";import"react";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import"react";import"react-hook-form";import"@hookform/resolvers/zod";import"react/jsx-runtime";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use client";import"./feature-render.js";import"./form-render.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{i as e,n as t,r as n}from"./schemas.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{e}from"../ownership.js";import t from"zod";const n=t.enum([`contractspec:operation`,`contractspec:event`,`contractspec:presentation`,`contractspec:form`,`contractspec:feature`,`contractspec:workflow`,`contractspec:template`,`contractspec:integration`,`contractspec:data-view`,`contractspec:migration`,`contractspec:telemetry`,`contractspec:experiment`,`contractspec:app-config`,`contractspec:knowledge`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()});t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});export{i,n,r};
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import{a as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
|
|
2
|
+
|
|
3
|
+
This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
|
|
4
|
+
|
|
5
|
+
## Release Tracks
|
|
6
|
+
|
|
7
|
+
| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
|
|
8
|
+
|-------|--------|---------|-----------|------------|----------|
|
|
9
|
+
| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
|
|
10
|
+
| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
|
|
11
|
+
|
|
12
|
+
## Prerequisites
|
|
13
|
+
|
|
14
|
+
- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
|
|
15
|
+
- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
|
|
16
|
+
- ✅ For stable releases: \`release\` branch exists and is protected.
|
|
17
|
+
|
|
18
|
+
## Canary Workflow (Automatic)
|
|
19
|
+
|
|
20
|
+
Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
|
|
21
|
+
|
|
22
|
+
1. **Trigger**: Push to \`main\`.
|
|
23
|
+
2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
|
|
24
|
+
3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
|
|
25
|
+
|
|
26
|
+
### Consuming Canary Builds
|
|
27
|
+
|
|
28
|
+
To install the latest bleeding-edge version:
|
|
29
|
+
|
|
30
|
+
\`\`\`bash
|
|
31
|
+
npm install @lssm/lib.contracts@canary
|
|
32
|
+
# or
|
|
33
|
+
bun add @lssm/lib.contracts@canary
|
|
34
|
+
\`\`\`
|
|
35
|
+
|
|
36
|
+
## Stable Release Workflow (Manual)
|
|
37
|
+
|
|
38
|
+
Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
|
|
39
|
+
|
|
40
|
+
1. **Develop on \`main\`**: Create features and fixes.
|
|
41
|
+
2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
|
|
42
|
+
3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
|
|
43
|
+
4. **"Version Packages" PR**:
|
|
44
|
+
- The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
|
|
45
|
+
- This PR contains the version bumps and updated \`CHANGELOG.md\` files.
|
|
46
|
+
5. **Merge & Publish**:
|
|
47
|
+
- Review and merge the "Version Packages" PR.
|
|
48
|
+
- The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
|
|
49
|
+
|
|
50
|
+
### Publishing Steps
|
|
51
|
+
|
|
52
|
+
1. Ensure all changesets are present on \`main\`.
|
|
53
|
+
2. Merge \`main\` into \`release\`:
|
|
54
|
+
\`\`\`bash
|
|
55
|
+
git checkout release
|
|
56
|
+
git pull origin release
|
|
57
|
+
git merge main
|
|
58
|
+
git push origin release
|
|
59
|
+
\`\`\`
|
|
60
|
+
3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
|
|
61
|
+
4. Merge that PR.
|
|
62
|
+
5. The release is now live on npm!
|
|
63
|
+
|
|
64
|
+
## Manual Verification (Optional)
|
|
65
|
+
|
|
66
|
+
Before publishing a new version you can run:
|
|
67
|
+
|
|
68
|
+
\`\`\`bash
|
|
69
|
+
bun run build:not-apps
|
|
70
|
+
npx npm-packlist --json packages/libs/contracts
|
|
71
|
+
\`\`\`
|
|
72
|
+
|
|
73
|
+
## Rollback
|
|
74
|
+
|
|
75
|
+
If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
|
|
76
|
+
`}]);
|