Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
import { Effect, ParseResult, Schema } from 'effect';
import {
ConnectedAccountItems,
isKnownConnectedAccountStatus,
} from 'src/models/connected-accounts';
import {
ConnectedAccountListResponse,
type ConnectedAccountListResponse as ConnectedAccountListResponseType,
} from 'src/services/composio-clients';
import { TerminalUI } from 'src/services/terminal-ui';
/**
* Renders a `ParseError` as `path: kind` pairs only — never the failing
* values. A container-level failure would otherwise echo the raw payload,
* which can include credential-bearing fields (`state`, `data`, ...) the
* connected-account schemas deliberately exclude.
*/
const formatParseErrorRedacted = (error: ParseResult.ParseError): string =>
ParseResult.ArrayFormatter.formatErrorSync(error)
.map(issue => `${issue.path.join('.') || '(root)'}: ${issue._tag}`)
.join(', ');
/**
* Warns when the server returned `status` values newer than this CLI build's
* known set. Status values are non-credential by design, so printing them
* verbatim is safe — and exactly what the user needs to act on.
*/
const warnOnUnknownStatuses = (
items: ReadonlyArray<{ readonly status: string }>
): Effect.Effect<void, never, TerminalUI> =>
Effect.gen(function* () {
const unknown = [
...new Set(items.map(item => item.status).filter(s => !isKnownConnectedAccountStatus(s))),
];
if (unknown.length === 0) return;
const ui = yield* TerminalUI;
yield* ui.log.warn(
`Server returned connected account status(es) this CLI does not ` +
`recognize: ${unknown.join(', ')}. Run "composio upgrade" to pick up ` +
`the latest CLI.`
);
});
/**
* Decodes a raw `client.connectedAccounts.list(...)` response against
* `ConnectedAccountListResponse`, falling back to the raw payload on
* `ParseError`.
*
* `status` is an open enum (`ConnectedAccountStatus`), so a status newer than
* this CLI build decodes fine and only triggers the "composio upgrade"
* warning. The raw fallback remains for other shape skew (pagination fields,
* renames, ...) — safe because the three current call sites only render
* non-credential fields (`id`, `alias`, `word_id`, `toolkit.slug`,
* `status`, ...).
*/
export const decodeConnectedAccountListWithFallback = (
rawResult: unknown
): Effect.Effect<ConnectedAccountListResponseType, never, TerminalUI> =>
Effect.gen(function* () {
const ui = yield* TerminalUI;
return yield* Schema.decodeUnknown(ConnectedAccountListResponse)(rawResult).pipe(
Effect.tap(result => warnOnUnknownStatuses(result.items)),
Effect.catchTag('ParseError', error =>
Effect.gen(function* () {
yield* ui.log.warn(
`Server response did not match the shape this CLI expects. Run ` +
`"composio upgrade" to pick up the latest CLI. Continuing with ` +
`raw response.\n\n` +
`Mismatched fields: ${formatParseErrorRedacted(error)}`
);
// Safe: callers only read non-credential fields.
return rawResult as ConnectedAccountListResponseType;
})
)
);
});
/**
* Item-level variant of {@link decodeConnectedAccountListWithFallback} for
* call sites that decode `response.items` rather than the whole list
* response.
*
* `status` is an open enum, so a status newer than this CLI build decodes
* instead of failing — we just warn, pointing at `composio upgrade`. Unlike
* the list-response helper above, this one must NOT fall back to the raw
* payload: `link --list` JSON-dumps the decoded items to stdout, so the
* schema's field allowlist is what keeps credential-bearing fields (`state`,
* `data`, ...) out of pipeable output. Truly malformed data fails with
* `ParseError`.
*/
export const decodeConnectedAccountItems = (
rawItems: unknown
): Effect.Effect<ConnectedAccountItems, ParseResult.ParseError, TerminalUI> =>
Schema.decodeUnknown(ConnectedAccountItems)(rawItems).pipe(
Effect.tap(items => warnOnUnknownStatuses(items))
);