Skip to content

Commit fc0ea13

Browse files
committed
docs
1 parent e9e1608 commit fc0ea13

8 files changed

Lines changed: 113 additions & 5 deletions

File tree

docs/classes/ClientCompute.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,16 @@ constructor(params: IComputeParams<Compute>);
2121
params: IComputeParams<Compute>
2222
```
2323

24-
### __@DISPOSE_SLOT_FN_SYMBOL@3078
24+
### __@DISPOSE_SLOT_FN_SYMBOL@3100
2525

2626
```ts
27-
__@DISPOSE_SLOT_FN_SYMBOL@3078: any
27+
__@DISPOSE_SLOT_FN_SYMBOL@3100: any
2828
```
2929

30-
### __@GET_COMPUTE_DATA_FN_SYMBOL@3079
30+
### __@GET_COMPUTE_DATA_FN_SYMBOL@3101
3131

3232
```ts
33-
__@GET_COMPUTE_DATA_FN_SYMBOL@3079: any
33+
__@GET_COMPUTE_DATA_FN_SYMBOL@3101: any
3434
```
3535

3636
## Methods

docs/classes/ClientSwarm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ Returns the current busy state of the swarm.
101101
Used to check if the swarm is currently processing an operation (e.g., waiting for output or switching agents).
102102
Supports debugging and flow control in client applications.
103103

104-
### __@SET_BUSY_FN@1539
104+
### __@SET_BUSY_FN@1558
105105

106106
```ts
107107
[SET_BUSY_FN](isBusy: boolean): void;

docs/classes/DocService.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,15 @@ agentValidationService: any
5454
Agent validation service instance, injected via DI.
5555
Provides the list of agent names for dumpDocs, ensuring only valid agents are documented.
5656

57+
### outlineValidationService
58+
59+
```ts
60+
outlineValidationService: any
61+
```
62+
63+
Outline validation service instance, injected via DI.
64+
Used for validating and managing agent outline schemas, ensuring agent outlines conform to expected structure and constraints.
65+
5766
### swarmSchemaService
5867

5968
```ts
@@ -72,6 +81,15 @@ agentSchemaService: any
7281
Agent schema service instance, injected via DI.
7382
Retrieves IAgentSchemaInternal objects for writeAgentDoc and agent descriptions in writeSwarmDoc, providing details like tools and prompts.
7483

84+
### outlineSchemaService
85+
86+
```ts
87+
outlineSchemaService: any
88+
```
89+
90+
Outline schema service instance, injected via DI.
91+
Retrieves and manages outline schema objects for agents, supporting documentation and validation of agent outlines.
92+
7593
### mcpSchemaService
7694

7795
```ts
@@ -172,6 +190,21 @@ Writes Markdown documentation for a swarm schema, detailing its name, descriptio
172190
Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
173191
Outputs to dirName/[swarmName].md, with UML images in dirName/image, and links to agent docs in dirName/agent, sourced from swarmSchemaService.
174192

193+
### writeOutlineDoc
194+
195+
```ts
196+
writeOutlineDoc: any
197+
```
198+
199+
Writes Markdown documentation for an outline schema, detailing its name, description, main prompt, output format, and callbacks.
200+
Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
201+
Outputs to dirName/[outlineName].md, sourced from outlineSchemaService.
202+
203+
- The Markdown includes YAML frontmatter, outline name, description, prompt(s), output format (with types, descriptions, enums, and required fields), and callbacks.
204+
- Handles both string and function-based prompts, and supports array or string prompt types.
205+
- Output format section documents each property, its type, description, enum values, and required status.
206+
- Callback section lists all callback names used by the outline.
207+
175208
### writeAgentDoc
176209

177210
```ts

docs/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -298,6 +298,7 @@ group: docs
298298
- [IOperatorParams](interfaces/IOperatorParams.md)
299299
- [IPipelineSchema](interfaces/IPipelineSchema.md)
300300
- [IPipelineCallbacks](interfaces/IPipelineCallbacks.md)
301+
- [IOutlineFormat](interfaces/IOutlineFormat.md)
301302
- [IOutlineCallbacks](interfaces/IOutlineCallbacks.md)
302303
- [IOutlineMessage](interfaces/IOutlineMessage.md)
303304
- [IOutlineHistory](interfaces/IOutlineHistory.md)

docs/interfaces/IAgentTool.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,15 @@ toolName: string
2626

2727
The unique name of the tool, used for identification within the agent swarm.
2828

29+
### isAvailable
30+
31+
```ts
32+
isAvailable: (clientId: string, agentName: string, toolName: string) => boolean | Promise<boolean>
33+
```
34+
35+
Checks if the tool is available for execution.
36+
This method can be used to determine if the tool can be executed based on the current context.
37+
2938
### validate
3039

3140
```ts

docs/interfaces/IOutlineArgs.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,14 @@ attempt: number
2828
The current attempt number for the outline operation.
2929
Tracks the number of retries or iterations, useful for validation or retry logic.
3030

31+
### format
32+
33+
```ts
34+
format: IOutlineFormat
35+
```
36+
37+
Format of output taken from outline schema
38+
3139
### history
3240

3341
```ts

docs/interfaces/IOutlineFormat.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: docs/api-reference/interface/IOutlineFormat
3+
group: docs
4+
---
5+
6+
# IOutlineFormat
7+
8+
Interface representing the format/schema definition for outline data.
9+
Specifies the structure, required fields, and property metadata for outline operations.
10+
Used to enforce and document the expected shape of outline data.
11+
12+
## Properties
13+
14+
### type
15+
16+
```ts
17+
type: string
18+
```
19+
20+
The root type of the outline format (e.g., "object").
21+
22+
### required
23+
24+
```ts
25+
required: string[]
26+
```
27+
28+
Array of property names that are required in the outline data.
29+
30+
### properties
31+
32+
```ts
33+
properties: { [key: string]: { type: string; description: string; enum?: string[]; }; }
34+
```
35+
36+
An object mapping property names to their type, description, and optional enum values.
37+
Each property describes a field in the outline data.

docs/interfaces/IOutlineSchema.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,17 @@ Defines the structure and behavior of an outline, including data generation and
1010

1111
## Properties
1212

13+
### prompt
14+
15+
```ts
16+
prompt: string | string[] | ((outlineName: string) => string | string[] | Promise<string | string[]>)
17+
```
18+
19+
The prompt or prompt generator for the outline operation.
20+
Can be a string, an array of strings, or a function that returns a string, array of strings, or a promise resolving to either.
21+
If a function is provided, it receives the outline name and can return a prompt dynamically.
22+
Used as the initial instruction or context for the outline process.
23+
1324
### docDescription
1425

1526
```ts
@@ -37,6 +48,15 @@ validations: (IOutlineValidation<Data, Param> | IOutlineValidationFn<Data, Param
3748
Array of validation functions or configurations to apply to the outline data.
3849
Supports both direct validation functions and structured validation configurations.
3950

51+
### format
52+
53+
```ts
54+
format: IOutlineFormat
55+
```
56+
57+
The format/schema definition for the outline data.
58+
Specifies the expected structure, required fields, and property metadata for validation and documentation.
59+
4060
### maxAttempts
4161

4262
```ts

0 commit comments

Comments
 (0)