smalltalk/src/index.ts at main · compoundingtech/smalltalk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
// @compoundingtech/smalltalk — programmatic API.
//
// Embedders import from this entry point:
//   import { createSt, asIdentity } from '@compoundingtech/smalltalk';
//
// The CLI entry point (`bin/st` → `src/cli.ts`) is invoked separately;
// it is not re-exported here.

export const VERSION = '0.9.0';

// ─── Factory + handle ──────────────────────────────────────────────────

export {
  createSt,
  type ArchiveOptions,
  type St,
  type StOptions,
  type FanOutBidiItem,
  type FanOutItem,
  type LsOptions,
  type OrphanItem,
  type ReadOptions,
  type SendOptions,
  type SyncResult,
  type ThreadOptions,
  type TrimOptions,
  type WatchOptions,
} from './lib.ts';

// ─── Public types + branded primitives ─────────────────────────────────

// brief-009 item 3 (rename): asAgent / isAgent / Agent are the
// preferred names; asIdentity / isIdentity / Identity remain as
// @deprecated aliases pointing at the same brand for one release
// cycle. Both spellings work; the deprecation is JSDoc-only.
export {
  asAgent,
  asDeliverableFilename,
  asFilename,
  asIdentity,
  deriveTo,
  deriveTs,
  isAgent,
  isFilename,
  isIdentity,
  isState,
  parsePeer,
  PRIORITIES,
  STATES,
  type Agent,
  type Filename,
  type Identity,
  type Message,
  type MessageWithLocation,
  type ParsedPeer,
  type Peer,
  type PeerKind,
  type Priority,
  type Resource,
  type ResourceWithLocation,
  type State,
  type WatchEvent,
} from './types.ts';

// ─── Errors ────────────────────────────────────────────────────────────

// Identity*Error classes are @deprecated aliases of the new Agent*Error
// classes — same constructor, same instances; safe to swap.
export {
  AgentNotHostedError,
  AgentRequiredError,
  ArchiveConflictError,
  StError,
  EmptyBodyError,
  IdentityNotHostedError,
  IdentityRequiredError,
  InvalidAgentError,
  InvalidDurationError,
  InvalidFilenameError,
  InvalidIdentityError,
  InvalidPriorityError,
  InvalidResourceUrlError,
  InvalidStateError,
  MessageNotFoundError,
  PeersConfigInvalidError,
  PeersConfigMissingError,
  ResourceNotFoundError,
  type SyncStage,
  SyncFailedError,
} from './errors.ts';

// ─── common.ts conveniences ────────────────────────────────────────────

export {
  emitFrontmatter,
  parseFrontmatter,
  RESERVED_NAMES,
  validDeliverableFilename,
  validFilename,
  validIdentity,
  validOutsideFilename,
  yamlQuote,
} from './common.ts';

// ─── Agents + overview shapes (brief-028, renamed in brief-009 item 3) ─

export {
  type AgentSummary,
  type AgentSummaryEnriched,
  type MemberSummary,
  type MemberSummaryEnriched,
} from './commands/agents.ts';

export {
  type ActivityKind,
  type Overview,
  type OverviewActivity,
  type OverviewInbox,
  type OverviewInboxOldest,
} from './commands/overview.ts';

// ─── Read-only bus reader (for tools that import instead of shelling `st`) ─

export {
  createBusReader,
  type BusReader,
  type BusReaderOptions,
  type BusReaderAgentsOptions,
} from './bus-reader.ts';