@cat-factory/integrations 0.146.0 → 0.148.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +6 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/modules/accountSettings/AccountSettingsService.d.ts.map +1 -1
- package/dist/modules/accountSettings/AccountSettingsService.js +4 -2
- package/dist/modules/accountSettings/AccountSettingsService.js.map +1 -1
- package/dist/modules/documents/ConfluenceProvider.d.ts +3 -0
- package/dist/modules/documents/ConfluenceProvider.d.ts.map +1 -1
- package/dist/modules/documents/DocumentConnectionService.d.ts +86 -5
- package/dist/modules/documents/DocumentConnectionService.d.ts.map +1 -1
- package/dist/modules/documents/DocumentConnectionService.js +103 -14
- package/dist/modules/documents/DocumentConnectionService.js.map +1 -1
- package/dist/modules/documents/DocumentLinkService.d.ts +28 -1
- package/dist/modules/documents/DocumentLinkService.d.ts.map +1 -1
- package/dist/modules/documents/DocumentLinkService.js +78 -10
- package/dist/modules/documents/DocumentLinkService.js.map +1 -1
- package/dist/modules/documents/DocumentPlannerService.d.ts +11 -2
- package/dist/modules/documents/DocumentPlannerService.d.ts.map +1 -1
- package/dist/modules/documents/DocumentPlannerService.js +95 -12
- package/dist/modules/documents/DocumentPlannerService.js.map +1 -1
- package/dist/modules/documents/DocumentSourceOAuthService.d.ts +88 -0
- package/dist/modules/documents/DocumentSourceOAuthService.d.ts.map +1 -0
- package/dist/modules/documents/DocumentSourceOAuthService.js +197 -0
- package/dist/modules/documents/DocumentSourceOAuthService.js.map +1 -0
- package/dist/modules/documents/FigmaProvider.d.ts +10 -0
- package/dist/modules/documents/FigmaProvider.d.ts.map +1 -1
- package/dist/modules/documents/FigmaProvider.js +17 -6
- package/dist/modules/documents/FigmaProvider.js.map +1 -1
- package/dist/modules/documents/GitHubDocsProvider.d.ts +3 -0
- package/dist/modules/documents/GitHubDocsProvider.d.ts.map +1 -1
- package/dist/modules/documents/LinearDocumentProvider.d.ts +3 -0
- package/dist/modules/documents/LinearDocumentProvider.d.ts.map +1 -1
- package/dist/modules/documents/LinkedDocumentRefreshService.d.ts +14 -5
- package/dist/modules/documents/LinkedDocumentRefreshService.d.ts.map +1 -1
- package/dist/modules/documents/LinkedDocumentRefreshService.js +39 -22
- package/dist/modules/documents/LinkedDocumentRefreshService.js.map +1 -1
- package/dist/modules/documents/NotionProvider.d.ts +3 -0
- package/dist/modules/documents/NotionProvider.d.ts.map +1 -1
- package/dist/modules/documents/ZeplinProvider.d.ts +3 -0
- package/dist/modules/documents/ZeplinProvider.d.ts.map +1 -1
- package/dist/modules/documents/documentConnectionStore.d.ts +19 -0
- package/dist/modules/documents/documentConnectionStore.d.ts.map +1 -0
- package/dist/modules/documents/documentConnectionStore.js +17 -0
- package/dist/modules/documents/documentConnectionStore.js.map +1 -0
- package/dist/modules/documents/documents.logic.d.ts +44 -3
- package/dist/modules/documents/documents.logic.d.ts.map +1 -1
- package/dist/modules/documents/documents.logic.js +90 -5
- package/dist/modules/documents/documents.logic.js.map +1 -1
- package/dist/modules/documents/figma.logic.d.ts +10 -2
- package/dist/modules/documents/figma.logic.d.ts.map +1 -1
- package/dist/modules/documents/figma.logic.js +30 -2
- package/dist/modules/documents/figma.logic.js.map +1 -1
- package/dist/modules/github/GitHubInstallationService.d.ts +8 -1
- package/dist/modules/github/GitHubInstallationService.d.ts.map +1 -1
- package/dist/modules/github/GitHubInstallationService.js +4 -3
- package/dist/modules/github/GitHubInstallationService.js.map +1 -1
- package/dist/modules/shared/sealedConnectionStore.d.ts +100 -0
- package/dist/modules/shared/sealedConnectionStore.d.ts.map +1 -0
- package/dist/modules/shared/sealedConnectionStore.js +118 -0
- package/dist/modules/shared/sealedConnectionStore.js.map +1 -0
- package/dist/modules/tasks/BugHuntService.d.ts +2 -2
- package/dist/modules/tasks/BugHuntService.d.ts.map +1 -1
- package/dist/modules/tasks/BugHuntService.js +1 -1
- package/dist/modules/tasks/BugHuntService.js.map +1 -1
- package/dist/modules/tasks/BugIntakeService.d.ts +2 -2
- package/dist/modules/tasks/BugIntakeService.d.ts.map +1 -1
- package/dist/modules/tasks/BugIntakeService.js +1 -1
- package/dist/modules/tasks/BugIntakeService.js.map +1 -1
- package/dist/modules/tasks/TaskConnectionService.d.ts +43 -4
- package/dist/modules/tasks/TaskConnectionService.d.ts.map +1 -1
- package/dist/modules/tasks/TaskConnectionService.js +122 -22
- package/dist/modules/tasks/TaskConnectionService.js.map +1 -1
- package/dist/modules/tasks/TrackerWebhookService.d.ts +2 -2
- package/dist/modules/tasks/TrackerWebhookService.d.ts.map +1 -1
- package/dist/modules/tasks/TrackerWebhookService.js +1 -1
- package/dist/modules/tasks/TrackerWebhookService.js.map +1 -1
- package/dist/modules/tasks/taskConnectionStore.d.ts +18 -0
- package/dist/modules/tasks/taskConnectionStore.d.ts.map +1 -0
- package/dist/modules/tasks/taskConnectionStore.js +17 -0
- package/dist/modules/tasks/taskConnectionStore.js.map +1 -0
- package/dist/modules/vcs/VcsPatConnectionService.d.ts +9 -1
- package/dist/modules/vcs/VcsPatConnectionService.d.ts.map +1 -1
- package/dist/modules/vcs/VcsPatConnectionService.js +4 -3
- package/dist/modules/vcs/VcsPatConnectionService.js.map +1 -1
- package/dist/modules/writeback/IssueWritebackService.d.ts +7 -2
- package/dist/modules/writeback/IssueWritebackService.d.ts.map +1 -1
- package/dist/modules/writeback/IssueWritebackService.js +31 -11
- package/dist/modules/writeback/IssueWritebackService.js.map +1 -1
- package/package.json +4 -4
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DocumentConnectionService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentConnectionService.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"DocumentConnectionService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentConnectionService.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,6 +3,7 @@ import type { BlockEditAuthority } from '@cat-factory/contracts';
|
|
|
3
3
|
import type { BlockRepository } from '@cat-factory/kernel';
|
|
4
4
|
import type { DocumentRepository } from '@cat-factory/kernel';
|
|
5
5
|
import type { BoardWritePort } from '@cat-factory/kernel';
|
|
6
|
+
import type { PlanTarget } from './documents.logic.js';
|
|
6
7
|
export interface DocumentLinkServiceDependencies {
|
|
7
8
|
boardService: BoardWritePort;
|
|
8
9
|
blockRepository: BlockRepository;
|
|
@@ -13,10 +14,29 @@ export interface SpawnResult {
|
|
|
13
14
|
frames: number;
|
|
14
15
|
modules: number;
|
|
15
16
|
tasks: number;
|
|
17
|
+
/**
|
|
18
|
+
* Planned modules whose tasks went into a module the frame ALREADY had, rather than into a new
|
|
19
|
+
* one (see {@link DocumentLinkService.spawnInto}).
|
|
20
|
+
*
|
|
21
|
+
* Reported rather than folded into `modules`, because the two answer different questions and
|
|
22
|
+
* only one of them is about what changed. Without it a spawn that reused every module reports
|
|
23
|
+
* "0 modules · 12 tasks" against a preview that showed three, which reads as three modules
|
|
24
|
+
* having failed; and counting a reuse as a creation would claim a write that never happened.
|
|
25
|
+
*/
|
|
26
|
+
reusedModules: number;
|
|
16
27
|
}
|
|
17
28
|
export declare class DocumentLinkService {
|
|
18
29
|
private readonly deps;
|
|
19
30
|
constructor(deps: DocumentLinkServiceDependencies);
|
|
31
|
+
/**
|
|
32
|
+
* Describe an existing service frame as a {@link PlanTarget}, so a plan can be authored FOR it.
|
|
33
|
+
*
|
|
34
|
+
* It lives here rather than in the planner because it is a fact about the BOARD: the planner is
|
|
35
|
+
* a pure document→structure translator and must not learn to query blocks for a prompt detail.
|
|
36
|
+
* It refuses exactly what {@link spawn} refuses, one step earlier, so a preview cannot be
|
|
37
|
+
* rendered against a target the write would then reject.
|
|
38
|
+
*/
|
|
39
|
+
resolvePlanTarget(workspaceId: string, frameId: string): Promise<PlanTarget>;
|
|
20
40
|
/**
|
|
21
41
|
* Apply a board plan to a workspace. Without `frameId` each planned frame
|
|
22
42
|
* becomes a new top-level frame; with it, the plan's modules and tasks are
|
|
@@ -27,7 +47,14 @@ export declare class DocumentLinkService {
|
|
|
27
47
|
* comes from the caller rather than being decided here (see {@link BlockEditAuthority}).
|
|
28
48
|
*/
|
|
29
49
|
spawn(workspaceId: string, plan: DocumentBoardPlan, editor: BlockEditAuthority, frameId?: string): Promise<SpawnResult>;
|
|
30
|
-
/**
|
|
50
|
+
/**
|
|
51
|
+
* Add a planned frame's modules and tasks inside an existing frame.
|
|
52
|
+
*
|
|
53
|
+
* `modulesByName` is the frame's modules indexed by {@link moduleKey}, and it is both the input
|
|
54
|
+
* and the running record: a module created here is registered in it, so two planned modules that
|
|
55
|
+
* name the same thing converge on one block exactly as a planned name matching a pre-existing
|
|
56
|
+
* module does. A freshly created frame passes an empty map and every module is new.
|
|
57
|
+
*/
|
|
31
58
|
private spawnInto;
|
|
32
59
|
private addTask;
|
|
33
60
|
/** Attach an imported (or uploaded) document to a board block as extra agent context. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DocumentLinkService.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/DocumentLinkService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACX,cAAc,EACd,cAAc,EAEf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;
|
|
1
|
+
{"version":3,"file":"DocumentLinkService.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/DocumentLinkService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACX,cAAc,EACd,cAAc,EAEf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAatD,MAAM,WAAW,+BAA+B;IAC9C,YAAY,EAAE,cAAc,CAAA;IAC5B,eAAe,EAAE,eAAe,CAAA;IAChC,kBAAkB,EAAE,kBAAkB,CAAA;CACvC;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAA;CACtB;AAcD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,+BAA+B,EAAI;IAEtE;;;;;;;OAOG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBjF;IAED;;;;;;;;OAQG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CA+CtB;IAED;;;;;;;OAOG;YACW,SAAS;YAiCT,OAAO;IA4BrB,yFAAyF;IACnF,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAGzB;IAED;;;;;;;;OAQG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,WAAW,EAAE,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC,CAqB3B;IAED;;;;;;;;;;;;OAYG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;IAED;;;;;;;;;;;;OAYG;YACW,sBAAsB;IA0BpC;;;;;;OAMG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,CAAC,CAWzB;IAED,oGAAoG;IAC9F,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,gGAAgG;IAC1F,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAGlE;CACF"}
|
|
@@ -4,11 +4,49 @@ import { toSourceDocument } from './DocumentImportService.js';
|
|
|
4
4
|
function refKey(ref) {
|
|
5
5
|
return `${ref.source}:${ref.externalId}`;
|
|
6
6
|
}
|
|
7
|
+
/**
|
|
8
|
+
* The key a planned module name is matched against an existing one by.
|
|
9
|
+
*
|
|
10
|
+
* Case- and whitespace-insensitive on purpose: the planner is TOLD to reuse the names it was
|
|
11
|
+
* shown, but the thing being asked is a language model, and "Checkout" against "checkout" is a
|
|
12
|
+
* duplicate module on the board either way. Matching exactly would make the reuse work in testing
|
|
13
|
+
* and fail on the drift it exists to absorb.
|
|
14
|
+
*/
|
|
15
|
+
function moduleKey(name) {
|
|
16
|
+
return name.trim().toLowerCase();
|
|
17
|
+
}
|
|
7
18
|
export class DocumentLinkService {
|
|
8
19
|
deps;
|
|
9
20
|
constructor(deps) {
|
|
10
21
|
this.deps = deps;
|
|
11
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* Describe an existing service frame as a {@link PlanTarget}, so a plan can be authored FOR it.
|
|
25
|
+
*
|
|
26
|
+
* It lives here rather than in the planner because it is a fact about the BOARD: the planner is
|
|
27
|
+
* a pure document→structure translator and must not learn to query blocks for a prompt detail.
|
|
28
|
+
* It refuses exactly what {@link spawn} refuses, one step earlier, so a preview cannot be
|
|
29
|
+
* rendered against a target the write would then reject.
|
|
30
|
+
*/
|
|
31
|
+
async resolvePlanTarget(workspaceId, frameId) {
|
|
32
|
+
const frame = assertFound(await this.deps.blockRepository.get(workspaceId, frameId), 'Block', frameId);
|
|
33
|
+
if (frame.level !== 'frame') {
|
|
34
|
+
throw new ValidationError('Document structure can only be planned into a service frame', {
|
|
35
|
+
reason: 'plan_target_not_a_frame',
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
const blocks = await this.deps.blockRepository.listByWorkspace(workspaceId);
|
|
39
|
+
return {
|
|
40
|
+
frameId,
|
|
41
|
+
title: frame.title,
|
|
42
|
+
type: frame.type,
|
|
43
|
+
// The names the frame ALREADY holds, so the plan adds beside them instead of proposing a
|
|
44
|
+
// second module meaning the same thing. One board read rather than a per-module lookup.
|
|
45
|
+
existingModules: blocks
|
|
46
|
+
.filter((b) => b.parentId === frameId && b.level === 'module')
|
|
47
|
+
.map((b) => b.title),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
12
50
|
/**
|
|
13
51
|
* Apply a board plan to a workspace. Without `frameId` each planned frame
|
|
14
52
|
* becomes a new top-level frame; with it, the plan's modules and tasks are
|
|
@@ -19,14 +57,22 @@ export class DocumentLinkService {
|
|
|
19
57
|
* comes from the caller rather than being decided here (see {@link BlockEditAuthority}).
|
|
20
58
|
*/
|
|
21
59
|
async spawn(workspaceId, plan, editor, frameId) {
|
|
22
|
-
const result = { frames: 0, modules: 0, tasks: 0 };
|
|
60
|
+
const result = { frames: 0, modules: 0, tasks: 0, reusedModules: 0 };
|
|
23
61
|
if (frameId) {
|
|
24
62
|
const target = assertFound(await this.deps.blockRepository.get(workspaceId, frameId), 'Block', frameId);
|
|
25
63
|
if (target.level !== 'frame') {
|
|
26
64
|
throw new ValidationError('Document structure can only be spawned into a service frame');
|
|
27
65
|
}
|
|
66
|
+
// The frame's existing modules, read ONCE for the whole spawn and indexed by name. This is
|
|
67
|
+
// the write half of what `resolvePlanTarget` showed the planner: the prompt asks the model to
|
|
68
|
+
// reuse the names it was given, and until this existed nothing acted on the answer, so a plan
|
|
69
|
+
// that obeyed produced a second "Checkout" beside the first. A model's cooperation is not an
|
|
70
|
+
// implementation — the platform has to COMPUTE the reuse.
|
|
71
|
+
const existing = new Map((await this.deps.blockRepository.listByWorkspace(workspaceId))
|
|
72
|
+
.filter((block) => block.parentId === frameId && block.level === 'module')
|
|
73
|
+
.map((block) => [moduleKey(block.title), block.id]));
|
|
28
74
|
for (const frame of plan.frames) {
|
|
29
|
-
await this.spawnInto(workspaceId, target.id, frame, result, editor);
|
|
75
|
+
await this.spawnInto(workspaceId, target.id, frame, result, editor, existing);
|
|
30
76
|
}
|
|
31
77
|
return result;
|
|
32
78
|
}
|
|
@@ -39,22 +85,44 @@ export class DocumentLinkService {
|
|
|
39
85
|
column += 1;
|
|
40
86
|
result.frames += 1;
|
|
41
87
|
await this.deps.boardService.updateBlock(workspaceId, created.id, { title: frame.title, ...(frame.description ? { description: frame.description } : {}) }, editor);
|
|
42
|
-
|
|
88
|
+
// A frame created a line ago holds nothing, so its index starts empty; it still travels,
|
|
89
|
+
// because two planned modules within ONE frame can name the same thing.
|
|
90
|
+
await this.spawnInto(workspaceId, created.id, frame, result, editor, new Map());
|
|
43
91
|
}
|
|
44
92
|
return result;
|
|
45
93
|
}
|
|
46
|
-
/**
|
|
47
|
-
|
|
94
|
+
/**
|
|
95
|
+
* Add a planned frame's modules and tasks inside an existing frame.
|
|
96
|
+
*
|
|
97
|
+
* `modulesByName` is the frame's modules indexed by {@link moduleKey}, and it is both the input
|
|
98
|
+
* and the running record: a module created here is registered in it, so two planned modules that
|
|
99
|
+
* name the same thing converge on one block exactly as a planned name matching a pre-existing
|
|
100
|
+
* module does. A freshly created frame passes an empty map and every module is new.
|
|
101
|
+
*/
|
|
102
|
+
async spawnInto(workspaceId, frameId, frame, result, editor, modulesByName) {
|
|
48
103
|
for (const task of frame.tasks) {
|
|
49
104
|
await this.addTask(workspaceId, frameId, task, result, editor);
|
|
50
105
|
}
|
|
51
106
|
for (const planModule of frame.modules) {
|
|
52
|
-
const
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
107
|
+
const key = moduleKey(planModule.name);
|
|
108
|
+
// A module with nothing but whitespace for a name is not a module to reuse OR to key on: it
|
|
109
|
+
// would collapse every such module onto one block. Treated as its own new module each time.
|
|
110
|
+
const reused = key ? modulesByName.get(key) : undefined;
|
|
111
|
+
let moduleId = reused;
|
|
112
|
+
if (moduleId === undefined) {
|
|
113
|
+
const created = await this.deps.boardService.addModule(workspaceId, frameId, {
|
|
114
|
+
name: planModule.name,
|
|
115
|
+
});
|
|
116
|
+
moduleId = created.id;
|
|
117
|
+
result.modules += 1;
|
|
118
|
+
if (key)
|
|
119
|
+
modulesByName.set(key, moduleId);
|
|
120
|
+
}
|
|
121
|
+
else {
|
|
122
|
+
result.reusedModules += 1;
|
|
123
|
+
}
|
|
56
124
|
for (const task of planModule.tasks) {
|
|
57
|
-
await this.addTask(workspaceId,
|
|
125
|
+
await this.addTask(workspaceId, moduleId, task, result, editor);
|
|
58
126
|
}
|
|
59
127
|
}
|
|
60
128
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DocumentLinkService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentLinkService.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAIjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;
|
|
1
|
+
{"version":3,"file":"DocumentLinkService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentLinkService.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { ModelProvider, ModelProviderResolver, ModelRef } from '@cat-factory/kernel';
|
|
2
2
|
import type { DocumentRecord } from '@cat-factory/kernel';
|
|
3
3
|
import type { DocumentBoardPlan } from '@cat-factory/kernel';
|
|
4
|
+
import { type PlanTarget } from './documents.logic.js';
|
|
4
5
|
export interface DocumentPlannerServiceDependencies {
|
|
5
6
|
/**
|
|
6
7
|
* Resolve a {@link ModelProvider} for a workspace's credential scope (DB-backed key
|
|
@@ -17,7 +18,15 @@ export declare class DocumentPlannerService {
|
|
|
17
18
|
constructor(deps: DocumentPlannerServiceDependencies);
|
|
18
19
|
/** Whether LLM planning is available (a model provider/resolver + ref are configured). */
|
|
19
20
|
get llmEnabled(): boolean;
|
|
20
|
-
/**
|
|
21
|
-
|
|
21
|
+
/**
|
|
22
|
+
* Propose a board structure for an imported document, either at the board root or inside an
|
|
23
|
+
* existing service frame.
|
|
24
|
+
*
|
|
25
|
+
* The fallback is always the same SHAPE as the request: a targeted plan that could not be
|
|
26
|
+
* produced degrades to the targeted heading parser, never to a board-wide plan, because the
|
|
27
|
+
* caller is about to spawn into one frame and a whole architecture flattened into it is the
|
|
28
|
+
* discarding the target-aware path exists to prevent.
|
|
29
|
+
*/
|
|
30
|
+
plan(record: DocumentRecord, target?: PlanTarget): Promise<DocumentBoardPlan>;
|
|
22
31
|
}
|
|
23
32
|
//# sourceMappingURL=DocumentPlannerService.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DocumentPlannerService.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/DocumentPlannerService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;
|
|
1
|
+
{"version":3,"file":"DocumentPlannerService.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/DocumentPlannerService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAA;AAuB7B,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,0FAA0F;IAC1F,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AA+FD,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,kCAAkC,EAAI;IAEzE,0FAA0F;IAC1F,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;;;;;OAQG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsClF;CACF"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { generateText } from 'ai';
|
|
2
2
|
import { catFactoryObservability, extractJson } from '@cat-factory/kernel';
|
|
3
|
-
import {
|
|
3
|
+
import { isDesignSource } from '@cat-factory/contracts';
|
|
4
|
+
import { coercePlan, coerceTargetedPlan, markdownToText, planFromHeadings, } from './documents.logic.js';
|
|
4
5
|
// DocumentPlannerService: turns an imported document into a proposed board
|
|
5
6
|
// structure (frames → modules → tasks). When a model is configured it asks an
|
|
6
7
|
// LLM, via the provider-agnostic ModelProvider port, to extract the structure;
|
|
@@ -8,17 +9,56 @@ import { coercePlan, markdownToText, planFromHeadings } from './documents.logic.
|
|
|
8
9
|
// deterministic heading parser. The LLM is therefore optional: import, link and
|
|
9
10
|
// spawn all work without it. Source-agnostic, because providers normalize bodies
|
|
10
11
|
// to Markdown before they reach here.
|
|
12
|
+
//
|
|
13
|
+
// Two axes decide which prompt runs, and they are independent:
|
|
14
|
+
//
|
|
15
|
+
// - TARGET. Without a {@link PlanTarget} the question is "what architecture does this document
|
|
16
|
+
// describe"; with one it is "what work does it imply inside this service that already exists".
|
|
17
|
+
// They are different prompts rather than one prompt with a hint, because the answers have
|
|
18
|
+
// different shapes: the first proposes frames, the second may not propose any.
|
|
19
|
+
// - ORIGIN. A design document describes screens, not an architecture, so asking the
|
|
20
|
+
// architecture question of one produces a service per Figma page. `isDesignSource` decides,
|
|
21
|
+
// read from CONTRACTS rather than from a provider, for the same reason the design-guidance
|
|
22
|
+
// fragment reads it there: this path holds a stored row and no provider.
|
|
11
23
|
const MAX_BODY_CHARS = 6000;
|
|
12
24
|
const SYSTEM_PROMPT = 'You are a software architect. You convert a product/requirements/RFC document into a ' +
|
|
13
25
|
'concrete software-architecture board: top-level frames (services), modules within them, ' +
|
|
14
26
|
'and tasks (units of work). Respond with ONLY a JSON object, no prose, no code fences.';
|
|
15
|
-
|
|
16
|
-
|
|
27
|
+
/**
|
|
28
|
+
* The targeted system prompt. It states the ONE thing the board-wide prompt must not be allowed
|
|
29
|
+
* to carry over: the service exists, so proposing services is out of scope. Without that said
|
|
30
|
+
* outright, a model handed a document and a frame name routinely answers with an architecture
|
|
31
|
+
* whose first frame happens to be the target.
|
|
32
|
+
*/
|
|
33
|
+
const TARGETED_SYSTEM_PROMPT = 'You are a technical lead planning work inside a service that ALREADY EXISTS. You never ' +
|
|
34
|
+
'propose new services or repositories; you propose modules (groupings) and tasks (units of ' +
|
|
35
|
+
'work) to add to the service you are given. Respond with ONLY a JSON object, no prose, no ' +
|
|
36
|
+
'code fences.';
|
|
37
|
+
/**
|
|
38
|
+
* What a DESIGN document is, said to the model in the terms it must plan in.
|
|
39
|
+
*
|
|
40
|
+
* Folded into both prompts rather than replacing them, because the change a design origin makes
|
|
41
|
+
* is to the SUBJECT, not to the shape of the answer: the document describes screens and flows,
|
|
42
|
+
* and one task per screen/flow is the decomposition an implementer can act on. The alternative,
|
|
43
|
+
* a whole third prompt pair, would duplicate the JSON contract in four places.
|
|
44
|
+
*/
|
|
45
|
+
const DESIGN_GUIDANCE = [
|
|
46
|
+
'This document is a DESIGN (frames, components and tokens exported from a design tool), not a',
|
|
47
|
+
'written specification. Plan the work it implies to BUILD it: one task per screen, state or',
|
|
48
|
+
'flow it shows, named after the frame it comes from so an implementer can find it in the file.',
|
|
49
|
+
'Do not propose tasks for design work itself, and do not invent backend services the design',
|
|
50
|
+
'does not evidence — a design describes an interface, and what sits behind it is not in it.',
|
|
51
|
+
].join(' ');
|
|
52
|
+
function documentText(record) {
|
|
53
|
+
return markdownToText(record.body).slice(0, MAX_BODY_CHARS);
|
|
54
|
+
}
|
|
55
|
+
function buildUserPrompt(record) {
|
|
17
56
|
return [
|
|
18
|
-
`Document title: ${title}`,
|
|
57
|
+
`Document title: ${record.title}`,
|
|
58
|
+
...(isDesignSource(record.source) ? ['', DESIGN_GUIDANCE] : []),
|
|
19
59
|
'',
|
|
20
60
|
'Document content:',
|
|
21
|
-
|
|
61
|
+
documentText(record),
|
|
22
62
|
'',
|
|
23
63
|
'Produce a JSON object of this exact shape:',
|
|
24
64
|
'{',
|
|
@@ -36,6 +76,36 @@ function buildUserPrompt(title, body) {
|
|
|
36
76
|
'Group related work into modules; keep titles short and imperative. Output JSON only.',
|
|
37
77
|
].join('\n');
|
|
38
78
|
}
|
|
79
|
+
/**
|
|
80
|
+
* The target-aware prompt.
|
|
81
|
+
*
|
|
82
|
+
* It names the modules the frame already holds so the plan ADDS to them: a model that cannot see
|
|
83
|
+
* the board proposes "Checkout" beside the "Checkout" that is already there, and the spawn
|
|
84
|
+
* happily creates the duplicate.
|
|
85
|
+
*/
|
|
86
|
+
function buildTargetedUserPrompt(record, target) {
|
|
87
|
+
return [
|
|
88
|
+
`Existing service: ${target.title} (type: ${target.type})`,
|
|
89
|
+
target.existingModules.length > 0
|
|
90
|
+
? `Modules it already has: ${target.existingModules.join(', ')}. Reuse these names for work that belongs in them rather than proposing a second module with the same meaning.`
|
|
91
|
+
: 'It has no modules yet.',
|
|
92
|
+
'',
|
|
93
|
+
`Document title: ${record.title}`,
|
|
94
|
+
...(isDesignSource(record.source) ? ['', DESIGN_GUIDANCE] : []),
|
|
95
|
+
'',
|
|
96
|
+
'Document content:',
|
|
97
|
+
documentText(record),
|
|
98
|
+
'',
|
|
99
|
+
'Produce a JSON object of this exact shape:',
|
|
100
|
+
'{',
|
|
101
|
+
' "modules": [ { "name": "string", "tasks": [ { "title": "string", "description": "string (optional)" } ] } ],',
|
|
102
|
+
' "tasks": [ { "title": "string", "description": "string (optional)" } ]',
|
|
103
|
+
'}',
|
|
104
|
+
'',
|
|
105
|
+
'Modules group related tasks; `tasks` holds work that belongs to no module. Keep titles',
|
|
106
|
+
'short and imperative. Output JSON only.',
|
|
107
|
+
].join('\n');
|
|
108
|
+
}
|
|
39
109
|
export class DocumentPlannerService {
|
|
40
110
|
deps;
|
|
41
111
|
constructor(deps) {
|
|
@@ -45,9 +115,17 @@ export class DocumentPlannerService {
|
|
|
45
115
|
get llmEnabled() {
|
|
46
116
|
return (!!this.deps.modelProviderResolver || !!this.deps.modelProvider) && !!this.deps.modelRef;
|
|
47
117
|
}
|
|
48
|
-
/**
|
|
49
|
-
|
|
50
|
-
|
|
118
|
+
/**
|
|
119
|
+
* Propose a board structure for an imported document, either at the board root or inside an
|
|
120
|
+
* existing service frame.
|
|
121
|
+
*
|
|
122
|
+
* The fallback is always the same SHAPE as the request: a targeted plan that could not be
|
|
123
|
+
* produced degrades to the targeted heading parser, never to a board-wide plan, because the
|
|
124
|
+
* caller is about to spawn into one frame and a whole architecture flattened into it is the
|
|
125
|
+
* discarding the target-aware path exists to prevent.
|
|
126
|
+
*/
|
|
127
|
+
async plan(record, target) {
|
|
128
|
+
const fallback = () => planFromHeadings(record.source, record.externalId, record.title, record.body, target);
|
|
51
129
|
if (!this.deps.modelRef || (!this.deps.modelProviderResolver && !this.deps.modelProvider)) {
|
|
52
130
|
return fallback();
|
|
53
131
|
}
|
|
@@ -58,8 +136,8 @@ export class DocumentPlannerService {
|
|
|
58
136
|
const model = provider.resolve(this.deps.modelRef);
|
|
59
137
|
const { text } = await generateText({
|
|
60
138
|
model,
|
|
61
|
-
system: SYSTEM_PROMPT,
|
|
62
|
-
prompt:
|
|
139
|
+
system: target ? TARGETED_SYSTEM_PROMPT : SYSTEM_PROMPT,
|
|
140
|
+
prompt: target ? buildTargetedUserPrompt(record, target) : buildUserPrompt(record),
|
|
63
141
|
temperature: 0.2,
|
|
64
142
|
// Headroom for a reasoning model's `<think>` before the JSON plan — a
|
|
65
143
|
// tight cap truncates the plan mid-output (finish_reason: length).
|
|
@@ -71,11 +149,16 @@ export class DocumentPlannerService {
|
|
|
71
149
|
workspaceId: record.workspaceId,
|
|
72
150
|
}),
|
|
73
151
|
});
|
|
74
|
-
const
|
|
152
|
+
const parsed = extractJson(text);
|
|
153
|
+
const plan = target
|
|
154
|
+
? coerceTargetedPlan(record.source, record.externalId, parsed, target)
|
|
155
|
+
: coercePlan(record.source, record.externalId, parsed);
|
|
75
156
|
return plan ?? fallback();
|
|
76
157
|
}
|
|
77
158
|
catch {
|
|
78
|
-
//
|
|
159
|
+
// silent-catch-ok: any provider/parse failure degrades to the deterministic plan, which is
|
|
160
|
+
// the whole reason the heading parser is kept; the plan is a PREVIEW the user approves, so
|
|
161
|
+
// a degraded one is visible to them before anything is written.
|
|
79
162
|
return fallback();
|
|
80
163
|
}
|
|
81
164
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DocumentPlannerService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentPlannerService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAIjC,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"DocumentPlannerService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentPlannerService.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { DocumentCredentials, DocumentSourceKind, DocumentSourceRegistry, Clock, Logger } from '@cat-factory/kernel';
|
|
2
|
+
import type { DocumentConnectionRecord } from '@cat-factory/kernel';
|
|
3
|
+
/** The deployment's registered OAuth app for one source. */
|
|
4
|
+
export interface DocumentOAuthClient {
|
|
5
|
+
clientId: string;
|
|
6
|
+
clientSecret: string;
|
|
7
|
+
/** The redirect the app is registered with; reused verbatim on the exchange. */
|
|
8
|
+
redirectUrl: string;
|
|
9
|
+
}
|
|
10
|
+
export interface DocumentSourceOAuthServiceDependencies {
|
|
11
|
+
registry: DocumentSourceRegistry;
|
|
12
|
+
/**
|
|
13
|
+
* The deployment's registered app for a source, resolved per workspace (the account key its
|
|
14
|
+
* workspace belongs to, so an org registers ONE app shared by its boards). `undefined` ⇒ this
|
|
15
|
+
* deployment cannot run the flow for that source, which is a different fact from the source
|
|
16
|
+
* having no OAuth half at all.
|
|
17
|
+
*/
|
|
18
|
+
resolveClient(workspaceId: string, source: DocumentSourceKind): Promise<DocumentOAuthClient | undefined>;
|
|
19
|
+
clock: Clock;
|
|
20
|
+
/** Injected for tests; production passes nothing and the global `fetch` is used. */
|
|
21
|
+
fetchImpl?: typeof fetch;
|
|
22
|
+
logger?: Logger;
|
|
23
|
+
}
|
|
24
|
+
export declare class DocumentSourceOAuthService {
|
|
25
|
+
private readonly deps;
|
|
26
|
+
private readonly log;
|
|
27
|
+
constructor(deps: DocumentSourceOAuthServiceDependencies);
|
|
28
|
+
private get http();
|
|
29
|
+
/**
|
|
30
|
+
* The sources this deployment can connect by OAuth for this workspace: an `oauth` declaration
|
|
31
|
+
* AND a registered client.
|
|
32
|
+
*
|
|
33
|
+
* BOTH halves, because the surface reading it renders a button. A source declaring the half
|
|
34
|
+
* with no client registered would offer a "Connect with Figma" that can only 503, which is the
|
|
35
|
+
* misattribution the separate wire field exists to prevent.
|
|
36
|
+
*/
|
|
37
|
+
availableSources(workspaceId: string): Promise<DocumentSourceKind[]>;
|
|
38
|
+
/**
|
|
39
|
+
* The vendor URL to send the operator's browser to, carrying the caller's signed `state`.
|
|
40
|
+
*
|
|
41
|
+
* Throws rather than answering a status: every failure here is a refusal an operator asked for
|
|
42
|
+
* by pressing a button (a source with no OAuth half, a deployment with no registered app), and
|
|
43
|
+
* a button press deserves a reason rather than a dead link.
|
|
44
|
+
*/
|
|
45
|
+
authorizeUrl(input: {
|
|
46
|
+
workspaceId: string;
|
|
47
|
+
source: DocumentSourceKind;
|
|
48
|
+
state: string;
|
|
49
|
+
}): Promise<string>;
|
|
50
|
+
/**
|
|
51
|
+
* Exchange a callback `code` for the credential bag the workspace's connection will hold.
|
|
52
|
+
*
|
|
53
|
+
* It RETURNS the bag rather than storing it, which is what keeps this service free of the
|
|
54
|
+
* connection store: persistence flows one way (the connection service renews through this one),
|
|
55
|
+
* and having the exchange write back would close that into a cycle broken only by a setter.
|
|
56
|
+
* The caller stores it through `DocumentConnectionService.connectWithOAuth`.
|
|
57
|
+
*/
|
|
58
|
+
exchangeCode(input: {
|
|
59
|
+
workspaceId: string;
|
|
60
|
+
source: DocumentSourceKind;
|
|
61
|
+
code: string;
|
|
62
|
+
}): Promise<DocumentCredentials>;
|
|
63
|
+
/**
|
|
64
|
+
* Renew a stored grant that is at or past its expiry skew, answering the NEW credential bag, or
|
|
65
|
+
* null when there was nothing to do or the renewal could not be made.
|
|
66
|
+
*
|
|
67
|
+
* Null rather than a throw on every failure path, because this sits on the credential-resolution
|
|
68
|
+
* path of every read: a grant that cannot be renewed right now must cost the reader a failed
|
|
69
|
+
* fetch it can report as a source outage, never the read itself. Three states are deliberately
|
|
70
|
+
* distinguished in what it logs, since each needs a different fix: a grant with no refresh
|
|
71
|
+
* token, a source whose spec declares no refresh endpoint (the grant was never renewable, so
|
|
72
|
+
* reconnecting is the only remedy), and a refresh that was attempted and failed.
|
|
73
|
+
*
|
|
74
|
+
* Unguarded against a lost race ON PURPOSE. The endpoints supported here return a new access
|
|
75
|
+
* token against an unchanged refresh token, so two concurrent renewals converge: the loser
|
|
76
|
+
* overwrites an equivalent value rather than replacing a live grant with a dead one, which is
|
|
77
|
+
* the failure a rotating authorization server would make a `compareAndSwap` mandatory for. A
|
|
78
|
+
* source whose refresh ROTATES cannot be added without revisiting this.
|
|
79
|
+
*/
|
|
80
|
+
renewIfExpiring(record: DocumentConnectionRecord): Promise<DocumentCredentials | null>;
|
|
81
|
+
/** The platform-owned credential bag for a token response. */
|
|
82
|
+
private bagFrom;
|
|
83
|
+
/** One token-endpoint call, authenticated as the confidential client. */
|
|
84
|
+
private post;
|
|
85
|
+
/** Resolve the source's OAuth declaration + this deployment's registered app, or refuse. */
|
|
86
|
+
private require;
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=DocumentSourceOAuthService.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DocumentSourceOAuthService.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/DocumentSourceOAuthService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAElB,sBAAsB,EACtB,KAAK,EACL,MAAM,EACP,MAAM,qBAAqB,CAAA;AAQ5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAiBnE,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAA;CACpB;AAqBD,MAAM,WAAW,sCAAsC;IACrD,QAAQ,EAAE,sBAAsB,CAAA;IAChC;;;;;OAKG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAC3C,KAAK,EAAE,KAAK,CAAA;IACZ,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,0BAA0B;IAGzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAE5B,YAA6B,IAAI,EAAE,sCAAsC,EAExE;IAED,OAAO,KAAK,IAAI,GAEf;IAED;;;;;;;OAOG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAQzE;IAED;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,kBAAkB,CAAA;QAC1B,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CASlB;IAED;;;;;;;OAOG;IACG,YAAY,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,kBAAkB,CAAA;QAC1B,IAAI,EAAE,MAAM,CAAA;KACb,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAQ/B;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,eAAe,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAoD3F;IAED,8DAA8D;IAC9D,OAAO,CAAC,OAAO;IA0Bf,yEAAyE;YAC3D,IAAI;IA2BlB,4FAA4F;YAC9E,OAAO;CAwBtB"}
|