societyai 0.0.1

package/dist/builder.d.ts

@@ -0,0 +1,181 @@
+import { AIModel, AgentConfig, AgentRole, WorkflowConfig, WorkflowStep, StepResult, WorkflowContext, WorkflowResult, SocietyObserver } from './types';
+export declare class FluentRoleBuilder {
+    private _id;
+    private _name;
+    private _description?;
+    private _systemPrompt;
+    private _capabilities;
+    private _constraints;
+    private _promptTemplate?;
+    withId(id: string): this;
+    withName(name: string): this;
+    withDescription(description: string): this;
+    withSystemPrompt(prompt: string): this;
+    withCapabilities(capabilities: string[]): this;
+    addCapability(capability: string): this;
+    withConstraints(constraints: string[]): this;
+    addConstraint(constraint: string): this;
+    withPromptTemplate(template: string): this;
+    build(): AgentRole;
+}
+export declare class FluentAgentBuilder {
+    private _id;
+    private _name?;
+    private _role?;
+    private _model?;
+    private _canCommunicateWith;
+    private _priority;
+    private _initialContext;
+    private _retryConfig?;
+    private _tags;
+    private _metadata;
+    withId(id: string): this;
+    withName(name: string): this;
+    withRole(builderFn: (builder: FluentRoleBuilder) => FluentRoleBuilder): this;
+    useRole(role: AgentRole): this;
+    withModel(model: AIModel): this;
+    canCommunicateWith(agentIds: string[]): this;
+    withPriority(priority: number): this;
+    withInitialContext(context: Record<string, unknown>): this;
+    addContext(key: string, value: unknown): this;
+    withRetry(config: {
+        maxRetries?: number;
+        initialBackoff?: number;
+    }): this;
+    withTags(tags: string[]): this;
+    addTag(tag: string): this;
+    withMetadata(metadata: Record<string, unknown>): this;
+    build(): AgentConfig & {
+        tags?: string[];
+        metadata?: Record<string, unknown>;
+    };
+}
+export declare class FluentStepBuilder {
+    private _id;
+    private _name;
+    private _description?;
+    private _agentIds;
+    private _executionType;
+    private _instructions?;
+    private _promptTemplate?;
+    private _maxIterations?;
+    private _completionCondition?;
+    private _resultTransformer?;
+    private _condition?;
+    private _nextSteps?;
+    private _nextStepResolver?;
+    private _timeout?;
+    withId(id: string): this;
+    withName(name: string): this;
+    withDescription(description: string): this;
+    withAgents(agentIds: string[]): this;
+    addAgent(agentId: string): this;
+    sequential(): this;
+    parallel(): this;
+    collaborative(maxIterations?: number): this;
+    conditional(condition: (previousResults: Map<string, StepResult[]>) => boolean): this;
+    withInstructions(instructions: string): this;
+    withPromptTemplate(template: string): this;
+    withMaxIterations(max: number): this;
+    withCompletionCondition(condition: (results: StepResult[], iteration: number) => boolean): this;
+    transformResults(transformer: (results: StepResult[] | StepResult) => unknown): this;
+    thenGoto(stepIds: string[]): this;
+    thenResolve(resolver: (results: StepResult[]) => string | null): this;
+    withTimeout(ms: number): this;
+    build(): WorkflowStep & {
+        timeout?: number;
+    };
+}
+export type PipelinePattern = 'scatter-gather' | 'chain' | 'router' | 'fallback' | 'race';
+export interface PipelineConfig {
+    pattern: PipelinePattern;
+    agentIds: string[];
+    aggregator?: (results: StepResult[]) => string;
+    router?: (input: string, context: WorkflowContext) => string;
+    timeout?: number;
+}
+export declare class FluentPipelineBuilder {
+    private _pattern;
+    private _agentIds;
+    private _aggregator?;
+    private _router?;
+    private _timeout?;
+    private _fallbackHandler?;
+    scatterGather(agentIds: string[]): this;
+    chain(agentIds: string[]): this;
+    router(agentIds: string[], routerFn: (input: string, context: WorkflowContext) => string): this;
+    fallback(agentIds: string[]): this;
+    race(agentIds: string[]): this;
+    aggregate(aggregator: (results: StepResult[]) => string): this;
+    withTimeout(ms: number): this;
+    onAllFailed(handler: (errors: Error[]) => string): this;
+    build(): PipelineConfig & {
+        fallbackHandler?: (errors: Error[]) => string;
+    };
+    toSteps(): WorkflowStep[];
+}
+export declare const AggregationStrategies: {
+    readonly concat: (separator?: string) => (results: StepResult[]) => string;
+    readonly first: () => (results: StepResult[]) => string;
+    readonly last: () => (results: StepResult[]) => string;
+    readonly best: (scorer: (result: StepResult) => number) => (results: StepResult[]) => string;
+    readonly reduce: <T>(reducer: (acc: T, result: StepResult) => T, initial: T, finalize: (acc: T) => string) => (results: StepResult[]) => string;
+    readonly structured: (format?: "json" | "markdown" | "list") => (results: StepResult[]) => string;
+};
+export declare class Society {
+    private _id;
+    private _name;
+    private _description?;
+    private _agents;
+    private _steps;
+    private _entryStepId?;
+    private _globalContext;
+    private _observer?;
+    private _onBeforeStep?;
+    private _onAfterStep?;
+    private _finalResultGenerator?;
+    private _timeout?;
+    static create(id?: string): Society;
+    withId(id: string): this;
+    withName(name: string): this;
+    withDescription(description: string): this;
+    addAgent(builderFn: (builder: FluentAgentBuilder) => FluentAgentBuilder): this;
+    useAgent(agent: AgentConfig): this;
+    useAgents(agents: AgentConfig[]): this;
+    addStep(builderFn: (builder: FluentStepBuilder) => FluentStepBuilder): this;
+    useStep(step: WorkflowStep): this;
+    useSteps(steps: WorkflowStep[]): this;
+    usePipeline(builderFn: (builder: FluentPipelineBuilder) => FluentPipelineBuilder): this;
+    startAt(stepId: string): this;
+    withGlobalContext(context: Record<string, unknown>): this;
+    addGlobalContext(key: string, value: unknown): this;
+    withObserver(observer: SocietyObserver): this;
+    beforeStep(handler: WorkflowConfig['onBeforeStep']): this;
+    afterStep(handler: WorkflowConfig['onAfterStep']): this;
+    withFinalResultGenerator(generator: WorkflowConfig['finalResultGenerator']): this;
+    withTimeout(ms: number): this;
+    scatterGather(aggregator?: (results: StepResult[]) => string): this;
+    chain(): this;
+    collaborate(maxIterations?: number): this;
+    build(): WorkflowConfig;
+    execute(input: string, signal?: AbortSignal): Promise<WorkflowResult>;
+}
+export declare const SocietyPatterns: {
+    readonly parallel: (agents: AgentConfig[]) => Society;
+    readonly chain: (agents: AgentConfig[]) => Society;
+    readonly collaborative: (agents: AgentConfig[], maxIterations?: number) => Society;
+    readonly review: (writer: AgentConfig, reviewer: AgentConfig) => Society;
+};
+export declare function createRole(id: string, systemPrompt: string, options?: {
+    name?: string;
+    description?: string;
+    capabilities?: string[];
+    constraints?: string[];
+    promptTemplate?: string;
+}): AgentRole;
+export declare function createAgent(id: string, role: AgentRole, model: AIModel, options?: {
+    name?: string;
+    priority?: number;
+    canCommunicateWith?: string[];
+}): AgentConfig;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}