@studio-foundation/contracts 0.3.0-beta.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 (22) hide show
  1. package/.claude/settings.json +5 -0
  2. package/ARCHITECTURE.md +33 -0
  3. package/LICENSE +663 -0
  4. package/README.md +106 -0
  5. package/package.json +33 -0
  6. package/src/agent.ts +33 -0
  7. package/src/context-pack.ts +15 -0
  8. package/src/errors.ts +23 -0
  9. package/src/index.ts +18 -0
  10. package/src/integration-plugin.ts +34 -0
  11. package/src/pipeline.ts +97 -0
  12. package/src/provider.ts +39 -0
  13. package/src/run.ts +49 -0
  14. package/src/runner-events.ts +69 -0
  15. package/src/spawner.ts +19 -0
  16. package/src/stage.ts +13 -0
  17. package/src/task.ts +3 -0
  18. package/src/tool-plugin.ts +47 -0
  19. package/src/validation.ts +42 -0
  20. package/tests/types.test.ts +101 -0
  21. package/tsconfig.json +24 -0
  22. package/tsconfig.test.json +8 -0
package/.claude/settings.json ADDED
@@ -0,0 +1,5 @@
1
+ {
2
+ "enabledPlugins": {
3
+ "linear@claude-plugins-official": true
4
+ }
5
+ }
package/ARCHITECTURE.md ADDED
@@ -0,0 +1,33 @@
1
+ # @studio-foundation/contracts
2
+
3
+ Types et interfaces partagés par tous les packages Studio. ZERO dépendances. ZERO logique.
4
+
5
+ ## Règles
6
+
7
+ - Ce package n'a AUCUNE dépendance (pas de `@studio/*`, pas de libs externes)
8
+ - JAMAIS de logique — uniquement des types, interfaces, enums TypeScript
9
+ - Exception unique : `isStageGroup()` dans `pipeline.ts` (type guard pur, sans état)
10
+ - Tout changement ici impacte TOUS les autres packages — être conservateur
11
+ - Exporter tout depuis `index.ts`
12
+
13
+ ## Fichiers clés
14
+
15
+ - `pipeline.ts` — `PipelineDefinition`, `StageDefinition`, `StageGroup`, `StageHooks`, `ToolHookDef`, `StageHookDef`, `StartupCommand`, `isStageGroup()`
16
+ - `stage.ts` — `StageStatus`, `StageKind` (= string), `StageResult`
17
+ - `task.ts` — `TaskStatus`
18
+ - `agent.ts` — `AgentConfig`, `AgentProfile`, `ToolCall`
19
+ - `run.ts` — `PipelineRun`, `StageRun`, `TaskRun`, `AgentRun`, `AgentStatus`
20
+ - `validation.ts` — `OutputContract`, `ToolCallRequirements`, `ValidationResult`, `ValidationRule`
21
+ - `provider.ts` — `LLMRequest`, `LLMResponse`, `Message`, `ToolDefinition`
22
+ - `errors.ts` — `ErrorCode` (enum), `StudioError`
23
+ - `context-pack.ts` — `ContextPackDefinition`, `ResolvedContextPack`
24
+ - `tool-plugin.ts` — `ToolPluginDef`, `ToolCommandDef`, `ShellExecute`, `BuiltinExecute`, `ParameterDef`
25
+ - `runner-events.ts` — `RunnerCallbacks`, événements de streaming tool calls et tokens
26
+ - `spawner.ts` — `RunSpawner`, `SpawnConfig`, `SpawnResult`
27
+ - `integration-plugin.ts` — `IntegrationPluginDef`
28
+
29
+ ## Test
30
+
31
+ ```bash
32
+ pnpm test
33
+ ```