societyai 0.0.1

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.
Files changed (114) hide show
  1. package/CHANGELOG.md +111 -0
  2. package/LICENSE +21 -0
  3. package/README.md +879 -0
  4. package/dist/builder.d.ts +181 -0
  5. package/dist/builder.d.ts.map +1 -0
  6. package/dist/builder.js +667 -0
  7. package/dist/builder.js.map +1 -0
  8. package/dist/config.d.ts +43 -0
  9. package/dist/config.d.ts.map +1 -0
  10. package/dist/config.js +11 -0
  11. package/dist/config.js.map +1 -0
  12. package/dist/context.d.ts +107 -0
  13. package/dist/context.d.ts.map +1 -0
  14. package/dist/context.js +319 -0
  15. package/dist/context.js.map +1 -0
  16. package/dist/errors.d.ts +31 -0
  17. package/dist/errors.d.ts.map +1 -0
  18. package/dist/errors.js +85 -0
  19. package/dist/errors.js.map +1 -0
  20. package/dist/events.d.ts +219 -0
  21. package/dist/events.d.ts.map +1 -0
  22. package/dist/events.js +395 -0
  23. package/dist/events.js.map +1 -0
  24. package/dist/graph.d.ts +104 -0
  25. package/dist/graph.d.ts.map +1 -0
  26. package/dist/graph.js +366 -0
  27. package/dist/graph.js.map +1 -0
  28. package/dist/index.d.ts +28 -0
  29. package/dist/index.d.ts.map +1 -0
  30. package/dist/index.js +113 -0
  31. package/dist/index.js.map +1 -0
  32. package/dist/logger.d.ts +13 -0
  33. package/dist/logger.d.ts.map +1 -0
  34. package/dist/logger.js +78 -0
  35. package/dist/logger.js.map +1 -0
  36. package/dist/memory.d.ts +146 -0
  37. package/dist/memory.d.ts.map +1 -0
  38. package/dist/memory.js +353 -0
  39. package/dist/memory.js.map +1 -0
  40. package/dist/metrics.d.ts +143 -0
  41. package/dist/metrics.d.ts.map +1 -0
  42. package/dist/metrics.js +271 -0
  43. package/dist/metrics.js.map +1 -0
  44. package/dist/middleware.d.ts +147 -0
  45. package/dist/middleware.d.ts.map +1 -0
  46. package/dist/middleware.js +484 -0
  47. package/dist/middleware.js.map +1 -0
  48. package/dist/models.d.ts +32 -0
  49. package/dist/models.d.ts.map +1 -0
  50. package/dist/models.js +211 -0
  51. package/dist/models.js.map +1 -0
  52. package/dist/patterns.d.ts +6 -0
  53. package/dist/patterns.d.ts.map +1 -0
  54. package/dist/patterns.js +68 -0
  55. package/dist/patterns.js.map +1 -0
  56. package/dist/pipeline.d.ts +84 -0
  57. package/dist/pipeline.d.ts.map +1 -0
  58. package/dist/pipeline.js +569 -0
  59. package/dist/pipeline.js.map +1 -0
  60. package/dist/retry.d.ts +5 -0
  61. package/dist/retry.d.ts.map +1 -0
  62. package/dist/retry.js +70 -0
  63. package/dist/retry.js.map +1 -0
  64. package/dist/society.d.ts +94 -0
  65. package/dist/society.d.ts.map +1 -0
  66. package/dist/society.js +721 -0
  67. package/dist/society.js.map +1 -0
  68. package/dist/strategies.d.ts +55 -0
  69. package/dist/strategies.d.ts.map +1 -0
  70. package/dist/strategies.js +678 -0
  71. package/dist/strategies.js.map +1 -0
  72. package/dist/tools.d.ts +88 -0
  73. package/dist/tools.d.ts.map +1 -0
  74. package/dist/tools.js +366 -0
  75. package/dist/tools.js.map +1 -0
  76. package/dist/types.d.ts +213 -0
  77. package/dist/types.d.ts.map +1 -0
  78. package/dist/types.js +19 -0
  79. package/dist/types.js.map +1 -0
  80. package/dist/validation.d.ts +64 -0
  81. package/dist/validation.d.ts.map +1 -0
  82. package/dist/validation.js +334 -0
  83. package/dist/validation.js.map +1 -0
  84. package/dist/worker-pool.d.ts +17 -0
  85. package/dist/worker-pool.d.ts.map +1 -0
  86. package/dist/worker-pool.js +80 -0
  87. package/dist/worker-pool.js.map +1 -0
  88. package/docs/README.md +468 -0
  89. package/docs/advanced.md +616 -0
  90. package/docs/aggregation-strategies.md +926 -0
  91. package/docs/api-reference.md +771 -0
  92. package/docs/architecture.md +648 -0
  93. package/docs/context-system.md +642 -0
  94. package/docs/event-system.md +1047 -0
  95. package/docs/examples.md +576 -0
  96. package/docs/getting-started.md +564 -0
  97. package/docs/graph-execution.md +389 -0
  98. package/docs/memory-system.md +497 -0
  99. package/docs/metrics-observability.md +560 -0
  100. package/docs/middleware-system.md +1038 -0
  101. package/docs/migration.md +296 -0
  102. package/docs/pipeline-patterns.md +761 -0
  103. package/docs/structured-output.md +612 -0
  104. package/docs/tool-calling.md +491 -0
  105. package/docs/workflows.md +740 -0
  106. package/examples/README.md +234 -0
  107. package/examples/advanced-patterns.ts +115 -0
  108. package/examples/complete-integration.ts +327 -0
  109. package/examples/graph-workflow.ts +161 -0
  110. package/examples/memory-system.ts +155 -0
  111. package/examples/metrics-tracking.ts +243 -0
  112. package/examples/structured-output.ts +231 -0
  113. package/examples/tool-calling.ts +163 -0
  114. package/package.json +94 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":";;AAOA,kDAQC;AASD,8BA0DC;AAOD,sBAiBC;AAzGD,qCAAqC;AACrC,qCAAmD;AAKnD,SAAgB,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,CAAC;QACb,cAAc,EAAE,GAAG;QACnB,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,GAAG;QAClB,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AASM,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAA+B,EAC/B,MAAoB;IAEpB,MAAM,IAAI,GAAG,EAAE,GAAG,mBAAmB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;IAE3B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC;IAClC,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,OAAO,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAErC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YAEH,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,SAAS,UAAU,IAAI,IAAI,CAAC,UAAU,kBAAkB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5F,CAAC;YAED,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAG3B,IAAI,IAAA,qBAAY,EAAC,SAAS,CAAC,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC;YAClB,CAAC;YAGD,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,UAAU,uBAAuB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChG,MAAM,IAAA,kBAAS,EAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;YACrE,CAAC;YAGD,IAAI,WAAW,GAAG,OAAO,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAEhB,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;gBAC/C,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC;YACnD,CAAC;YAGD,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAGjC,UAAU,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAGD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAChE,CAAC;AAOD,SAAgB,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,GAAS,EAAE;gBAC9B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC3C,CAAC,CAAC;YACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,94 @@
1
+ import { AIModel, AgentConfig, AgentRole, AgentMessage, CommunicationChannel, WorkflowConfig, WorkflowStep, WorkflowContext, WorkflowResult, WorkflowExecutor, StepResult, WorkflowStepExecutionType, SocietyObserver } from './types';
2
+ export declare class MessageBus implements CommunicationChannel {
3
+ private handlers;
4
+ private history;
5
+ send(message: AgentMessage): Promise<void>;
6
+ subscribe(agentId: string, handler: (message: AgentMessage) => void): void;
7
+ unsubscribe(agentId: string): void;
8
+ getHistory(filter?: {
9
+ from?: string;
10
+ to?: string;
11
+ type?: string;
12
+ }): AgentMessage[];
13
+ clearHistory(): void;
14
+ }
15
+ export declare class RoleBuilder {
16
+ private role;
17
+ constructor(idOrName?: string);
18
+ static create(): RoleBuilder;
19
+ withId(id: string): this;
20
+ withName(name: string): this;
21
+ withDescription(description: string): this;
22
+ withSystemPrompt(prompt: string): this;
23
+ withCapabilities(capabilities: string[]): this;
24
+ withConstraints(constraints: string[]): this;
25
+ withPromptTemplate(template: string): this;
26
+ build(): AgentRole;
27
+ }
28
+ export declare class AgentBuilder {
29
+ private config;
30
+ constructor(id?: string);
31
+ static create(): AgentBuilder;
32
+ withId(id: string): this;
33
+ withName(name: string): this;
34
+ withRole(role: AgentRole): this;
35
+ withModel(model: AIModel): this;
36
+ canCommunicateWith(agentIds: string[]): this;
37
+ withPriority(priority: number): this;
38
+ withInitialContext(context: Record<string, unknown>): this;
39
+ build(): AgentConfig;
40
+ }
41
+ export declare class StepBuilder {
42
+ private step;
43
+ constructor(id?: string);
44
+ static create(): StepBuilder;
45
+ withId(id: string): this;
46
+ withName(name: string): this;
47
+ withDescription(description: string): this;
48
+ withAgents(agentIds: string[]): this;
49
+ withExecutionType(type: WorkflowStepExecutionType): this;
50
+ withInstructions(instructions: string): this;
51
+ withPromptTemplate(template: string): this;
52
+ withMaxIterations(max: number): this;
53
+ withCompletionCondition(condition: WorkflowStep['completionCondition']): this;
54
+ withResultTransformer(transformer: WorkflowStep['resultTransformer']): this;
55
+ withCondition(condition: WorkflowStep['condition']): this;
56
+ withNextSteps(stepIds: string[]): this;
57
+ withNextStepResolver(resolver: WorkflowStep['nextStepResolver']): this;
58
+ build(): WorkflowStep;
59
+ }
60
+ export declare class WorkflowConfigBuilder {
61
+ private config;
62
+ constructor(id?: string);
63
+ static create(): WorkflowConfigBuilder;
64
+ withId(id: string): this;
65
+ withName(name: string): this;
66
+ withDescription(description: string): this;
67
+ addAgent(agent: AgentConfig): this;
68
+ addAgents(agents: AgentConfig[]): this;
69
+ addStep(step: WorkflowStep): this;
70
+ addSteps(steps: WorkflowStep[]): this;
71
+ withEntryStep(stepId: string): this;
72
+ withGlobalContext(context: Record<string, unknown>): this;
73
+ onBeforeStep(handler: WorkflowConfig['onBeforeStep']): this;
74
+ onAfterStep(handler: WorkflowConfig['onAfterStep']): this;
75
+ withFinalResultGenerator(generator: WorkflowConfig['finalResultGenerator']): this;
76
+ build(): WorkflowConfig;
77
+ }
78
+ export declare class DefaultWorkflowExecutor implements WorkflowExecutor {
79
+ private logger;
80
+ private messageBus;
81
+ private observer?;
82
+ constructor(observer?: SocietyObserver);
83
+ private buildAgentPrompt;
84
+ private formatSharedData;
85
+ private formatMessageHistory;
86
+ private formatPreviousResults;
87
+ private executeSequential;
88
+ private executeParallel;
89
+ private executeCollaborative;
90
+ executeStep(step: WorkflowStep, agents: Map<string, AgentConfig>, context: WorkflowContext, signal?: AbortSignal): Promise<StepResult[]>;
91
+ execute(workflow: WorkflowConfig, input: string, signal?: AbortSignal): Promise<WorkflowResult>;
92
+ private generateDefaultOutput;
93
+ }
94
+ //# sourceMappingURL=society.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"society.d.ts","sourceRoot":"","sources":["../src/society.ts"],"names":[],"mappings":"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"}