@jskit-ai/agent-docs 0.1.193 → 0.1.194
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/guide/agent/app-setup/database-layer.md +74 -5
- package/guide/agent/app-setup/existing-application-migration.md +34 -29
- package/guide/agent/app-setup/multi-homing.md +93 -116
- package/guide/agent/framework/crud-operations.md +16 -2
- package/package.json +1 -1
- package/patterns/feature-package/example/booking-engine/package.json +1 -1
- package/patterns/minimal-foundation/example/package.json +4 -4
- package/patterns/shell-foundation/example/package.json +5 -5
- package/patterns/shell-foundation/example/packages/main/package.json +1 -1
- package/reference/autogen/PATTERN_INDEX.md +35 -35
- package/skills/jskit/SKILL.md +1 -1
- package/skills/jskit/references/crud-operations.md +16 -2
- package/skills/jskit/references/existing-application-migration.md +34 -29
- package/skills/jskit/references/multi-homing.md +93 -116
- package/skills/jskit/references/pattern-index.md +35 -35
- package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
- package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
- package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
- package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
- package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
- package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
- package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
- package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
- package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
- package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
- package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
- package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
- package/skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md +23 -28
|
@@ -41,23 +41,20 @@ a policy/runtime mismatch.
|
|
|
41
41
|
|
|
42
42
|
## Transactional invitation participation
|
|
43
43
|
|
|
44
|
-
Use
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
`workspace.invite.redeem` action runs the participant. No replacement route,
|
|
49
|
-
client follow-up save or after-action event is needed.
|
|
44
|
+
Use `workspaces.core` to connect application records during the built-in
|
|
45
|
+
`workspace.invite.redeem` action. JSKIT owns tokens, invitation state and
|
|
46
|
+
membership. The application owns its reviewed person association, training,
|
|
47
|
+
access scopes and audit records.
|
|
50
48
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
49
|
+
Keep intended access in an application draft until an administrator issues an
|
|
50
|
+
invitation. Preparation creates a token and pending invitation without activating
|
|
51
|
+
membership or sending mail.
|
|
54
52
|
|
|
55
53
|
### Public server methods
|
|
56
54
|
|
|
57
|
-
These
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
validation. Do not forward arbitrary HTTP input as server composition options.
|
|
55
|
+
These server APIs require the caller to authorize creation, delivery and
|
|
56
|
+
revocation in the requested workspace. Ordinary invitation routes retain their
|
|
57
|
+
authorization and role checks. Do not pass arbitrary HTTP input as options.
|
|
61
58
|
|
|
62
59
|
| Capability method | Contract |
|
|
63
60
|
| --- | --- |
|
|
@@ -70,20 +67,18 @@ validation. Do not forward arbitrary HTTP input as server composition options.
|
|
|
70
67
|
|
|
71
68
|
`sendInvite` accepts `{ createdInviteId, inviteTokenPreview }` from preparation or
|
|
72
69
|
only `{ createdInviteId }` for a later attempt. The latter uses JSKIT's existing
|
|
73
|
-
opaque token-hash encoding without rotating the token.
|
|
74
|
-
|
|
75
|
-
|
|
70
|
+
opaque token-hash encoding without rotating the token. Empty or mismatched tokens
|
|
71
|
+
reject. Email, role, expiry and workspace display fields come from stored records.
|
|
72
|
+
The response includes
|
|
76
73
|
`createdInviteId`, `inviteTokenPreview`, `inviteUrl` and `inviteDelivery` alongside
|
|
77
|
-
the ordinary workspace/invitation-list payload.
|
|
78
|
-
|
|
79
|
-
A receipt normally needs only the exact invitation ID.
|
|
74
|
+
the ordinary workspace/invitation-list payload. Keep tokens and URLs out of logs,
|
|
75
|
+
diagnostics and administrative receipts; save the invitation ID in the receipt.
|
|
80
76
|
|
|
81
77
|
### Preparation, association, commit and controlled delivery
|
|
82
78
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
Their writes must forward the provided transaction to their repositories.
|
|
79
|
+
Declare `workspaces: "workspaces.core"` in the application's feature `requires`.
|
|
80
|
+
In this example, `reviewedPeople`, `people`, `scopes` and `audit` are application
|
|
81
|
+
services. Each forwards the supplied transaction to its repositories.
|
|
87
82
|
|
|
88
83
|
```js
|
|
89
84
|
// During application Feature.setup, before serving requests:
|
|
@@ -118,25 +113,22 @@ const prepared = await invites.withTransaction(async (trx) => {
|
|
|
118
113
|
}, options);
|
|
119
114
|
await reviewedPeople.associateInvitationAndSaveReceipt(reviewed, requestId, created.createdInviteId, options);
|
|
120
115
|
return { createdInviteId: created.createdInviteId };
|
|
121
|
-
});
|
|
116
|
+
});
|
|
122
117
|
|
|
123
118
|
const result = await members.sendInvite(workspace, actor, prepared, { context });
|
|
124
|
-
//
|
|
125
|
-
// it contains a secret token and URL as well as the nonsecret delivery outcome.
|
|
119
|
+
// Store the delivery outcome, not the token or URL in result.
|
|
126
120
|
await reviewedPeople.recordDeliveryOutcome(prepared.createdInviteId, result.inviteDelivery, { context });
|
|
127
121
|
```
|
|
128
122
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
idempotency, and does not imply exactly-once email.
|
|
123
|
+
Lock the reviewed draft/receipt and reject changed input on a reused request ID.
|
|
124
|
+
After a lost preparation response, read the receipt instead of preparing another
|
|
125
|
+
invitation. Association failure rolls back the new invitation, replacement of
|
|
126
|
+
the previous invitation, receipt and application writes. Send only after the
|
|
127
|
+
transaction resolves successfully.
|
|
135
128
|
|
|
136
|
-
|
|
137
|
-
`
|
|
138
|
-
|
|
139
|
-
committed. A test application can configure a controlled mailer:
|
|
129
|
+
With no `workspaceInviteMailer`, delivery returns `status: "mailer_unconfigured"`,
|
|
130
|
+
an explanatory `message` and an empty `providerMessageId`; the invitation remains
|
|
131
|
+
committed. Use a controlled mailer in tests; SMTP is unnecessary:
|
|
140
132
|
|
|
141
133
|
```js
|
|
142
134
|
workspaceInviteMailer: {
|
|
@@ -147,86 +139,75 @@ workspaceInviteMailer: {
|
|
|
147
139
|
}
|
|
148
140
|
```
|
|
149
141
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
before sending; revocation after sending starts cannot recall the message.
|
|
142
|
+
Renderer/mailer exceptions return `inviteDelivery.status: "failed"` with a fixed
|
|
143
|
+
message to keep provider errors from exposing tokens. Persistence is unchanged.
|
|
144
|
+
Successful mailer results retain their normalized status, message and provider
|
|
145
|
+
message ID; the default status is `sent`.
|
|
146
|
+
|
|
147
|
+
A provider may accept a message before throwing or losing its response. The
|
|
148
|
+
application must track delivery attempts and decide when to retry; email is not
|
|
149
|
+
exactly once. Revocation after sending starts cannot recall a message.
|
|
159
150
|
|
|
160
151
|
### Acceptance and failure semantics
|
|
161
152
|
|
|
162
|
-
Register one callback during feature setup
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
Acceptance
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
and
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
A
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
Keep `error.transactionOutcome` and `error.cause` when translating failures.
|
|
200
|
-
`rolledBack` confirms rollback; `committed` can indicate a completion-hook error
|
|
201
|
-
after successful persistence; `unknown` leaves the outcome unresolved. A thrown
|
|
202
|
-
error alone does not prove rollback. After-commit failures and external effects
|
|
203
|
-
cannot be included in the atomic guarantee. See
|
|
153
|
+
Register one callback during feature setup to call the required application
|
|
154
|
+
services. Non-functions throw `TypeError`; duplicate registration throws, and
|
|
155
|
+
registration closes when acceptance/refusal first begins. The callback's invite,
|
|
156
|
+
user and options are shallow frozen. JSKIT owns the transaction and passes its
|
|
157
|
+
`trx` and request `context` to the callback.
|
|
158
|
+
|
|
159
|
+
Acceptance checks authentication, recipient email, pending state and expiry under
|
|
160
|
+
workspace/invitation locks. Before calling the participant, it activates membership
|
|
161
|
+
with the stored invitation role, including when updating an existing membership.
|
|
162
|
+
The participant must use application data to check the review version, workspace,
|
|
163
|
+
current inviter authority, person eligibility, existing account link and scope
|
|
164
|
+
eligibility. Client input cannot authorize role or scope overrides.
|
|
165
|
+
|
|
166
|
+
An ordinary invitation without an application association may pass through.
|
|
167
|
+
Reject stale, revoked, conflicting or unexpectedly missing associations. Retain
|
|
168
|
+
enough review history to distinguish ordinary invitations from deleted associations.
|
|
169
|
+
|
|
170
|
+
Await every write with the same transaction and let failures propagate. The
|
|
171
|
+
callback must not commit, roll back, create transactions/savepoints or perform
|
|
172
|
+
external effects. Participant and later invitation-status failures roll back
|
|
173
|
+
membership (including its previous role/status), person/training links, scopes,
|
|
174
|
+
audit and accepted status. Invalid invitations and refusals do not call the
|
|
175
|
+
participant. Acceptance/refusal reject borrowed `options.trx`; revocation can
|
|
176
|
+
join a managed transaction or create one.
|
|
177
|
+
|
|
178
|
+
Acceptance/refusal return 401 for unauthenticated access, 403 for a recipient
|
|
179
|
+
email mismatch and 404 for a missing or handled invitation. A matching recipient's
|
|
180
|
+
expired invitation is revoked and committed before returning 409 with
|
|
181
|
+
`transactionOutcome: "committed"`, without activating membership or calling the
|
|
182
|
+
participant. A failed revocation commit retains its transaction error. Delivery
|
|
183
|
+
returns 404 for missing, foreign or handled invitations, 409 for expiry and 400
|
|
184
|
+
for a token mismatch.
|
|
185
|
+
|
|
186
|
+
Preserve `error.transactionOutcome` and `error.cause`: `rolledBack` confirms
|
|
187
|
+
rollback, `committed` can accompany a failed completion hook, and `unknown`
|
|
188
|
+
requires resolving the outcome before retrying. Errors after commit cannot undo
|
|
189
|
+
persistence. See
|
|
204
190
|
[managed transaction guidance](./existing-application-migration.md#json-rest-v2-integration).
|
|
205
191
|
|
|
206
|
-
Invitation mutations lock workspace before invitation rows
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
same workspace serialize. Database deadlocks/serialization failures remain
|
|
212
|
-
transaction errors; callbacks are not automatically replayed.
|
|
192
|
+
Invitation mutations lock workspace before invitation rows. A losing acceptance,
|
|
193
|
+
refusal, revocation or replacement cannot overwrite accepted/revoked state.
|
|
194
|
+
Replacement can create a new pending invitation after acceptance while retaining
|
|
195
|
+
the accepted invitation. Keep callbacks short: invitation changes in one workspace
|
|
196
|
+
serialize. Deadlocks/serialization failures propagate without replaying callbacks.
|
|
213
197
|
|
|
214
198
|
### Compatibility and verification
|
|
215
199
|
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
refusal, revocation and replacement in both winning orders. The package fixture
|
|
228
|
-
runs these races on native MySQL/MariaDB and PostgreSQL; SQLite skips those races
|
|
229
|
-
and is not evidence of native locking correctness.
|
|
200
|
+
Since `@jskit-ai/workspaces-core@0.1.198`, transactional `createInvite` callers
|
|
201
|
+
must use preparation followed by delivery after commit. Move related acceptance
|
|
202
|
+
writes into the participant. `markAcceptedById` and `revokeById` reject missing
|
|
203
|
+
or handled invitations. Route/action IDs, package exports and schema are unchanged.
|
|
204
|
+
|
|
205
|
+
Test through the normal redeem action: ordinary invitations, rollback after
|
|
206
|
+
application and final status writes, existing membership restoration, invalid
|
|
207
|
+
recipients/associations, controlled delivery failures and lost-response receipts.
|
|
208
|
+
The package fixture tests competing acceptance, refusal, revocation and replacement
|
|
209
|
+
in both winning orders on independent MySQL/MariaDB and PostgreSQL connections.
|
|
210
|
+
SQLite skips those races.
|
|
230
211
|
|
|
231
212
|
Use only a verified empty disposable database named
|
|
232
213
|
`jskit_repository_test_*` for native tests. The runner verifies the actual target,
|
|
@@ -239,17 +220,13 @@ node --test packages/workspaces-core/test/repositories.integration.test.js
|
|
|
239
220
|
npm run verify
|
|
240
221
|
```
|
|
241
222
|
|
|
242
|
-
|
|
243
|
-
permissions, privacy or browser integration. Publication remains a separate
|
|
244
|
-
maintainer operation. After a coordinated release is published, run the
|
|
245
|
-
application's `npm run jskit:update`, restart its backend and verify that
|
|
223
|
+
Run the application's `npm run jskit:update`, restart its backend and verify that
|
|
246
224
|
`members.prepareInvite`, `members.sendInvite` and
|
|
247
225
|
`pendingInvitations.registerAcceptanceParticipant` are functions on the installed
|
|
248
|
-
`workspaces.core` capability.
|
|
249
|
-
against that release. The first coordinated release containing this contract pairs
|
|
226
|
+
`workspaces.core` capability. The first release containing this contract pairs
|
|
250
227
|
`@jskit-ai/workspaces-core@0.1.198`, `@jskit-ai/jskit-catalog@0.1.245` and
|
|
251
|
-
`@jskit-ai/agent-docs@0.1.192`. Upgrade the coordinated dependency graph
|
|
252
|
-
|
|
228
|
+
`@jskit-ai/agent-docs@0.1.192`. Upgrade the coordinated dependency graph, then run
|
|
229
|
+
the application's identity, training, permission, privacy and browser tests.
|
|
253
230
|
|
|
254
231
|
## Browser composition
|
|
255
232
|
|
|
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
|
|
|
15
15
|
|
|
16
16
|
- Id: `app/minimal-foundation`
|
|
17
17
|
- Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
|
|
18
|
-
- Owner: `@jskit-ai/agent-docs@0.1.
|
|
18
|
+
- Owner: `@jskit-ai/agent-docs@0.1.194`
|
|
19
19
|
- Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
|
|
20
20
|
- Examples: [example/](patterns/app/minimal-foundation/example/)
|
|
21
21
|
- Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
|
|
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
|
|
|
26
26
|
|
|
27
27
|
- Id: `app/shell-foundation`
|
|
28
28
|
- Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
|
|
29
|
-
- Owner: `@jskit-ai/agent-docs@0.1.
|
|
29
|
+
- Owner: `@jskit-ai/agent-docs@0.1.194`
|
|
30
30
|
- Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
|
|
31
31
|
- Examples: [example/](patterns/app/shell-foundation/example/)
|
|
32
32
|
- Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
|
|
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
|
|
|
37
37
|
|
|
38
38
|
- Id: `assistant/assistant-surface`
|
|
39
39
|
- Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
|
|
40
|
-
- Owner: `@jskit-ai/assistant-runtime@0.1.
|
|
40
|
+
- Owner: `@jskit-ai/assistant-runtime@0.1.193`
|
|
41
41
|
- Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
|
|
42
42
|
- Examples: [example/](patterns/assistant/assistant-surface/example/)
|
|
43
43
|
- Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
|
|
@@ -48,7 +48,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
|
|
|
48
48
|
|
|
49
49
|
- Id: `auth/auth-surface`
|
|
50
50
|
- Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
|
|
51
|
-
- Owner: `@jskit-ai/auth-web@0.1.
|
|
51
|
+
- Owner: `@jskit-ai/auth-web@0.1.222`
|
|
52
52
|
- Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
|
|
53
53
|
- Examples: [example/](patterns/auth/auth-surface/example/)
|
|
54
54
|
- Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
|
|
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
|
|
|
59
59
|
|
|
60
60
|
- Id: `auth/supabase-auth`
|
|
61
61
|
- Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
|
|
62
|
-
- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.
|
|
62
|
+
- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.219`
|
|
63
63
|
- Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
|
|
64
64
|
- Examples: [example/](patterns/auth/supabase-auth/example/)
|
|
65
65
|
- Requires: `@jskit-ai/auth-provider-supabase-core`
|
|
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
|
|
|
70
70
|
|
|
71
71
|
- Id: `connectors/ai-connections`
|
|
72
72
|
- Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
|
|
73
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
73
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
74
74
|
- Read: [PATTERN.md](patterns/connectors/ai-connections/PATTERN.md)
|
|
75
75
|
- Examples: [example/](patterns/connectors/ai-connections/example/)
|
|
76
76
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
|
|
|
81
81
|
|
|
82
82
|
- Id: `connectors/api-key-connection`
|
|
83
83
|
- Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
|
|
84
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
84
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
85
85
|
- Read: [PATTERN.md](patterns/connectors/api-key-connection/PATTERN.md)
|
|
86
86
|
- Examples: [example/](patterns/connectors/api-key-connection/example/)
|
|
87
87
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
|
|
|
92
92
|
|
|
93
93
|
- Id: `connectors/assistant-mcp`
|
|
94
94
|
- Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
|
|
95
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
95
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
96
96
|
- Read: [PATTERN.md](patterns/connectors/assistant-mcp/PATTERN.md)
|
|
97
97
|
- Examples: [example/](patterns/connectors/assistant-mcp/example/)
|
|
98
98
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
|
|
|
103
103
|
|
|
104
104
|
- Id: `connectors/assistant-mcp-oauth`
|
|
105
105
|
- Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
|
|
106
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
106
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
107
107
|
- Read: [PATTERN.md](patterns/connectors/assistant-mcp-oauth/PATTERN.md)
|
|
108
108
|
- Examples: [example/](patterns/connectors/assistant-mcp-oauth/example/)
|
|
109
109
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
|
|
|
114
114
|
|
|
115
115
|
- Id: `connectors/aws-storage-queries`
|
|
116
116
|
- Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
|
|
117
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
117
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
118
118
|
- Read: [PATTERN.md](patterns/connectors/aws-storage-queries/PATTERN.md)
|
|
119
119
|
- Examples: [example/](patterns/connectors/aws-storage-queries/example/)
|
|
120
120
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
|
|
|
125
125
|
|
|
126
126
|
- Id: `connectors/calendar-cli`
|
|
127
127
|
- Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
|
|
128
|
-
- Owner: `@jskit-ai/connector-google-calendar@0.1.
|
|
128
|
+
- Owner: `@jskit-ai/connector-google-calendar@0.1.39`
|
|
129
129
|
- Read: [PATTERN.md](patterns/connectors/calendar-cli/PATTERN.md)
|
|
130
130
|
- Examples: [example/](patterns/connectors/calendar-cli/example/)
|
|
131
131
|
- Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
|
|
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
|
|
|
136
136
|
|
|
137
137
|
- Id: `connectors/event-delivery`
|
|
138
138
|
- Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
|
|
139
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
139
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
140
140
|
- Read: [PATTERN.md](patterns/connectors/event-delivery/PATTERN.md)
|
|
141
141
|
- Examples: [example/](patterns/connectors/event-delivery/example/)
|
|
142
142
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
|
|
|
147
147
|
|
|
148
148
|
- Id: `connectors/firebase-messaging`
|
|
149
149
|
- Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
|
|
150
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
150
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
151
151
|
- Read: [PATTERN.md](patterns/connectors/firebase-messaging/PATTERN.md)
|
|
152
152
|
- Examples: [example/](patterns/connectors/firebase-messaging/example/)
|
|
153
153
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
|
|
|
158
158
|
|
|
159
159
|
- Id: `connectors/google-ads-search`
|
|
160
160
|
- Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
|
|
161
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
161
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
162
162
|
- Read: [PATTERN.md](patterns/connectors/google-ads-search/PATTERN.md)
|
|
163
163
|
- Examples: [example/](patterns/connectors/google-ads-search/example/)
|
|
164
164
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
|
|
|
169
169
|
|
|
170
170
|
- Id: `connectors/oauth-connection`
|
|
171
171
|
- Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
|
|
172
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
172
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
173
173
|
- Read: [PATTERN.md](patterns/connectors/oauth-connection/PATTERN.md)
|
|
174
174
|
- Examples: [example/](patterns/connectors/oauth-connection/example/)
|
|
175
175
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
|
|
|
180
180
|
|
|
181
181
|
- Id: `connectors/paddle-catalogue`
|
|
182
182
|
- Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
|
|
183
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
183
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
184
184
|
- Read: [PATTERN.md](patterns/connectors/paddle-catalogue/PATTERN.md)
|
|
185
185
|
- Examples: [example/](patterns/connectors/paddle-catalogue/example/)
|
|
186
186
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
|
|
|
191
191
|
|
|
192
192
|
- Id: `connectors/public-image`
|
|
193
193
|
- Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
|
|
194
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
194
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
195
195
|
- Read: [PATTERN.md](patterns/connectors/public-image/PATTERN.md)
|
|
196
196
|
- Examples: [example/](patterns/connectors/public-image/example/)
|
|
197
197
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
|
|
|
202
202
|
|
|
203
203
|
- Id: `connectors/redshift-queries`
|
|
204
204
|
- Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
|
|
205
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
205
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
206
206
|
- Read: [PATTERN.md](patterns/connectors/redshift-queries/PATTERN.md)
|
|
207
207
|
- Examples: [example/](patterns/connectors/redshift-queries/example/)
|
|
208
208
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
|
|
|
213
213
|
|
|
214
214
|
- Id: `connectors/source-scanning`
|
|
215
215
|
- Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
|
|
216
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
216
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.39`
|
|
217
217
|
- Read: [PATTERN.md](patterns/connectors/source-scanning/PATTERN.md)
|
|
218
218
|
- Examples: [example/](patterns/connectors/source-scanning/example/)
|
|
219
219
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
|
|
|
224
224
|
|
|
225
225
|
- Id: `console/console-surface`
|
|
226
226
|
- Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
|
|
227
|
-
- Owner: `@jskit-ai/console-web@0.1.
|
|
227
|
+
- Owner: `@jskit-ai/console-web@0.1.190`
|
|
228
228
|
- Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
|
|
229
229
|
- Examples: [example/](patterns/console/console-surface/example/)
|
|
230
230
|
- Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
|
|
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
|
|
|
235
235
|
|
|
236
236
|
- Id: `crud/crud-screen-set`
|
|
237
237
|
- Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
|
|
238
|
-
- Owner: `@jskit-ai/http-web@0.1.
|
|
238
|
+
- Owner: `@jskit-ai/http-web@0.1.67`
|
|
239
239
|
- Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
|
|
240
240
|
- Examples: [example/](patterns/crud/crud-screen-set/example/)
|
|
241
241
|
- Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
|
|
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
|
|
|
246
246
|
|
|
247
247
|
- Id: `crud/json-api-resource-package`
|
|
248
248
|
- Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
|
|
249
|
-
- Owner: `@jskit-ai/crud-core@0.1.
|
|
249
|
+
- Owner: `@jskit-ai/crud-core@0.1.233`
|
|
250
250
|
- Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
|
|
251
251
|
- Examples: [example/](patterns/crud/json-api-resource-package/example/)
|
|
252
252
|
- Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
|
|
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
|
|
|
257
257
|
|
|
258
258
|
- Id: `crud/resource-contract`
|
|
259
259
|
- Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
|
|
260
|
-
- Owner: `@jskit-ai/resource-crud-core@0.1.
|
|
260
|
+
- Owner: `@jskit-ai/resource-crud-core@0.1.164`
|
|
261
261
|
- Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
|
|
262
262
|
- Examples: [example/](patterns/crud/resource-contract/example/)
|
|
263
263
|
- Requires: `@jskit-ai/resource-crud-core`
|
|
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
|
|
|
268
268
|
|
|
269
269
|
- Id: `database/mysql-application`
|
|
270
270
|
- Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
|
|
271
|
-
- Owner: `@jskit-ai/database-runtime-mysql@0.1.
|
|
271
|
+
- Owner: `@jskit-ai/database-runtime-mysql@0.1.220`
|
|
272
272
|
- Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
|
|
273
273
|
- Examples: [example/](patterns/database/mysql-application/example/)
|
|
274
274
|
- Requires: `@jskit-ai/database-runtime-mysql`
|
|
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
|
|
|
279
279
|
|
|
280
280
|
- Id: `database/postgres-application`
|
|
281
281
|
- Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
|
|
282
|
-
- Owner: `@jskit-ai/database-runtime-postgres@0.1.
|
|
282
|
+
- Owner: `@jskit-ai/database-runtime-postgres@0.1.219`
|
|
283
283
|
- Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
|
|
284
284
|
- Examples: [example/](patterns/database/postgres-application/example/)
|
|
285
285
|
- Requires: `@jskit-ai/database-runtime-postgres`
|
|
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
|
|
|
290
290
|
|
|
291
291
|
- Id: `mobile/android-application`
|
|
292
292
|
- Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
|
|
293
|
-
- Owner: `@jskit-ai/mobile-capacitor@0.1.
|
|
293
|
+
- Owner: `@jskit-ai/mobile-capacitor@0.1.157`
|
|
294
294
|
- Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
|
|
295
295
|
- Examples: [example/](patterns/mobile/android-application/example/)
|
|
296
296
|
- Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
|
|
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
|
|
|
301
301
|
|
|
302
302
|
- Id: `realtime/realtime-application`
|
|
303
303
|
- Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
|
|
304
|
-
- Owner: `@jskit-ai/realtime@0.1.
|
|
304
|
+
- Owner: `@jskit-ai/realtime@0.1.219`
|
|
305
305
|
- Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
|
|
306
306
|
- Examples: [example/](patterns/realtime/realtime-application/example/)
|
|
307
307
|
- Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
|
|
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
|
|
|
312
312
|
|
|
313
313
|
- Id: `rewards/google-rewarded`
|
|
314
314
|
- Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
|
|
315
|
-
- Owner: `@jskit-ai/rewarded-web@0.1.
|
|
315
|
+
- Owner: `@jskit-ai/rewarded-web@0.1.158`
|
|
316
316
|
- Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
|
|
317
317
|
- Examples: [example/](patterns/rewards/google-rewarded/example/)
|
|
318
318
|
- Requires: `@jskit-ai/rewarded-web`
|
|
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
|
|
|
323
323
|
|
|
324
324
|
- Id: `server/feature-package`
|
|
325
325
|
- Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
|
|
326
|
-
- Owner: `@jskit-ai/agent-docs@0.1.
|
|
326
|
+
- Owner: `@jskit-ai/agent-docs@0.1.194`
|
|
327
327
|
- Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
|
|
328
328
|
- Examples: [example/](patterns/server/feature-package/example/)
|
|
329
329
|
- Requires: `@jskit-ai/kernel`
|
|
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
|
|
|
334
334
|
|
|
335
335
|
- Id: `shell/application-shell`
|
|
336
336
|
- Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
|
|
337
|
-
- Owner: `@jskit-ai/shell-web@0.1.
|
|
337
|
+
- Owner: `@jskit-ai/shell-web@0.1.226`
|
|
338
338
|
- Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
|
|
339
339
|
- Examples: [example/](patterns/shell/application-shell/example/)
|
|
340
340
|
- Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
|
|
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
|
|
|
345
345
|
|
|
346
346
|
- Id: `ui/page-and-placement`
|
|
347
347
|
- Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
|
|
348
|
-
- Owner: `@jskit-ai/shell-web@0.1.
|
|
348
|
+
- Owner: `@jskit-ai/shell-web@0.1.226`
|
|
349
349
|
- Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
|
|
350
350
|
- Examples: [example/](patterns/ui/page-and-placement/example/)
|
|
351
351
|
- Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
|
|
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
|
|
|
356
356
|
|
|
357
357
|
- Id: `users/account-settings`
|
|
358
358
|
- Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
|
|
359
|
-
- Owner: `@jskit-ai/users-web@0.1.
|
|
359
|
+
- Owner: `@jskit-ai/users-web@0.1.240`
|
|
360
360
|
- Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
|
|
361
361
|
- Examples: [example/](patterns/users/account-settings/example/)
|
|
362
362
|
- Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
|
|
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
|
|
|
367
367
|
|
|
368
368
|
- Id: `users/user-administration-server`
|
|
369
369
|
- Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
|
|
370
|
-
- Owner: `@jskit-ai/users-core@0.1.
|
|
370
|
+
- Owner: `@jskit-ai/users-core@0.1.235`
|
|
371
371
|
- Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
|
|
372
372
|
- Examples: [example/](patterns/users/user-administration-server/example/)
|
|
373
373
|
- Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
|
|
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
|
|
|
378
378
|
|
|
379
379
|
- Id: `workspaces/workspace-server`
|
|
380
380
|
- Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
|
|
381
|
-
- Owner: `@jskit-ai/workspaces-core@0.1.
|
|
381
|
+
- Owner: `@jskit-ai/workspaces-core@0.1.200`
|
|
382
382
|
- Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
|
|
383
383
|
- Examples: [example/](patterns/workspaces/workspace-server/example/)
|
|
384
384
|
- Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
|
|
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
|
|
|
389
389
|
|
|
390
390
|
- Id: `workspaces/workspace-surfaces`
|
|
391
391
|
- Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
|
|
392
|
-
- Owner: `@jskit-ai/workspaces-web@0.1.
|
|
392
|
+
- Owner: `@jskit-ai/workspaces-web@0.1.201`
|
|
393
393
|
- Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
|
|
394
394
|
- Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
|
|
395
395
|
- Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"dependencies": {
|
|
35
35
|
"@local/main": "0.1.0",
|
|
36
36
|
"@fastify/static": "^10.1.3",
|
|
37
|
-
"@jskit-ai/kernel": "0.1.
|
|
37
|
+
"@jskit-ai/kernel": "0.1.222",
|
|
38
38
|
"@tanstack/vue-query": "^5.101.0",
|
|
39
39
|
"fastify": "^5.8.5",
|
|
40
40
|
"json-rest-schema": "^1.0.17",
|
|
@@ -42,13 +42,13 @@
|
|
|
42
42
|
"vue": "^3.5.43",
|
|
43
43
|
"vue-router": "^5.3.1",
|
|
44
44
|
"vuetify": "^4.1.2",
|
|
45
|
-
"@jskit-ai/http-runtime": "0.1.
|
|
45
|
+
"@jskit-ai/http-runtime": "0.1.220",
|
|
46
46
|
"@fastify/fast-json-stringify-compiler": "^5.1.0",
|
|
47
47
|
"@vue/devtools-api": "^8.2.1"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
|
-
"@jskit-ai/config-eslint": "0.1.
|
|
51
|
-
"@jskit-ai/jskit-catalog": "0.1.
|
|
50
|
+
"@jskit-ai/config-eslint": "0.1.219",
|
|
51
|
+
"@jskit-ai/jskit-catalog": "0.1.247",
|
|
52
52
|
"@playwright/test": "1.61.1",
|
|
53
53
|
"@vitejs/plugin-vue": "^6.0.7",
|
|
54
54
|
"eslint": "^10.8.0",
|