forgeos 0.1.0-alpha.2 → 0.1.0-alpha.4

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 (180) hide show
  1. package/AGENTS.md +38 -3
  2. package/CHANGELOG.md +29 -0
  3. package/README.md +25 -10
  4. package/package.json +8 -5
  5. package/src/forge/_generated/actionSubscriptions.json +2 -2
  6. package/src/forge/_generated/actionSubscriptions.ts +3 -3
  7. package/src/forge/_generated/agentAdapterManifest.json +2 -2
  8. package/src/forge/_generated/agentAdapterManifest.ts +3 -3
  9. package/src/forge/_generated/agentContract.json +2 -2
  10. package/src/forge/_generated/agentContract.ts +183 -50
  11. package/src/forge/_generated/agentQuickstart.md +3 -1
  12. package/src/forge/_generated/agentTools.json +2 -0
  13. package/src/forge/_generated/agentTools.md +16 -0
  14. package/src/forge/_generated/agentTools.ts +12 -0
  15. package/src/forge/_generated/aiContext.ts +67 -1
  16. package/src/forge/_generated/aiModels.json +2 -2
  17. package/src/forge/_generated/aiModels.ts +17 -1
  18. package/src/forge/_generated/aiProviders.json +1 -1
  19. package/src/forge/_generated/aiProviders.ts +1 -1
  20. package/src/forge/_generated/aiRegistry.json +2 -2
  21. package/src/forge/_generated/aiRegistry.ts +7 -5
  22. package/src/forge/_generated/api.json +2 -2
  23. package/src/forge/_generated/api.ts +1 -1
  24. package/src/forge/_generated/appGraph.json +2 -2
  25. package/src/forge/_generated/appGraph.ts +512 -260
  26. package/src/forge/_generated/appMap.md +21 -1
  27. package/src/forge/_generated/artifactManifest.json +2 -2
  28. package/src/forge/_generated/artifactManifest.ts +2 -2
  29. package/src/forge/_generated/authClaims.json +1 -1
  30. package/src/forge/_generated/authClaims.ts +1 -1
  31. package/src/forge/_generated/authConfig.json +1 -1
  32. package/src/forge/_generated/authConfig.ts +1 -1
  33. package/src/forge/_generated/authContext.ts +1 -1
  34. package/src/forge/_generated/authRegistry.json +1 -1
  35. package/src/forge/_generated/authRegistry.ts +1 -1
  36. package/src/forge/_generated/buildInfo.json +2 -2
  37. package/src/forge/_generated/buildInfo.ts +4 -4
  38. package/src/forge/_generated/capabilityMap.json +2 -2
  39. package/src/forge/_generated/capabilityMap.md +1 -1
  40. package/src/forge/_generated/capabilityMap.ts +2 -2
  41. package/src/forge/_generated/client.ts +1 -1
  42. package/src/forge/_generated/clientApi.ts +1 -1
  43. package/src/forge/_generated/clientManifest.json +2 -2
  44. package/src/forge/_generated/clientManifest.ts +3 -3
  45. package/src/forge/_generated/clientTypes.ts +1 -1
  46. package/src/forge/_generated/configRegistry.json +1 -1
  47. package/src/forge/_generated/configRegistry.ts +1 -1
  48. package/src/forge/_generated/dataGraph.json +2 -2
  49. package/src/forge/_generated/dataGraph.ts +3 -3
  50. package/src/forge/_generated/db.json +1 -1
  51. package/src/forge/_generated/db.ts +1 -1
  52. package/src/forge/_generated/dbSecurityManifest.json +1 -1
  53. package/src/forge/_generated/dbSecurityManifest.ts +1 -1
  54. package/src/forge/_generated/dbSessionContext.json +1 -1
  55. package/src/forge/_generated/dbSessionContext.ts +1 -1
  56. package/src/forge/_generated/deployManifest.json +2 -2
  57. package/src/forge/_generated/deployManifest.ts +7 -7
  58. package/src/forge/_generated/devManifest.json +2 -2
  59. package/src/forge/_generated/devManifest.ts +18 -3
  60. package/src/forge/_generated/envSchema.json +1 -1
  61. package/src/forge/_generated/envSchema.ts +1 -1
  62. package/src/forge/_generated/frontendGraph.json +1 -1
  63. package/src/forge/_generated/frontendGraph.ts +1 -1
  64. package/src/forge/_generated/importGuards.json +1 -1
  65. package/src/forge/_generated/importGuards.ts +1 -1
  66. package/src/forge/_generated/index.ts +2 -1
  67. package/src/forge/_generated/liveProductionManifest.json +1 -1
  68. package/src/forge/_generated/liveProductionManifest.ts +1 -1
  69. package/src/forge/_generated/liveProtocol.json +1 -1
  70. package/src/forge/_generated/liveProtocol.ts +1 -1
  71. package/src/forge/_generated/liveQueryRegistry.json +2 -2
  72. package/src/forge/_generated/liveQueryRegistry.ts +3 -3
  73. package/src/forge/_generated/liveTransportConfig.json +1 -1
  74. package/src/forge/_generated/liveTransportConfig.ts +1 -1
  75. package/src/forge/_generated/makeRegistry.json +2 -2
  76. package/src/forge/_generated/makeRegistry.ts +16 -2
  77. package/src/forge/_generated/makeTemplates.json +2 -2
  78. package/src/forge/_generated/makeTemplates.ts +6 -1
  79. package/src/forge/_generated/mockMap.json +1 -1
  80. package/src/forge/_generated/mockMap.ts +1 -1
  81. package/src/forge/_generated/operationPlaybooks.md +34 -14
  82. package/src/forge/_generated/packageGraph.json +2 -2
  83. package/src/forge/_generated/packageGraph.ts +8808 -4723
  84. package/src/forge/_generated/packageUpgradeRegistry.json +2 -2
  85. package/src/forge/_generated/packageUpgradeRegistry.ts +2 -2
  86. package/src/forge/_generated/permissionMatrix.json +2 -2
  87. package/src/forge/_generated/permissionMatrix.ts +3 -3
  88. package/src/forge/_generated/policyRegistry.json +2 -2
  89. package/src/forge/_generated/policyRegistry.ts +3 -3
  90. package/src/forge/_generated/queryRegistry.json +2 -2
  91. package/src/forge/_generated/queryRegistry.ts +3 -3
  92. package/src/forge/_generated/react.d.ts +1 -1
  93. package/src/forge/_generated/react.ts +1 -1
  94. package/src/forge/_generated/reactManifest.json +2 -2
  95. package/src/forge/_generated/reactManifest.ts +3 -3
  96. package/src/forge/_generated/releaseManifest.json +2 -2
  97. package/src/forge/_generated/releaseManifest.ts +3 -3
  98. package/src/forge/_generated/rlsPolicies.json +1 -1
  99. package/src/forge/_generated/rlsPolicies.sql +1 -1
  100. package/src/forge/_generated/rlsPolicies.ts +1 -1
  101. package/src/forge/_generated/runtimeGraph.json +2 -2
  102. package/src/forge/_generated/runtimeGraph.ts +3 -3
  103. package/src/forge/_generated/runtimeMatrix.json +2 -2
  104. package/src/forge/_generated/runtimeMatrix.ts +8684 -1939
  105. package/src/forge/_generated/runtimeRegistry.ts +1 -1
  106. package/src/forge/_generated/runtimeRules.md +13 -1
  107. package/src/forge/_generated/secretRegistry.json +1 -1
  108. package/src/forge/_generated/secretRegistry.ts +1 -1
  109. package/src/forge/_generated/secretsContext.ts +1 -1
  110. package/src/forge/_generated/serverApi.ts +1 -1
  111. package/src/forge/_generated/sourceMapManifest.json +2 -2
  112. package/src/forge/_generated/sourceMapManifest.ts +2 -2
  113. package/src/forge/_generated/sqlPlan.json +1 -1
  114. package/src/forge/_generated/sqlPlan.ts +1 -1
  115. package/src/forge/_generated/subscriptionManifest.json +2 -2
  116. package/src/forge/_generated/subscriptionManifest.ts +3 -3
  117. package/src/forge/_generated/symbolicationManifest.json +2 -2
  118. package/src/forge/_generated/symbolicationManifest.ts +2 -2
  119. package/src/forge/_generated/telemetryRegistry.json +2 -2
  120. package/src/forge/_generated/telemetryRegistry.ts +3 -3
  121. package/src/forge/_generated/telemetrySinks.json +2 -2
  122. package/src/forge/_generated/telemetrySinks.ts +2 -2
  123. package/src/forge/_generated/tenantScope.json +2 -2
  124. package/src/forge/_generated/tenantScope.ts +3 -3
  125. package/src/forge/_generated/testGraph.json +2 -2
  126. package/src/forge/_generated/testGraph.ts +339 -17
  127. package/src/forge/_generated/testPlanRegistry.json +2 -2
  128. package/src/forge/_generated/testPlanRegistry.ts +2 -2
  129. package/src/forge/_generated/uiRoutes.json +1 -1
  130. package/src/forge/_generated/uiRoutes.ts +1 -1
  131. package/src/forge/_generated/uiScenarios.json +1 -1
  132. package/src/forge/_generated/uiScenarios.ts +1 -1
  133. package/src/forge/_generated/uiTestManifest.json +2 -2
  134. package/src/forge/_generated/uiTestManifest.ts +2 -2
  135. package/src/forge/_generated/workflowRegistry.json +2 -2
  136. package/src/forge/_generated/workflowRegistry.ts +3 -3
  137. package/src/forge/_generated/workflowSubscriptions.json +2 -2
  138. package/src/forge/_generated/workflowSubscriptions.ts +3 -3
  139. package/src/forge/cli/ai.ts +351 -1
  140. package/src/forge/cli/auth.ts +36 -1
  141. package/src/forge/cli/commands.ts +19 -0
  142. package/src/forge/cli/parse.ts +67 -8
  143. package/src/forge/cli/rls.ts +529 -17
  144. package/src/forge/cli/secrets.ts +46 -1
  145. package/src/forge/cli/security.ts +269 -0
  146. package/src/forge/compiler/agent-contract/build.ts +289 -8
  147. package/src/forge/compiler/agent-contract/types.ts +43 -0
  148. package/src/forge/compiler/ai-registry/build.ts +62 -1
  149. package/src/forge/compiler/ai-registry/constants.ts +1 -1
  150. package/src/forge/compiler/ai-registry/parse.ts +98 -4
  151. package/src/forge/compiler/app-graph/forge-apis.ts +1 -0
  152. package/src/forge/compiler/dev-manifest/build.ts +3 -0
  153. package/src/forge/compiler/diagnostics/codes.ts +15 -0
  154. package/src/forge/compiler/diagnostics/create.ts +1 -1
  155. package/src/forge/compiler/make-registry/build.ts +13 -0
  156. package/src/forge/compiler/orchestrator/plan.ts +11 -0
  157. package/src/forge/compiler/orchestrator/serialize.ts +68 -0
  158. package/src/forge/compiler/package-graph/compiler.ts +13 -3
  159. package/src/forge/compiler/types/ai-registry.ts +25 -1
  160. package/src/forge/compiler/types/app-graph.ts +1 -0
  161. package/src/forge/compiler/types/cli.ts +1 -0
  162. package/src/forge/compiler/types/dev-manifest.ts +3 -0
  163. package/src/forge/dev/server.ts +508 -1
  164. package/src/forge/make/index.ts +126 -3
  165. package/src/forge/make/templates.ts +188 -0
  166. package/src/forge/make/types.ts +1 -0
  167. package/src/forge/runtime/ai/context.ts +210 -5
  168. package/src/forge/runtime/ai/types.ts +70 -0
  169. package/src/forge/runtime/auth/claims.ts +32 -0
  170. package/src/forge/runtime/auth/errors.ts +2 -0
  171. package/src/forge/runtime/context/create-context.ts +30 -6
  172. package/src/forge/runtime/db/memory-adapter.ts +2 -2
  173. package/src/forge/runtime/telemetry/scrubber.ts +56 -5
  174. package/src/forge/runtime/webhooks/security.ts +184 -0
  175. package/src/forge/server.ts +93 -0
  176. package/src/forge/version.ts +1 -1
  177. package/templates/b2b-support-web/package.json +1 -0
  178. package/templates/b2b-support-web/tsconfig.json +4 -1
  179. package/templates/minimal-web/package.json +1 -0
  180. package/templates/minimal-web/tsconfig.json +3 -1
@@ -1,13 +1,15 @@
1
- // @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=c0c78b2b0f790834952f56ecab5a9c5510129fc45ecf99b1478e7d8087836a12
1
+ // @forge-generated generator=0.1.0-alpha.4 input=4af795b70ec62dc5967f6e9b78865cfbc8afb09275e575845cf80a360b3b85e2 content=92caf10f1203b60d55c3a4a55b5bc834627e754dd0f2eb43ca92bec4908ae1e4
2
2
  export const agentContract = {
3
3
  "actions": [],
4
4
  "ai": {
5
+ "agents": [],
5
6
  "generations": [],
6
7
  "providers": [
7
8
  "anthropic",
8
9
  "gateway",
9
10
  "openai"
10
- ]
11
+ ],
12
+ "tools": []
11
13
  },
12
14
  "auth": {
13
15
  "bearerTokenHeader": "Authorization",
@@ -86,16 +88,19 @@ export const agentContract = {
86
88
  "entrypoints": [
87
89
  {
88
90
  "dtsPath": "node_modules/@ai-sdk/anthropic/dist/index.d.ts",
89
- "exportCount": 8,
91
+ "exportCount": 11,
90
92
  "exports": [
93
+ "AnthropicLanguageModelOptions",
91
94
  "AnthropicMessageMetadata",
92
95
  "AnthropicProvider",
93
96
  "AnthropicProviderOptions",
94
97
  "AnthropicProviderSettings",
98
+ "AnthropicToolOptions",
95
99
  "AnthropicUsageIteration",
96
100
  "VERSION",
97
101
  "anthropic",
98
- "createAnthropic"
102
+ "createAnthropic",
103
+ "forwardAnthropicContainerIdFromLastStep"
99
104
  ],
100
105
  "subpath": "."
101
106
  },
@@ -130,20 +135,31 @@ export const agentContract = {
130
135
  },
131
136
  "runtimeTypeMismatches": [],
132
137
  "source": "static",
133
- "version": "2.0.81"
138
+ "version": "3.0.84"
134
139
  },
135
140
  {
136
141
  "entrypoints": [
137
142
  {
138
143
  "dtsPath": "node_modules/@ai-sdk/openai/dist/index.d.ts",
139
- "exportCount": 9,
144
+ "exportCount": 20,
140
145
  "exports": [
141
146
  "OpenAIChatLanguageModelOptions",
147
+ "OpenAIEmbeddingModelOptions",
148
+ "OpenAIImageModelEditOptions",
142
149
  "OpenAIImageModelGenerationOptions",
143
150
  "OpenAIImageModelOptions",
151
+ "OpenAILanguageModelChatOptions",
152
+ "OpenAILanguageModelCompletionOptions",
153
+ "OpenAILanguageModelResponsesOptions",
144
154
  "OpenAIProvider",
145
155
  "OpenAIProviderSettings",
146
156
  "OpenAIResponsesProviderOptions",
157
+ "OpenAISpeechModelOptions",
158
+ "OpenAITranscriptionModelOptions",
159
+ "OpenaiResponsesProviderMetadata",
160
+ "OpenaiResponsesReasoningProviderMetadata",
161
+ "OpenaiResponsesSourceDocumentProviderMetadata",
162
+ "OpenaiResponsesTextProviderMetadata",
147
163
  "VERSION",
148
164
  "createOpenAI",
149
165
  "openai"
@@ -152,29 +168,44 @@ export const agentContract = {
152
168
  },
153
169
  {
154
170
  "dtsPath": "node_modules/@ai-sdk/openai/dist/internal/index.d.ts",
155
- "exportCount": 44,
171
+ "exportCount": 64,
156
172
  "exports": [
173
+ "ApplyPatchOperation",
157
174
  "OpenAIChatLanguageModel",
158
- "OpenAIChatLanguageModelOptions",
159
175
  "OpenAIChatModelId",
160
176
  "OpenAICompletionLanguageModel",
161
177
  "OpenAICompletionModelId",
162
- "OpenAICompletionProviderOptions",
163
178
  "OpenAIEmbeddingModel",
164
179
  "OpenAIEmbeddingModelId",
165
- "OpenAIEmbeddingProviderOptions",
180
+ "OpenAIEmbeddingModelOptions",
166
181
  "OpenAIImageModel",
182
+ "OpenAIImageModelEditOptions",
167
183
  "OpenAIImageModelGenerationOptions",
168
184
  "OpenAIImageModelId",
169
185
  "OpenAIImageModelOptions",
186
+ "OpenAILanguageModelChatOptions",
187
+ "OpenAILanguageModelCompletionOptions",
170
188
  "OpenAIResponsesLanguageModel",
171
- "OpenAISpeechCallOptions",
172
189
  "OpenAISpeechModel",
173
190
  "OpenAISpeechModelId",
191
+ "OpenAISpeechModelOptions",
174
192
  "OpenAITranscriptionCallOptions",
175
193
  "OpenAITranscriptionModel",
176
194
  "OpenAITranscriptionModelId",
177
- "OpenAITranscriptionProviderOptions",
195
+ "OpenAITranscriptionModelOptions",
196
+ "OpenaiResponsesProviderMetadata",
197
+ "OpenaiResponsesReasoningProviderMetadata",
198
+ "OpenaiResponsesSourceDocumentProviderMetadata",
199
+ "OpenaiResponsesTextProviderMetadata",
200
+ "ResponsesProviderMetadata",
201
+ "ResponsesReasoningProviderMetadata",
202
+ "ResponsesSourceDocumentProviderMetadata",
203
+ "ResponsesTextProviderMetadata",
204
+ "applyPatch",
205
+ "applyPatchArgsSchema",
206
+ "applyPatchInputSchema",
207
+ "applyPatchOutputSchema",
208
+ "applyPatchToolFactory",
178
209
  "codeInterpreter",
179
210
  "codeInterpreterArgsSchema",
180
211
  "codeInterpreterInputSchema",
@@ -188,16 +219,21 @@ export const agentContract = {
188
219
  "imageGenerationArgsSchema",
189
220
  "imageGenerationOutputSchema",
190
221
  "modelMaxImagesPerCall",
191
- "openAITranscriptionProviderOptions",
192
- "openaiChatLanguageModelOptions",
193
- "openaiCompletionProviderOptions",
194
- "openaiEmbeddingProviderOptions",
222
+ "openAITranscriptionModelOptions",
223
+ "openaiEmbeddingModelOptions",
224
+ "openaiImageModelEditOptions",
195
225
  "openaiImageModelGenerationOptions",
196
226
  "openaiImageModelOptions",
197
- "openaiSpeechProviderOptionsSchema",
227
+ "openaiLanguageModelChatOptions",
228
+ "openaiLanguageModelCompletionOptions",
229
+ "openaiSpeechModelOptionsSchema",
230
+ "webSearch",
231
+ "webSearchArgsSchema",
232
+ "webSearchOutputSchema",
198
233
  "webSearchPreview",
199
234
  "webSearchPreviewArgsSchema",
200
- "webSearchPreviewInputSchema"
235
+ "webSearchPreviewInputSchema",
236
+ "webSearchToolFactory"
201
237
  ],
202
238
  "subpath": "./internal"
203
239
  },
@@ -221,7 +257,7 @@ export const agentContract = {
221
257
  },
222
258
  "runtimeTypeMismatches": [],
223
259
  "source": "static",
224
- "version": "2.0.106"
260
+ "version": "3.0.71"
225
261
  },
226
262
  {
227
263
  "entrypoints": [
@@ -858,16 +894,21 @@ export const agentContract = {
858
894
  "entrypoints": [
859
895
  {
860
896
  "dtsPath": "node_modules/ai/dist/index.d.ts",
861
- "exportCount": 254,
897
+ "exportCount": 313,
862
898
  "exports": [
863
899
  "AISDKError",
864
900
  "APICallError",
865
901
  "AbstractChat",
902
+ "Agent",
903
+ "AgentCallParameters",
904
+ "AgentStreamParameters",
866
905
  "AssistantContent",
867
906
  "AssistantModelMessage",
868
907
  "AsyncIterableStream",
869
908
  "CallSettings",
870
909
  "CallWarning",
910
+ "ChatAddToolApproveResponseFunction",
911
+ "ChatAddToolOutputFunction",
871
912
  "ChatInit",
872
913
  "ChatOnDataCallback",
873
914
  "ChatOnErrorCallback",
@@ -880,16 +921,14 @@ export const agentContract = {
880
921
  "ChunkDetector",
881
922
  "CompletionRequestOptions",
882
923
  "ContentPart",
883
- "CoreAssistantMessage",
884
- "CoreMessage",
885
- "CoreSystemMessage",
886
- "CoreToolMessage",
887
- "CoreUserMessage",
888
924
  "CreateUIMessage",
889
925
  "DataContent",
890
926
  "DataUIPart",
891
927
  "DeepPartial",
892
928
  "DefaultChatTransport",
929
+ "DefaultGeneratedFile",
930
+ "DirectChatTransport",
931
+ "DirectChatTransportOptions",
893
932
  "DownloadError",
894
933
  "DynamicToolCall",
895
934
  "DynamicToolError",
@@ -899,6 +938,7 @@ export const agentContract = {
899
938
  "EmbedResult",
900
939
  "Embedding",
901
940
  "EmbeddingModel",
941
+ "EmbeddingModelMiddleware",
902
942
  "EmbeddingModelUsage",
903
943
  "EmptyResponseBodyError",
904
944
  "ErrorHandler",
@@ -911,24 +951,37 @@ export const agentContract = {
911
951
  "Experimental_LogWarningsFunction",
912
952
  "Experimental_SpeechResult",
913
953
  "Experimental_TranscriptionResult",
914
- "Experimental_Warning",
915
954
  "FilePart",
916
955
  "FileUIPart",
917
956
  "FinishReason",
957
+ "FlexibleSchema",
918
958
  "GatewayModelId",
959
+ "GenerateImageResult",
919
960
  "GenerateObjectResult",
961
+ "GenerateTextOnFinishCallback",
962
+ "GenerateTextOnStartCallback",
920
963
  "GenerateTextOnStepFinishCallback",
964
+ "GenerateTextOnStepStartCallback",
965
+ "GenerateTextOnToolCallFinishCallback",
966
+ "GenerateTextOnToolCallStartCallback",
921
967
  "GenerateTextResult",
968
+ "GenerateVideoPrompt",
969
+ "GenerateVideoResult",
922
970
  "GeneratedAudioFile",
923
971
  "GeneratedFile",
924
972
  "HttpChatTransport",
925
973
  "HttpChatTransportInitOptions",
926
974
  "IdGenerator",
927
975
  "ImageModel",
928
- "ImageModelCallWarning",
976
+ "ImageModelMiddleware",
929
977
  "ImageModelProviderMetadata",
930
978
  "ImageModelResponseMetadata",
979
+ "ImageModelUsage",
931
980
  "ImagePart",
981
+ "InferAgentUIMessage",
982
+ "InferGenerateOutput",
983
+ "InferSchema",
984
+ "InferStreamOutput",
932
985
  "InferToolInput",
933
986
  "InferToolOutput",
934
987
  "InferUIDataParts",
@@ -941,6 +994,8 @@ export const agentContract = {
941
994
  "InvalidPromptError",
942
995
  "InvalidResponseDataError",
943
996
  "InvalidStreamPartError",
997
+ "InvalidToolApprovalError",
998
+ "InvalidToolApprovalSignatureError",
944
999
  "InvalidToolInputError",
945
1000
  "JSONParseError",
946
1001
  "JSONSchema7",
@@ -953,18 +1008,27 @@ export const agentContract = {
953
1008
  "LanguageModelUsage",
954
1009
  "LoadAPIKeyError",
955
1010
  "LoadSettingError",
1011
+ "LogWarningsFunction",
956
1012
  "MessageConversionError",
1013
+ "MissingToolResultsError",
957
1014
  "ModelMessage",
958
1015
  "NoContentGeneratedError",
959
1016
  "NoImageGeneratedError",
960
1017
  "NoObjectGeneratedError",
961
1018
  "NoOutputGeneratedError",
962
- "NoOutputSpecifiedError",
963
1019
  "NoSpeechGeneratedError",
964
1020
  "NoSuchModelError",
965
1021
  "NoSuchProviderError",
966
1022
  "NoSuchToolError",
1023
+ "NoTranscriptGeneratedError",
1024
+ "NoVideoGeneratedError",
967
1025
  "ObjectStreamPart",
1026
+ "OnFinishEvent",
1027
+ "OnStartEvent",
1028
+ "OnStepFinishEvent",
1029
+ "OnStepStartEvent",
1030
+ "OnToolCallFinishEvent",
1031
+ "OnToolCallStartEvent",
968
1032
  "Output",
969
1033
  "PrepareReconnectToStreamRequest",
970
1034
  "PrepareSendMessagesRequest",
@@ -977,6 +1041,8 @@ export const agentContract = {
977
1041
  "ReasoningOutput",
978
1042
  "ReasoningUIPart",
979
1043
  "RepairTextFunction",
1044
+ "RerankResult",
1045
+ "RerankingModel",
980
1046
  "RetryError",
981
1047
  "SafeValidateUIMessagesResult",
982
1048
  "Schema",
@@ -985,9 +1051,9 @@ export const agentContract = {
985
1051
  "SourceUrlUIPart",
986
1052
  "SpeechModel",
987
1053
  "SpeechModelResponseMetadata",
988
- "SpeechWarning",
989
1054
  "StaticToolCall",
990
1055
  "StaticToolError",
1056
+ "StaticToolOutputDenied",
991
1057
  "StaticToolResult",
992
1058
  "StepResult",
993
1059
  "StepStartUIPart",
@@ -997,17 +1063,27 @@ export const agentContract = {
997
1063
  "StreamTextOnChunkCallback",
998
1064
  "StreamTextOnErrorCallback",
999
1065
  "StreamTextOnFinishCallback",
1066
+ "StreamTextOnStartCallback",
1000
1067
  "StreamTextOnStepFinishCallback",
1068
+ "StreamTextOnStepStartCallback",
1069
+ "StreamTextOnToolCallFinishCallback",
1070
+ "StreamTextOnToolCallStartCallback",
1001
1071
  "StreamTextResult",
1002
1072
  "StreamTextTransform",
1003
1073
  "SystemModelMessage",
1074
+ "TelemetryIntegration",
1004
1075
  "TelemetrySettings",
1005
1076
  "TextPart",
1006
1077
  "TextStreamChatTransport",
1007
1078
  "TextStreamPart",
1008
1079
  "TextUIPart",
1080
+ "TimeoutConfiguration",
1009
1081
  "TooManyEmbeddingValuesForCallError",
1010
1082
  "Tool",
1083
+ "ToolApprovalRequest",
1084
+ "ToolApprovalRequestOutput",
1085
+ "ToolApprovalResponse",
1086
+ "ToolCallNotFoundForApprovalError",
1011
1087
  "ToolCallOptions",
1012
1088
  "ToolCallPart",
1013
1089
  "ToolCallRepairError",
@@ -1015,23 +1091,30 @@ export const agentContract = {
1015
1091
  "ToolChoice",
1016
1092
  "ToolContent",
1017
1093
  "ToolExecuteFunction",
1094
+ "ToolExecutionOptions",
1095
+ "ToolLoopAgent",
1096
+ "ToolLoopAgentOnFinishCallback",
1097
+ "ToolLoopAgentOnStepFinishCallback",
1098
+ "ToolLoopAgentSettings",
1018
1099
  "ToolModelMessage",
1019
1100
  "ToolResultPart",
1020
1101
  "ToolSet",
1021
1102
  "ToolUIPart",
1022
1103
  "TranscriptionModel",
1023
1104
  "TranscriptionModelResponseMetadata",
1024
- "TranscriptionWarning",
1025
1105
  "TypeValidationError",
1026
1106
  "TypedToolCall",
1027
1107
  "TypedToolError",
1108
+ "TypedToolOutputDenied",
1028
1109
  "TypedToolResult",
1029
1110
  "UIDataPartSchemas",
1030
1111
  "UIDataTypes",
1031
1112
  "UIMessage",
1032
1113
  "UIMessageChunk",
1033
1114
  "UIMessagePart",
1115
+ "UIMessageStreamError",
1034
1116
  "UIMessageStreamOnFinishCallback",
1117
+ "UIMessageStreamOnStepFinishCallback",
1035
1118
  "UIMessageStreamOptions",
1036
1119
  "UIMessageStreamWriter",
1037
1120
  "UITool",
@@ -1043,19 +1126,18 @@ export const agentContract = {
1043
1126
  "UseCompletionOptions",
1044
1127
  "UserContent",
1045
1128
  "UserModelMessage",
1129
+ "Warning",
1130
+ "addToolInputExamplesMiddleware",
1046
1131
  "asSchema",
1047
1132
  "assistantModelMessageSchema",
1133
+ "bindTelemetryIntegration",
1048
1134
  "callCompletionApi",
1049
1135
  "consumeStream",
1050
1136
  "convertFileListToFileUIParts",
1051
- "convertToCoreMessages",
1052
1137
  "convertToModelMessages",
1053
- "coreAssistantMessageSchema",
1054
- "coreMessageSchema",
1055
- "coreSystemMessageSchema",
1056
- "coreToolMessageSchema",
1057
- "coreUserMessageSchema",
1058
1138
  "cosineSimilarity",
1139
+ "createAgentUIStream",
1140
+ "createAgentUIStreamResponse",
1059
1141
  "createDownload",
1060
1142
  "createGateway",
1061
1143
  "createIdGenerator",
@@ -1064,6 +1146,7 @@ export const agentContract = {
1064
1146
  "createUIMessageStream",
1065
1147
  "createUIMessageStreamResponse",
1066
1148
  "customProvider",
1149
+ "defaultEmbeddingSettingsMiddleware",
1067
1150
  "defaultSettingsMiddleware",
1068
1151
  "dynamicTool",
1069
1152
  "embed",
@@ -1072,12 +1155,16 @@ export const agentContract = {
1072
1155
  "experimental_customProvider",
1073
1156
  "experimental_generateImage",
1074
1157
  "experimental_generateSpeech",
1158
+ "experimental_generateVideo",
1075
1159
  "experimental_transcribe",
1160
+ "extractJsonMiddleware",
1076
1161
  "extractReasoningMiddleware",
1077
1162
  "gateway",
1078
1163
  "generateId",
1164
+ "generateImage",
1079
1165
  "generateObject",
1080
1166
  "generateText",
1167
+ "getStaticToolName",
1081
1168
  "getTextFromDataUrl",
1082
1169
  "getToolName",
1083
1170
  "getToolOrDynamicToolName",
@@ -1085,19 +1172,25 @@ export const agentContract = {
1085
1172
  "isDataUIPart",
1086
1173
  "isDeepEqualData",
1087
1174
  "isFileUIPart",
1175
+ "isLoopFinished",
1088
1176
  "isReasoningUIPart",
1177
+ "isStaticToolUIPart",
1089
1178
  "isTextUIPart",
1090
1179
  "isToolOrDynamicToolUIPart",
1091
1180
  "isToolUIPart",
1092
1181
  "jsonSchema",
1182
+ "lastAssistantMessageIsCompleteWithApprovalResponses",
1093
1183
  "lastAssistantMessageIsCompleteWithToolCalls",
1094
1184
  "modelMessageSchema",
1095
1185
  "parseJsonEventStream",
1096
1186
  "parsePartialJson",
1187
+ "pipeAgentUIStreamToResponse",
1097
1188
  "pipeTextStreamToResponse",
1098
1189
  "pipeUIMessageStreamToResponse",
1099
1190
  "pruneMessages",
1100
1191
  "readUIMessageStream",
1192
+ "registerTelemetryIntegration",
1193
+ "rerank",
1101
1194
  "safeValidateUIMessages",
1102
1195
  "simulateReadableStream",
1103
1196
  "simulateStreamingMiddleware",
@@ -1111,6 +1204,8 @@ export const agentContract = {
1111
1204
  "uiMessageChunkSchema",
1112
1205
  "userModelMessageSchema",
1113
1206
  "validateUIMessages",
1207
+ "wrapEmbeddingModel",
1208
+ "wrapImageModel",
1114
1209
  "wrapLanguageModel",
1115
1210
  "wrapProvider",
1116
1211
  "zodSchema"
@@ -1119,8 +1214,9 @@ export const agentContract = {
1119
1214
  },
1120
1215
  {
1121
1216
  "dtsPath": "node_modules/ai/dist/internal/index.d.ts",
1122
- "exportCount": 6,
1217
+ "exportCount": 7,
1123
1218
  "exports": [
1219
+ "asLanguageModelUsage",
1124
1220
  "convertAsyncIteratorToReadableStream",
1125
1221
  "convertToLanguageModelPrompt",
1126
1222
  "prepareCallSettings",
@@ -1138,14 +1234,15 @@ export const agentContract = {
1138
1234
  },
1139
1235
  {
1140
1236
  "dtsPath": "node_modules/ai/dist/test/index.d.ts",
1141
- "exportCount": 12,
1237
+ "exportCount": 13,
1142
1238
  "exports": [
1143
- "MockEmbeddingModelV2",
1144
- "MockImageModelV2",
1145
- "MockLanguageModelV2",
1146
- "MockProviderV2",
1147
- "MockSpeechModelV2",
1148
- "MockTranscriptionModelV2",
1239
+ "MockEmbeddingModelV3",
1240
+ "MockImageModelV3",
1241
+ "MockLanguageModelV3",
1242
+ "MockProviderV3",
1243
+ "MockRerankingModelV3",
1244
+ "MockSpeechModelV3",
1245
+ "MockTranscriptionModelV3",
1149
1246
  "convertArrayToAsyncIterable",
1150
1247
  "convertArrayToReadableStream",
1151
1248
  "convertReadableStreamToArray",
@@ -1169,7 +1266,7 @@ export const agentContract = {
1169
1266
  },
1170
1267
  "runtimeTypeMismatches": [],
1171
1268
  "source": "static",
1172
- "version": "5.0.197"
1269
+ "version": "6.0.205"
1173
1270
  },
1174
1271
  {
1175
1272
  "entrypoints": [
@@ -6879,7 +6976,7 @@ export const agentContract = {
6879
6976
  }
6880
6977
  }
6881
6978
  },
6882
- "generatorVersion": "0.1.0-alpha.2",
6979
+ "generatorVersion": "0.1.0-alpha.4",
6883
6980
  "integrations": [
6884
6981
  {
6885
6982
  "alias": "ai-gateway",
@@ -6999,7 +7096,7 @@ export const agentContract = {
6999
7096
  "edge"
7000
7097
  ],
7001
7098
  "name": "@ai-sdk/anthropic",
7002
- "version": "2.0.81"
7099
+ "version": "3.0.84"
7003
7100
  },
7004
7101
  {
7005
7102
  "allowedContexts": [
@@ -7019,7 +7116,7 @@ export const agentContract = {
7019
7116
  "edge"
7020
7117
  ],
7021
7118
  "name": "@ai-sdk/openai",
7022
- "version": "2.0.106"
7119
+ "version": "3.0.71"
7023
7120
  },
7024
7121
  {
7025
7122
  "allowedContexts": [
@@ -7179,7 +7276,7 @@ export const agentContract = {
7179
7276
  "edge"
7180
7277
  ],
7181
7278
  "name": "ai",
7182
- "version": "5.0.197"
7279
+ "version": "6.0.205"
7183
7280
  },
7184
7281
  {
7185
7282
  "allowedContexts": [
@@ -7430,6 +7527,28 @@ export const agentContract = {
7430
7527
  ],
7431
7528
  "title": "Debug a stale liveQuery"
7432
7529
  },
7530
+ {
7531
+ "steps": [
7532
+ "Add a server-only file under src/ai or src/tools.",
7533
+ "Export aiTool({ description, inputSchema, outputSchema, risk, needsApproval, handler }).",
7534
+ "Use zod schemas for inputSchema and outputSchema.",
7535
+ "Access secrets through the tool context, not process.env.",
7536
+ "Mark destructive or external side effects with risk and needsApproval.",
7537
+ "Run forge generate and inspect src/forge/_generated/aiRegistry.json."
7538
+ ],
7539
+ "title": "Add an AI tool"
7540
+ },
7541
+ {
7542
+ "steps": [
7543
+ "Export agent({ provider, model, instructions, tools, stopWhen }) from server-only source.",
7544
+ "Prefer AI SDK ToolLoopAgent semantics through ctx.agent.run or ctx.ai.runAgent instead of custom loops.",
7545
+ "Use stopWhen with stepCount or terminal tool calls to prevent unbounded loops.",
7546
+ "Run agents only in actions, workflows, endpoints, or server code.",
7547
+ "Run forge inspect all --json and confirm agentContract.ai.agents lists the agent.",
7548
+ "Use forge ai trace <traceId> --json to inspect agent runs and tool calls."
7549
+ ],
7550
+ "title": "Add an agent"
7551
+ },
7433
7552
  {
7434
7553
  "steps": [
7435
7554
  "Edit src/forge/schema.ts.",
@@ -7464,7 +7583,8 @@ export const agentContract = {
7464
7583
  {
7465
7584
  "steps": [
7466
7585
  "Run forge refactor rename field <table.field> <table.field> --dry-run --json.",
7467
- "Rename codemods are AST-aware for extract-action, rename field, and rename table.",
7586
+ "Run forge refactor rename command <oldName> <newName> --dry-run --json when renaming runtime entrypoints.",
7587
+ "Rename codemods are AST-aware for extract-action, rename command, rename field, and rename table.",
7468
7588
  "Field renames are scoped to the target table, so tickets.priority only rewrites references linked to tickets.",
7469
7589
  "Review filesToModify, migrationPlan, diagnostics, and risk.",
7470
7590
  "Use --allow-high-risk only for intentional high-risk refactors.",
@@ -7537,6 +7657,7 @@ export const agentContract = {
7537
7657
  {
7538
7658
  "steps": [
7539
7659
  "Run forge make ui --framework vite --dry-run --json when the app does not have a web root.",
7660
+ "Run forge make ai-chat support --dry-run --json to add a chat surface backed by /ai/agents/chat streaming and /ai/agents/run JSON automation.",
7540
7661
  "Use web/lib/forge.ts as the generated client bridge.",
7541
7662
  "Mount ForgeProvider once in the web app provider/layout layer; use devAuth for local development.",
7542
7663
  "Use useQuery, useCommand, and useLiveQuery instead of raw /commands or /queries fetches.",
@@ -7582,6 +7703,8 @@ export const agentContract = {
7582
7703
  "network packages",
7583
7704
  "ctx.secrets",
7584
7705
  "ctx.ai",
7706
+ "ctx.ai.runAgent",
7707
+ "ctx.agent.run",
7585
7708
  "process.env",
7586
7709
  "filesystem access"
7587
7710
  ]
@@ -7597,6 +7720,8 @@ export const agentContract = {
7597
7720
  "ctx.emit",
7598
7721
  "ctx.secrets",
7599
7722
  "ctx.ai",
7723
+ "ctx.ai.runAgent",
7724
+ "ctx.agent.run",
7600
7725
  "network integrations"
7601
7726
  ]
7602
7727
  },
@@ -7611,6 +7736,8 @@ export const agentContract = {
7611
7736
  "ctx.emit",
7612
7737
  "ctx.secrets",
7613
7738
  "ctx.ai",
7739
+ "ctx.ai.runAgent",
7740
+ "ctx.agent.run",
7614
7741
  "network integrations"
7615
7742
  ]
7616
7743
  },
@@ -7619,6 +7746,9 @@ export const agentContract = {
7619
7746
  "ctx.secrets",
7620
7747
  "integrations",
7621
7748
  "ctx.ai",
7749
+ "ctx.ai.runAgent",
7750
+ "ctx.agent.run",
7751
+ "AI SDK tools",
7622
7752
  "ctx.db reads/writes",
7623
7753
  "network packages"
7624
7754
  ],
@@ -7633,6 +7763,9 @@ export const agentContract = {
7633
7763
  "ctx.secrets",
7634
7764
  "integrations",
7635
7765
  "ctx.ai",
7766
+ "ctx.ai.runAgent",
7767
+ "ctx.agent.run",
7768
+ "AI SDK ToolLoopAgent",
7636
7769
  "retries"
7637
7770
  ],
7638
7771
  "context": "workflow",
@@ -1,4 +1,4 @@
1
- // @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=fa1107464c1de08135410251aeff7e759a69b11801f8704e9d324b4036fbfa7b
1
+ // @forge-generated generator=0.1.0-alpha.4 input=4af795b70ec62dc5967f6e9b78865cfbc8afb09275e575845cf80a360b3b85e2 content=b7a94d564a961fdda392055d6f091aa61e7e6d9da2fb04f4f508803d75b3f1f3
2
2
  # Agent Quickstart
3
3
 
4
4
  Run:
@@ -12,7 +12,9 @@ forge dev
12
12
  forge inspect all --json
13
13
  forge inspect frontend --json
14
14
  forge inspect capabilities --json
15
+ forge inspect agent-tools --json
15
16
  forge check --json
17
+ forge ai trace <traceId> --json
16
18
  ```
17
19
 
18
20
  Never edit:
@@ -0,0 +1,2 @@
1
+ // @forge-generated generator=0.1.0-alpha.4 input=4af795b70ec62dc5967f6e9b78865cfbc8afb09275e575845cf80a360b3b85e2 content=2ab7880448c8c607a0b788f402e25b955559606aa88a631b7eec8c01c34b33d2
2
+ {"agents":[],"autoTools":[],"explicitTools":[],"generatorVersion":"0.1.0-alpha.4","project":{"name":"forgeos","type":"forgeos-app"},"schemaVersion":"0.1.0"}
@@ -0,0 +1,16 @@
1
+ // @forge-generated generator=0.1.0-alpha.4 input=4af795b70ec62dc5967f6e9b78865cfbc8afb09275e575845cf80a360b3b85e2 content=0e1a5df20243e64c3535e1601214f8306f67a4b56ddd47b71be1a1c5a09cb3a0
2
+ # Agent Tools
3
+
4
+ Project: forgeos
5
+
6
+ ## Explicit AI Tools
7
+
8
+ - none
9
+
10
+ ## Auto Tools From Forge Runtime
11
+
12
+ - none
13
+
14
+ ## Agents
15
+
16
+ - none
@@ -0,0 +1,12 @@
1
+ // @forge-generated generator=0.1.0-alpha.4 input=4af795b70ec62dc5967f6e9b78865cfbc8afb09275e575845cf80a360b3b85e2 content=a4194e129c4506733303937ef8e493763ff5b205c1d0b90583576e40e6e947e9
2
+ export const agentTools = {
3
+ "agents": [],
4
+ "autoTools": [],
5
+ "explicitTools": [],
6
+ "generatorVersion": "0.1.0-alpha.4",
7
+ "project": {
8
+ "name": "forgeos",
9
+ "type": "forgeos-app"
10
+ },
11
+ "schemaVersion": "0.1.0"
12
+ } as const;