Migrer vers le SDK Client 1.0

@scrydon/sdk 1.0 supprime l'ancienne surface publique de chat de workflow d'Agentic. Les exports et méthodes suivants n'existent plus :

• client.chat.stream(...)
• ChatStreamOptions
• le hook React useChatStream(...)

Les modèles de workflow sont supprimés

client.templates n'existe plus, ni TemplatesModule ni les types TemplateCreator, TemplateListOptions, TemplateListResult, TemplateSummary, UseTemplateOptions et UseTemplateResult. Ses méthodes list() et use() appelaient des routes de modèles que la plateforme ne sert plus, si bien que chaque appel échouait déjà. Supprimez ces appels : créez un workflow avec client.workflows.create(...) et distribuez un workflow réutilisable comme contenu d'extension.

Les liaisons d'intégration sont structurées

Le SDK 1.0 utilise un seul objet IntegrationBinding partout où un compte ou une ressource d'intégration est sélectionné. Remplacez les anciennes chaînes persistées par la valeur structurée correspondante :

// Connected integration
{ connectionRef: connectionId }

// Explicit account
{ credentialRef: accountId }

// Explicit account and resource
{ credentialRef: accountId, resource: { type: 'mailbox', id: mailboxId } }

// Resolve the account owned by the verified execution identity
{ credentialSubject: 'acting_principal' }

// Use the product/environment default
{}

Les valeurs historiques telles que accountId::resourceId et environment-connection:v1:... étaient des formats de préproduction et ne sont pas analysées par le SDK 1.0. Resélectionnez ces identifiants dans l'éditeur de workflow ; ne tentez pas de traduire des chaînes persistées opaques à l'exécution.

Appels LLM gouvernés

Utilisez client.chat.completions.create(...) pour des complétions LLM compatibles OpenAI. Votre application conserve et renvoie l'historique de conversation.

const stream = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Summarize Q3' }],
  stream: true,
})

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta.content ?? '')
}

Exécution de workflow

Utilisez client.workflows.trigger(...) pour obtenir un résultat immédiat ou client.workflows.triggerAsync(...) pour un workflow long. Ces API exécutent des workflows ; elles ne créent pas de session de chat publique.

const result = await client.workflows.trigger({
  workflowId: 'wf_abc',
  inputs: { message: 'Summarize Q3' },
})

Délégation agent-à-agent

Utilisez le point de terminaison A2A publié et un client A2A officiel lorsqu'un autre agent, tel que Cortex, délègue du travail à Scrydon. Les publications A2A et l'interface /api/chat propre à Cortex restent prises en charge et sont distinctes des anciennes routes publiques de chat d'Agentic.

L'ancienne interface de chat hébergée est remplacée par le déclencheur Chat : un workflow doté d'un déclencheur Chat obtient une page hébergée, un extrait iframe et un lanceur, ainsi que le client d'interface pour votre propre interface. Les conversations sont stockées par interface. Les routes /api/chat retirées et leur stockage de sessions ne reviennent pas.